Events

TokenBot defines 46 event types across 12 families, all listed below. You can subscribe to any subset of these (up to 20 events per webhook), or to all of them with ["*"].

Not every event is emitted yet — the list below is the full registrable set. Trade, copier, copy, strategy, exchange, reward, and withdrawal events are the most commonly fired today.

Event Payload Format

{
  "event": "trade.executed",
  "event_id": "evt_abc123",
  "timestamp": "2026-06-20T12:00:00Z",
  "data": { ... }
}

Each delivery also carries X-TokenBot-Event and X-TokenBot-Delivery-Id headers (see Security).

Trade Events

Event	Description
trade.created	A new trade order has been placed
trade.updated	Trade order details updated
trade.executed	Trade order executed/filled
trade.filled	Deprecated alias of trade.executed
trade.cancelled	Trade order cancelled
trade.failed	Trade order failed
trade.closed	Trade position closed

Example payload (trade.executed):

{
  "event": "trade.executed",
  "event_id": "evt_123",
  "timestamp": "2026-06-20T12:00:00Z",
  "data": {
    "id": "trd_abc123",
    "exchange_account_id": "exc_123",
    "strategy_id": "str_123",
    "trade_pair": "BTC/USDT",
    "side": "BUY",
    "type": "LIMIT",
    "price": 50000.00,
    "amount": 0.1,
    "fee": 0.05,
    "status": "FILLED",
    "executed_at": "2026-06-20T12:00:00Z"
  }
}

Position Events

Event	Description
position.opened	A position was opened
position.closed	A position was closed

Strategy Events

Event	Description
strategy.created	New strategy created
strategy.updated	Strategy settings updated
strategy.activated	Strategy activated
strategy.deactivated	Strategy deactivated
strategy.deleted	Strategy deleted
strategy.error	Strategy encountered an error

Copier Events

Event	Description
copier.created	New copier created
copier.updated	Copier settings updated
copier.started	Copier activated
copier.stopped	Copier deactivated
copier.deleted	Copier deleted
copier.error	Copier encountered an error

Copy Events

Event	Description
copy.triggered	Copy initiated from a strategy signal
copy.completed	Copy successfully executed
copy.failed	Copy failed to execute

Example payload (copy.failed):

{
  "event": "copy.failed",
  "event_id": "evt_456",
  "timestamp": "2026-06-20T12:01:00Z",
  "data": {
    "copier_id": "cop_123",
    "strategy_id": "str_123",
    "source_trade_id": "trd_abc123",
    "error": "Insufficient balance"
  }
}

Exchange Events

Event	Description
exchange.connected	Exchange account connected
exchange.disconnected	Exchange account disconnected (e.g., invalid credentials)
exchange.error	Exchange account error
exchange.balance_updated	Exchange balance changed
exchange.sync_completed	Exchange balance sync completed

Alert Events

Event	Description
alert.triggered	A configured alert fired
alert.price_reached	A price threshold was reached
alert.volume_spike	A volume spike was detected
alert.drawdown_exceeded	A drawdown threshold was exceeded
alert.profit_target_reached	A profit target was reached

User Events

Event	Description
user.created	A user was created
user.updated	A user was updated
user.verified	A user was verified
user.suspended	A user was suspended
user.deleted	A user was deleted

Account Events

Event	Description
account.created	An account was created
account.verified	An account was verified

Reward Events

Event	Description
reward.earned	Reward points / $TBOT earned

Withdrawal Events

Event	Description
withdrawal.created	A withdrawal was requested
withdrawal.completed	A withdrawal completed

System Events

Event	Description
system.maintenance	Maintenance window notification
system.update	Platform update notification

Subscribing

Subscribe to specific events or use ["*"] for all:

{
  "url": "https://your-server.com/webhooks",
  "events": ["trade.executed", "copy.failed", "copier.started"]
}