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

# Add

## 📌 How to add a wallet:

**Simply 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 instantly now — no waiting required!
{% 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.

**Simply 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

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