Errors

401, 429 and 503 response handling

Draft reference · Examples use sample data.

Error response format

503 · application/json

{
  "demo": true,
  "error": "FEED_STALE",
  "feed": "justmarkets",
  "message": "Fresh quotes unavailable. Check feed status before retrying."
}

Status codes

HTTP	Error code	Next step
`401`	INVALID_API_KEY	Create or replace the key; verify the Authorization header.
`429`	RATE_LIMIT	Wait before retrying. The sample returns retry_after_seconds: 1.
`429`	QUOTA_EXHAUSTED	Annual allowance exhausted; no automatic overage charge.
`503`	FEED_STALE	Check feed status and wait for fresh data.

Retry deliberately

Do not retry invalid credentials or quota exhaustion in a loop. For rate limits, respect retry timing. For stale data, back off and inspect the status response.

Try an error scenario →