Webhooks Overview

Webhooks deliver real-time event notifications to your server via HTTP POST requests.

How It Works

1. Register a webhook URL and subscribe to events
2. When events occur, TokenBot sends a signed HTTP POST to your URL
3. Your server responds with 2xx to acknowledge receipt
4. Failed deliveries are retried with exponential backoff

Quick Start

# Create a webhook
curl -X POST https://api.tokenbot.com/v1/webhooks \
  -H "X-API-Key: tb_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhooks",
    "events": ["trade.filled", "copier.started", "copier.stopped"]
  }'

Documentation

• Management — Create, update, delete, test webhooks
• Events — All 46 event types with payloads
• Security — Signature verification
• Delivery — Retry logic and dead letter queue