Skip to main content

​
Format

{
  "error": {
    "code": "INVALID_ARGUMENT",
    "message": "from_block must be <= to_block",
    "details": { "field": "from_block" },
    "request_id": "req_01HXYZ..."
  }
}

​
Common API Errors

HTTPCodeMeaningAction
400INVALID_ARGUMENTBody failed validationFix the field noted in details
401UNAUTHENTICATEDMissing/invalid tokenSend Authorization: Bearer token
403PERMISSION_DENIEDNot allowed for plan/scopeRequest access or adjust scope
404NOT_FOUNDResource not foundVerify endpoint or identifiers
409CONFLICTMutually exclusive filtersChoose one filter set
429RATE_LIMITEDToo many requestsBackoff and retry; request higher limits
500INTERNALUnexpected errorRetry with jitter; include request_id
503UNAVAILABLETemporary outageRetry after a short delay
Include the request_id (if present), timestamp (UTC), and a minimal cURL reproduction when contacting support.