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://rest-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 27 event types with payloads

• Security — Signature verification

• Delivery — Retry logic and dead letter queue