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