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


---

# 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.raybot.app/start/interface-and-buttons-in-telegram/tokens.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.