Errors and Limits

Error shape

Errors are returned as JSON:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable message"
  }
}

Common HTTP statuses

• 400 invalid input or malformed parameters
• 401 missing or invalid authentication
• 403 endpoint not allowed for developer keys
• 404 resource not found
• 429 rate limit exceeded
• 500 internal server error

Access denial examples

• 403 with code FORBIDDEN when a developer key calls an unsupported route.
• 403 with code FORBIDDEN when a developer key sends a non-GET request.

Rate limiting

Requests are rate-limited to protect service reliability.

• Developer API keys are limited to 60 requests per 60 seconds per key.
• 429 responses include Retry-After.
• Backoff and retry with jitter on temporary failures.

Integration guidance

• Implement retries for 429 and selected 5xx responses.
• Avoid high-frequency polling when data does not require it.
• Cache responses where your use case allows.