Copiers

Copiers are exchange accounts that automatically replicate trades from a Strategy account.

---

How Copiers Work

When you add an exchange account as a copier to a strategy:

1. TokenBot monitors the strategy (source) account via WebSocket
2. When a trade is detected (typically < 100ms), TokenBot calculates the equivalent order
3. The order is sent to the copier’s exchange
4. Execution completes in under 1 second total

---

Adding a Copier

# List the strategies available to follow, and your exchange accounts
tokenbot strategy list
tokenbot exchange list

# Create the copier — allocation is a percentage (0-100) of that account
tokenbot copier add --strategy <strategy-id> --exchange-account-id <account-id> \
  --name "btc follow" --allocation 25

# Confirm the binding
tokenbot links list

Change allocation later with tokenbot copier show <id> to inspect, and rebind or detach with tokenbot link / tokenbot unlink — both take --copier and --strategy flags.

---

Copier Settings

Setting	Description
Copy Mode	Same Size, Proportional, or Fixed Percentage
Max Order Size	Cap the maximum trade size for this copier
Enabled Pairs	Optionally limit which trading pairs are copied
Active	Pause/resume without removing the copier

---

Cross-Exchange Copying

Copiers don’t need to be on the same exchange as the strategy. You can trade on Binance and have copiers on Bybit, OKX, Coinbase, or any supported exchange.

Note: The trading pair must be available on the copier’s exchange. If you buy a token that isn’t listed on a copier’s exchange, that copier skips the trade and alerts you.

---

Error Handling

Scenario	Behavior
Insufficient balance	Trade skipped, alert sent
Pair not available	Trade skipped, alert sent
Exchange down	Retry with backoff, then alert
API key invalid	Copier disabled, alert sent