# 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              |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.solmatebot.com/telegram-bot/tracking-wallets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.