Rate Limits & Errors

Rate Limits

Default rate limit per API key:

• REST: 60 requests / 10 seconds
• WebSocket: 1 subscription message / second / connection

Rate Limit Exceeded Response

1HTTP/1.1 429 Too Many Requests
2{
3  "success": false,
4  "error": {
5    "code": "RATE_LIMIT_EXCEEDED",
6    "message": "Too many requests. Please retry later."
7  }
8}

Rate Limit Headers

Error Format

All error responses follow the same structure:

1{
2  "success": false,
3  "error": {
4    "code": "STRING_CODE",
5    "message": "Human-readable message",
6    "details": { "field": "optional extra info" }
7  }
8}

Common Error Codes

• INVALID_SIGNATURE
• AUTH_REQUIRED
• PERMISSION_DENIED
• SYMBOL_NOT_FOUND
• INSUFFICIENT_MARGIN
• ORDER_NOT_FOUND
• CHALLENGE_NOT_FOUND
• RATE_LIMIT_EXCEEDED
• VALIDATION_ERROR
• INTERNAL_ERROR