Errors - Cryptorank API v3

Every error returns the same JSON envelope; status mirrors the HTTP status. Switch on code, not message (message text may change).

Error envelope

{
  "error": {
    "code": "API_KEY_INVALID",
    "message": "API key is invalid",
    "status": 401
  }
}

Errors don’t consume credits — only successful (2xx) responses deduct.

Error codes

Status	`code`	When it happens
`400`	`VALIDATION_ERROR`	A query or path parameter failed validation (wrong type, out of range, malformed).
`401`	`API_KEY_MISSING`	The `X-Api-Key` header was not sent.
`401`	`API_KEY_INVALID`	The API key is not recognized.
`403`	`NO_ACTIVE_SUBSCRIPTION`	The key’s account has no active subscription.
`403`	`ENDPOINT_NOT_AVAILABLE`	The endpoint is not included in your plan.
`403`	`PLAN_LIMIT_EXCEEDED`	The request goes beyond what your current plan allows (e.g. a time range deeper than your plan permits).
`404`	`NOT_FOUND`	The requested resource does not exist.
`429`	`RATE_LIMIT_EXCEEDED`	The per-key request rate (RPM) was exceeded.
`429`	`DAILY_CREDITS_EXCEEDED`	The daily credit allowance is used up.
`429`	`MONTHLY_CREDITS_EXCEEDED`	The monthly credit allowance is used up.
`500`	`INTERNAL_ERROR`	An unexpected server error. Retry with backoff; if it persists, contact support.

Rate limits and retries

429 responses carry a Retry-After header (seconds) — wait that long before retrying. See Pricing page for per-plan rates and allowances.

Retry only 429 (respect Retry-After) and 500. Other 4xx (400/401/403/404) just fail again until you fix the input, key, plan, or resource.