DEVELOPERS
API errors
Stage-1 error map. Rate-limit bodies include messages like rate limit per_minute exceeded. More context in the FAQ.
| Status | Name | Meaning | What to do |
|---|---|---|---|
400 | bad request | Invalid query or body. | Check required params in the docs. |
401 | missing/invalid API key | Auth required or key rejected. | Create a key in /dashboard and send X-API-Key. |
402 | credits exhausted | Monthly credits hit zero. | Upgrade plan or wait for reset. |
403 | plan gate | Endpoint or market type not in your plan. | See Pricing entitlements; upgrade if needed. |
404 | not found | Unknown asset, exchange, or path. | Verify slug/id against markets/exchanges. |
429 | rate limit exceeded | per_second / per_minute / per_day cap hit. | Slow down, cache, or upgrade. |
500 | server error | Upstream or internal failure. | Retry with backoff; check /v1/status. |
503 | unavailable | Dependency or maintenance. | Check status; retry later. |