Core concepts

Errors

Error shape and the stable status codes the API returns.

Errors return a JSON body with a stable code, a human-readable message, and the requestId for tracing:

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

json · 7 lines

Status codes

Status	Code	Meaning
400	`invalid_request`	The request was malformed or missing a required field.
401	`unauthorized`	Missing or invalid API key.
402	`no_account`	Your wallet cannot cover the worst-case price of this call. Add funds and retry.
403	`forbidden`	The account is not active.
413	`payload_too_large`	The request body exceeded the size limit.
429	`rate_limited`	Too many requests. Back off and retry after the `retry-after` header.
500	`internal_error`	Something went wrong on our side. Retry, and share the `requestId` if it persists.

Rate-limit specifics live on the Rate limits page.