Response Format
HTTP API
WebSocket
Error Code Quick Reference
Detailed Descriptions
Authentication Errors (1xxx)
1001 - Invalid or Expired API Key
- Incorrect API Key
- API Key disabled
- API Key expired
1002 - API Key Not Provided
X-API-Key: your_api_key to HTTP headers, or add ?api_key=your_api_key to WebSocket URL.
1003 - IP Not in Whitelist
1004 - Insufficient Permissions
Parameter Errors (2xxx)
2001 - Invalid Parameters
2002 - Symbol Not Found
GET /v1/symbols/available to get available symbols.
2003 - Invalid Time Range
- start_time greater than end_time
- Invalid time format
- Time range exceeds limit
2004 - Request Limit Exceeded
limit parameter value (typically max 1000).
Rate Limiting Errors (3xxx)
3001 - Rate Limit Exceeded
Retry-After header indicating wait time in seconds.
Solutions:
- Reduce request frequency
- Use WebSocket subscriptions instead of polling
- Upgrade plan for higher quota
3002 - Quota Exhausted
3003 - Connection Limit Exceeded
- Call
GET /v1/connectionsto view current connections - Call
DELETE /v1/connections/:idto close excess connections
3004 - Subscription Limit Exceeded
WebSocket Errors (4xxx)
4001 - Unknown Command
cmd field. Supported commands: subscribe, unsubscribe, ping.
4002 - Invalid Message Format
4003 / 4004 - Subscription Temporarily Unavailable
Service Errors (5xxx)
5000 - Internal Server Error
5001 - Data Source Unavailable
5002 - Service Temporarily Unavailable
Error Handling Examples
JavaScript
Python
For questions, please contact technical support.
