# Community Bots: Discord & Telegram

**Share your trades with your community automatically. TokenBot's bots post every trade to your Discord server or Telegram group in real-time.**

> 📢 **Official Announcements**: Follow [@TokenBotV2 on X](https://x.com/tokenbot) for news and updates. The legacy TokenBot Telegram and Discord announcement channels are no longer active.

***

## Why Use Our Bots?

### For Traders

* **Build credibility**: Your trades are posted automatically—no cherry-picking
* **Grow your audience**: People see your performance in real-time
* **Save time**: No more manually posting every trade

### For Communities

* **Live trade alerts**: Members see trades as they happen
* **One-click copying**: Enable copy trading directly from alerts
* **Transparency**: Everyone sees the same information

### For Followers

* **No delay**: Catch trades the moment they happen
* **Easy copying**: Tap a button to copy a trade
* **Verified performance**: Alerts come from actual trades, not screenshots

***

## Discord Bot

### What You Get

When a trade executes on your account, the bot posts a message like this:

```
🟢 BUY EXECUTED
━━━━━━━━━━━━━━━
Symbol: BTC/USDT
Side: BUY
Size: 0.15 BTC
Price: $65,234.50
Total: $9,785.18
━━━━━━━━━━━━━━━
Exchange: Binance
Time: 2:34:21 PM UTC

[📋 Copy Trade]
```

### How to Install

1. **Go to your TokenBot dashboard** at app.tokenbot.com
2. **Navigate to Settings → Discord**
3. **Click "Add to Server"** - this opens Discord's authorization page
4. **Select your server** from the dropdown
5. **Authorize the bot** - give it permission to post messages
6. **Choose a channel** - pick where trade alerts will appear

### Configuration Options

| Setting       | What It Does                               |
| ------------- | ------------------------------------------ |
| Alert Channel | Which channel receives trade notifications |
| Include Price | Show or hide entry price                   |
| Include Size  | Show or hide position size                 |
| Copy Button   | Enable one-click copy trading for members  |
| Ping Role     | Tag a role when trades post (optional)     |

### Commands

| Command   | Description              |
| --------- | ------------------------ |
| `/trades` | See recent trade history |
| `/stats`  | View trading statistics  |
| `/help`   | Get help with the bot    |

***

## Telegram Bot

### What You Get

Similar to Discord, the bot posts formatted trade alerts:

```
🟢 BUY EXECUTED

📊 BTC/USDT
💰 Size: 0.15 BTC
💵 Price: $65,234.50

🏦 Binance | ⏰ 2:34 PM UTC

━━━━━━━━━━━━━━━
[📋 Copy This Trade]
```

### How to Install

**For Groups:**

1. **Open Telegram** and find @TokenBotOfficial
2. **Add the bot to your group** as an administrator
3. **Link your TokenBot account** by following the bot's instructions
4. **Configure alerts** through the bot's menu

**For Private Alerts (DM):**

1. **Open Telegram** and message @TokenBotOfficial
2. **Start the bot** with /start
3. **Connect your account** following the prompts
4. **Enable DM alerts** in your TokenBot dashboard

### Commands

| Command     | Description              |
| ----------- | ------------------------ |
| `/start`    | Initialize the bot       |
| `/trades`   | View recent trades       |
| `/settings` | Adjust alert preferences |
| `/help`     | Get assistance           |

***

## Copy Trading from Alerts

One of TokenBot's most powerful features: **your community members can copy your trades with one tap.**

### How It Works

1. **You make a trade** on your Strategy account
2. **Alert posts** to your Discord/Telegram
3. **Member taps "Copy Trade"** button
4. **Their linked account** executes the same trade

### Requirements for Copiers

Members who want to copy trades need:

* A TokenBot account
* At least one exchange connected
* The exchange where the trade was made (or equivalent)

### Settings for Copy Trading

| Option            | Description                                        |
| ----------------- | -------------------------------------------------- |
| Copy Sizing       | Fixed size, percentage, or proportional to account |
| Enabled Exchanges | Which of their exchanges can receive copies        |
| Confirmation      | Require confirmation before executing (optional)   |

***

## Understanding Trade Alerts

### Alert Fields Explained

| Field        | Meaning                                           |
| ------------ | ------------------------------------------------- |
| **Symbol**   | The trading pair (e.g., BTC/USDT, ETH/BTC)        |
| **Side**     | BUY (going long) or SELL (closing or going short) |
| **Size**     | How much was traded                               |
| **Price**    | The execution price                               |
| **Total**    | Size × Price                                      |
| **Exchange** | Where the trade happened                          |
| **Time**     | When the trade executed                           |

### Alert Colors

* 🟢 **Green**: Buy orders, opening longs
* 🔴 **Red**: Sell orders, closing positions
* 🟡 **Yellow**: Limit orders placed (not yet filled)
* ⚪ **White**: Order cancelled or modified

***

## Privacy Options

Not everything needs to be public. Configure what's shared:

| Setting            | Options                          |
| ------------------ | -------------------------------- |
| Show exact price   | Yes / No (show "Market" instead) |
| Show position size | Yes / No / Percentage only       |
| Show exchange name | Yes / No                         |
| Show profit/loss   | Yes / No                         |

***

## Tips for Community Leaders

1. **Create a dedicated channel** for trade alerts (don't mix with general chat)
2. **Pin a message** explaining how to copy trades
3. **Set expectations** - remind members that trading involves risk
4. **Enable slow mode** on the alerts channel to prevent spam reactions

***

## Troubleshooting

### Bot not posting?

* Check the bot has "Send Messages" permission in the channel
* Verify your TokenBot account is connected
* Make sure your Strategy account is active

### Copy trade not working?

* Copier needs a connected exchange account
* Copier's exchange must have sufficient balance
* API key must have trade permissions

### Delayed alerts?

* Usually a network hiccup - alerts should resume within seconds
* Check exchange status if delays persist

***

## Next Steps

Set up your bots:

* [Install Discord Bot →](https://github.com/tokenbot-org/tokenbot-docs/blob/main/help-center/getting-started/add-tokenbot-to-channel-group/README.md)
* [Install Telegram Bot →](https://github.com/tokenbot-org/tokenbot-docs/blob/main/help-center/getting-started/add-tokenbot-to-channel-group-1/README.md)

Or learn about earning rewards:

* [Rewards & Referrals →](https://github.com/tokenbot-org/tokenbot-docs/blob/main/help-center/rewards/README.md)


---

# 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.tokenbot.com/home/05-community-bots.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.