HTTP codes
401 unauthorized; 403 market/scope denied; 404 path/symbol; 429 quota/RPM; 5xx backoff and keep X-Request-Id.
Documentation
Errors & Rate Limits
Reliable market pipelines must handle auth, entitlement, and quota errors without retry storms.
429 & Retry-After
On 429 honor Retry-After when present; exponential backoff with jitter. Cap concurrency on historical pulls.
Logging
Log request_id, endpoint, status, and a short body. Alert on 401/403/429 separately in production.
Envelope errors
JSON uses succ/data/msg/code. HTTP 2xx can still be succ=false—check both status and envelope.
Related docs
Field tables live under /docs/api/*; pair with auth and WebSocket reconnect guides.