> For the complete documentation index, see [llms.txt](https://docs.raybot.app/start/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.raybot.app/start/interface-and-buttons-in-telegram/tokens.md).

# Tokens

{% hint style="warning" %}
💡 Currently, only Solana token monitoring is supported.
{% endhint %}

## 📌 Tokens — what it does

**The Tokens feature lets you track tokens and receive instant alerts if:**

* 🐋 A buy or sell occurs for more than the set threshold (in USD).
* 💹 The token price changes by the specified percentage.
* 💰 The DexScreener Payment Tracker is active — checks if the token’s listing on DexScreener has been paid for.

***

## 🚀 How to subscribe to a token

1. Open the main menu with `/start`
2. Go to the **🪙 Tokens** section.
3. Click ✨**Add Token**.
4. Enter the token address.
5. Set the parameters:

* **Price change %** — the price change percentage that will trigger a notification
* **Size** — the minimum trade amount (in USD) for an alert
* **Dex Paid** — notifies you when a token purchases ad on **DexScreener**.

<details>

<summary>ℹ️ How Price Change % Works</summary>

The price change threshold uses a **cascading (rolling) alert system** - it's not a 24-hour change and it's not permanently tied to the price at the time you added the token.

**🔄 How it works:**

1. When you add a token - the current price becomes the **reference point**.
2. Once the price moves by the set % from that point - an **alert fires**, and the trigger price automatically becomes the **new reference point**.
3. The cycle repeats.

**📊 Example (10% threshold, token added at $10):**

| Alert | Trigger Price             | New Reference Point |
| ----- | ------------------------- | ------------------- |
| 1st   | $11.00 (+10% from $10)    | $11.00              |
| 2nd   | $12.10 (+10% from $11)    | $12.10              |
| 3rd   | $13.31 (+10% from $12.10) | $13.31              |

**✅ In short:**

* ❌ Not a 24h change (like on CoinGecko)
* ❌ Not permanently tied to the token's price at time of adding
* ✅ Each alert resets the reference point → you get notified every time the price moves another X% from the last alert

{% hint style="info" %}
💡 Perfect for tracking consecutive price movements - both up and down.
{% endhint %}

</details>

> 🎥 ***Video example** — watch how to add and configure a token in under 1 minute*

{% @guideflow/guideflow-embed requestedUrl="<https://app.guideflow.com/player/3r3d12mhnp>" %}

***

### 📊 After adding a token

Within a couple of minutes, it will start being tracked, and the Tokens menu will show a statistics block with monitoring information:

```
Total tokens: 1 / 5
└This bot: 1 | Other bots: 0
└Groups & Discord & Dedicated: 0

✅ - Token is active
⏸️ - You paused this token
⏳ - Token was sending too many txs and is paused
🛑 - Renew premium to continue tracking this token

✅ /mint_0 <Token Ticker> <Token Address>

Tip: Click on mint_... to change token settings

Page 1/1
```

#### **What this means:**

* **Total tokens** — total number of added tokens and your plan limit.
* **This bot** — how many tokens are tracked in the current bot.
* **Other bots** — how many tokens are added in your other bots.
* **Groups & Discord & Dedicated** — how many tokens are tracked in groups, Discord, and dedicated bots.

#### **Token statuses:**

✅ **Token is active** — the token is being tracked.\
⏸ **Token paused by you** — you paused tracking.\
⏳ **Token paused** — temporary pause due to high transaction volume.\
🛑 **Renew premium** — renew your subscription to continue tracking.

***

### ⚙️ Management and editing

```
✅ /mint_0 <Token Ticker> <Token Address>
```

**Click on `/mint_0` to open the editing menu, where you can:**

* change the price change threshold (%),
* set the minimum trade amount (USD) for notifications,
* remove the token from the list.

#### 🗑 Deleting a token

* Via the 🗑 **Delete Token** button — enter the token address manually.
* Or click on the token in the list (`/mint_0`) → the management menu will open → select 🗑 **Delete**.

***

### 📈 Plan limits

The number of tokens you can track directly depends on your subscription plan.\
The higher the plan, the more tokens you can add for monitoring and receive real-time notifications for them.

| Plan                      | Token Limit |
| ------------------------- | ----------- |
| **Starter** (free)        | 5           |
| **Hobby** (0.1 SOL/month) | 25          |
| **Hobby** (0.2 SOL/month) | 50          |
| **Pro**                   | 100         |
| **Whale**                 | 200         |