> 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/telegram/interface-navigation/add.md).

# Add

Add any Solana, EVM, or Tron wallet to start tracking its activity in real time.

## 📌 How to add a wallet:

**Send the command:**

```cil
/add <wallet_address> <Name>
```

<details>

<summary><strong>📍 Example:</strong></summary>

```cil
/add 9dD8rBiRgZtTRhzcue...kEZK My Wallet 🚀
```

</details>

After that, you’ll receive a confirmation, and RayBot will start tracking all transactions for that address in real time — including swaps, transfers and more.

{% hint style="info" %}
💡 Monitoring starts as soon as the wallet is added.
{% endhint %}

***

#### 🆕 Add a FOMO user (beta)

No more manually searching for FOMO wallet addresses. Just add a username and RayBot will automatically resolve and track that user's verified SOL and EVM wallets.

**Send the command:**

```cil
/add @username
```

<details>

<summary><strong>📍 Example:</strong></summary>

```cil
/add @unipcs
```

The bot replies with the resolved addresses and starts tracking them just like regular wallets:

```yaml
✅ Tracking @unipcs on SOL + EVM
Resolved wallets:
SOL: 2heJbC32Tpfcb3nbUb5ER61K11FGZVfVGtVnOm6LDogF
EVM: 0x0a6ebed0155edb4b21d92ad02897a626cd98119e
```

</details>

**📌 Managing FOMO users:**\
— `/delete @username` — stop tracking\
— `/fomo` — view all tracked FOMO users and their wallets

{% hint style="info" %}
💡 This feature is currently in beta — please report any issues to [@ray\_help\_bot](https://t.me/ray_help_bot).
{% endhint %}

***

### ⏸️ Add wallet on pause

If you want to add a wallet without immediately receiving notifications — use `/addp`.

The wallet will be added and instantly paused. This gives you time to configure filters before enabling tracking.

**Send the command:**

```
/addp <wallet_address> <name>
```

<details>

<summary><strong>📍 Example:</strong></summary>

```
/addp 9dD8rBiRgZtTRhzcue...kEZK Whale_to_configure🔧
```

</details>

{% hint style="info" %}
💡 Useful for high-activity wallets — add first, set your filters, then unpause when you're ready.
{% endhint %}

***

### ➕ Multiple wallet addition

Send a list of wallets — one per line.\
Want to assign a name? Write it after the address, separated by a space.

<details>

<summary><strong>📍Example:</strong></summary>

```cil
/add WalletAddress1 Name1  
WalletAddress2 Name2  
WalletAddress3 Name3
WalletAddress3 Name4
```

**To add wallets directly on pause** — use `/addp` the same way:

```cil
/addp WalletAddress1 Name1  
WalletAddress2 Name2  
WalletAddress3 Name3
```

💡 **All wallets in the list will be added and immediately paused** — ready for filter configuration.

</details>

***

### **✅ Supported:**

* Solana / Ethereum / Tron / Base and other networks
* Any names: Cyrillic, Latin, emojis, hieroglyphs, and other symbols
* Maximum name length — 40 characters

***

## ⚠️ Common Errors When Adding Wallets

Most common errors when adding a new wallet — and how to fix them:

<details>

<summary>🔁 Wallet already added</summary>

If you're trying to add an address that's already being tracked, the bot will return the message:

```yaml
This wallet already exists: WalletName1
```

The response will show the name under which this address has already been added.

**📌 Solution:**\
If you want to add the same address with a different name, use the command:

```handlebars
/add2 WalletAddress NewName
```

</details>

<details>

<summary>❌Invalid wallet address</summary>

If the address contains extra or missing characters, you’ll see the error:

```
Invalid wallet address.
```

**📌 Solution:**\
Make sure the address is copied in full, with no spaces or typos. Even a single wrong character can make it invalid.

</details>

<details>

<summary>📈 Wallet limit exceeded</summary>

**📌 Solution:**\
To add more wallets, upgrade your plan using the `/upgrade` command.

</details>

<details>

<summary>📝 Name too long</summary>

If you enter a name longer than 40 characters, you’ll see the error:

```cil
name too long.
```

**📌 Limit:**\
Maximum of 40 characters, including emojis, spaces, and symbols.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.raybot.app/start/telegram/interface-navigation/add.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.