Skip to content
TokenBotTokenBotTokenBot

Webhook 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

Section titled “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

Section titled “Trade Events”
EventDescription
trade.createdA new trade order has been placed
trade.updatedTrade order details updated
trade.executedTrade order executed/filled
trade.filledDeprecated alias of trade.executed
trade.cancelledTrade order cancelled
trade.failedTrade order failed
trade.closedTrade 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

Section titled “Position Events”
EventDescription
position.openedA position was opened
position.closedA position was closed

Strategy Events

Section titled “Strategy Events”
EventDescription
strategy.createdNew strategy created
strategy.updatedStrategy settings updated
strategy.activatedStrategy activated
strategy.deactivatedStrategy deactivated
strategy.deletedStrategy deleted
strategy.errorStrategy encountered an error

Copier Events

Section titled “Copier Events”
EventDescription
copier.createdNew copier created
copier.updatedCopier settings updated
copier.startedCopier activated
copier.stoppedCopier deactivated
copier.deletedCopier deleted
copier.errorCopier encountered an error

Copy Events

Section titled “Copy Events”
EventDescription
copy.triggeredCopy initiated from a strategy signal
copy.completedCopy successfully executed
copy.failedCopy 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

Section titled “Exchange Events”
EventDescription
exchange.connectedExchange account connected
exchange.disconnectedExchange account disconnected (e.g., invalid credentials)
exchange.errorExchange account error
exchange.balance_updatedExchange balance changed
exchange.sync_completedExchange balance sync completed

Alert Events

Section titled “Alert Events”
EventDescription
alert.triggeredA configured alert fired
alert.price_reachedA price threshold was reached
alert.volume_spikeA volume spike was detected
alert.drawdown_exceededA drawdown threshold was exceeded
alert.profit_target_reachedA profit target was reached

User Events

Section titled “User Events”
EventDescription
user.createdA user was created
user.updatedA user was updated
user.verifiedA user was verified
user.suspendedA user was suspended
user.deletedA user was deleted

Account Events

Section titled “Account Events”
EventDescription
account.createdAn account was created
account.verifiedAn account was verified

Reward Events

Section titled “Reward Events”
EventDescription
reward.earnedReward points / $TBOT earned

Withdrawal Events

Section titled “Withdrawal Events”
EventDescription
withdrawal.createdA withdrawal was requested
withdrawal.completedA withdrawal completed

System Events

Section titled “System Events”
EventDescription
system.maintenanceMaintenance window notification
system.updatePlatform update notification

Subscribing

Section titled “Subscribing”

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

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