# Tracking Wallets

## Adding a Tracker

1. Type `/add` or tap the **Trackers** button from the main menu, then tap **Add**
2. Send the wallet address (or `.sol` domain), one per line
3. Optionally include a nametag after the address:

   ```
   7xKXtg2CW87d9pR4 Team Wallet
   9yMNzp3EQ124kL8 Whale
   ```
4. The bot validates each address and confirms the addition

<figure><img src="https://solmatebot.com/docs/placeholder-telegram-add-tracker.png" alt=""><figcaption><p>Adding a wallet tracker on Telegram</p></figcaption></figure>

{% hint style="info" %}
**Free users:** Wallets must have a minimum balance of 0.001 SOL and must be your own wallet. Premium users can track any wallet, even empty ones.
{% endhint %}

## Transaction Notifications

Once a tracker is active, you'll receive instant notifications for:

| Event              | Description                                               |
| ------------------ | --------------------------------------------------------- |
| **Swaps**          | Buy/sell transactions with token details and market cap   |
| **Transfers**      | SOL and token transfers between wallets                   |
| **Token creation** | When the wallet creates a new token                       |
| **Burns**          | Token burn transactions                                   |
| **Limit orders**   | Jupiter limit order creation, execution, and cancellation |
| **Fee claims**     | Pump.fun fee claims                                       |

### Notification format

Each notification includes:

* Direction indicator (green for buy, red for sell, blue for multi-token swap)
* Wallet name/address
* Exchange used (Jupiter, Raydium, etc.)
* Token amounts and prices
* Market cap information
* Quick-action buttons (customizable in Settings)

<figure><img src="https://solmatebot.com/docs/placeholder-telegram-swap-notification.png" alt=""><figcaption><p>A swap notification on Telegram</p></figcaption></figure>

## Managing Trackers

### View all trackers

Tap **Trackers** from the main menu to see all tracked wallets with pagination (10 per page). Each entry shows:

* Active/inactive status
* Wallet address with nametag
* Tracked event types

<figure><img src="https://solmatebot.com/docs/placeholder-telegram-tracker-list.png" alt=""><figcaption><p>Tracker list with pagination</p></figcaption></figure>

### Remove a tracker

Type `/remove` or tap **Remove** in the Trackers menu, then follow the prompts to select which wallet to stop tracking.

### Pause & resume

* `/stop` — pauses **all** active trackers
* `/resume` — resumes **all** paused trackers

### Export trackers

`/export` — downloads a `.txt` file with all your tracked wallet addresses and nametags.

### Reset everything

`/reset` — removes all trackers and nametags. You'll need to type `yes` to confirm.

## Nametags

Give your tracked wallets human-readable names:

1. Tap **Nametags** from the main menu
2. Tap **Add** and follow the prompts
3. Enter the wallet address and desired name

Nametags appear in all notifications instead of the raw address.

<figure><img src="https://solmatebot.com/docs/placeholder-telegram-nametags.png" alt=""><figcaption><p>Managing nametags on Telegram</p></figcaption></figure>

## Token Lookup

Use `/token <name or address>` to look up any token. Shows:

* Token name, price, and contract address
* Market cap, decimals, and supply
* Security info (top holder concentration, liquidity, mint/freeze authority)

<figure><img src="https://solmatebot.com/docs/placeholder-telegram-token.png" alt=""><figcaption><p>/token command showing security analysis</p></figcaption></figure>

## Tracker Limits

| Plan    | Wallet Trackers |
| ------- | --------------- |
| Free    | 2               |
| Premium | 50              |