Errors
Error handling conventions and status codes used across the API.
All generic errors return {"error": "description"}.
Common Status Codes
- 400 Bad Request: Malformed parameters or missing required fields.
- 404 Not Found: Resource does not exist on-chain.
- 405 Method Not Allowed: Only
GETrequests are supported for reading data. - 500 Internal Server Error: Indexer node infrastructure failure.
Authentication & Rate Limit Errors (Auth API)
The authentication layer returns precise error codes to help you diagnose token and quota issues:
| Status | Code | Meaning |
|---|---|---|
| 401 | invalid_auth / api_key_invalid | Your key or token is malformed, missing, or unrecognized. |
| 401 | api_key_disabled | Your API key was administratively disabled. |
| 401 | token_invalid | The bearer token signature failed validation. |
| 401 | insufficient_scope | Your credential lacks permission for this endpoint. |
| 402 | credits_exhausted | Scope Limits: You have depleted your specific credit pool for this endpoint group. |
| 429 | rate_limit_exceeded | CPS/BPS Limits: You are sending requests too fast. Slow down and let your Token Bucket refill. |
| 429 | monthly_limit_exceeded | CPM Limits: You have reached your maximum monthly credit allocation (CPM). |