For the complete documentation index, see llms.txt. This page is also available as Markdown.

Account & History Streams

Order, balance, activity, and trade WebSocket endpoints

Use these streams for private account events and public history broadcasts.

Endpoint pages

Shared authentication

Only private streams need auth:

  • Order Updates

  • Balance Updates

  • Order Feed

Send this message after connect.

{
  "t": "AUTH",
  "d": {
    "apiKey": "<API_KEY>",
    "signature": "<SIGNATURE>",
    "timestamp": "<UNIX_EPOCH_SECONDS>"
  }
}

Build signature from timestamp + "GET" + path.

After reconnect, authenticate again and restore every subscription.

Public streams

  • Activity Feed is public. Use subscribe and unsubscribe messages.

  • Last Trades Feed is public. Connect and read messages.

When to use which stream

  • Use Order Updates right after placing or changing orders.

  • Use Balance Updates for wallet and position balance changes.

  • Use Order Feed for history-service order events.

  • Use Activity Feed for per-event live activity.

  • Use Last Trades Feed for public trade tape style updates.

Common errors

Error
Cause

Invalid or missing credentials

API key auth failed

No outcome IDs provided

Subscribe without outcome IDs

Invalid time range

from is after to

Invalid period

Unsupported history period

Unknown message type

Unsupported t value

Last updated

Was this helpful?