WebSocket API

Errors

WebSocket error response format and common integration errors

Error Format

{
  "type": "error",
  "channel": "CHANNEL_NAME",
  "message": "error description",
  "code": 400
}

Common Errors

CodeMessageResolution
400given channel/mkt_id is unsupportedVerify channel name and market identifier
401not authenticatedSend auth message before subscribing to private channels

Operational Guidance

  1. Treat auth failures as non-retryable until credentials/signature are refreshed.
  2. Treat unsupported channel/market errors as configuration bugs, not transient failures.
  3. Log full error payloads for diagnostics.
  4. Reconnect with backoff only for transport-level failures.

See GET /error-codes for the full list of API error codes.

On this page