Error Responses

400 Bad Request - Invalid Address

{
  "success": false,
  "error": "Invalid address format"
}

401 Unauthorized - Missing/Invalid API Key

{
  "success": false,
  "error": "API key required in header"
}

402 Forbidden - Insufficient credits

{
  "success": false,
  "error": "Insufficient credits"
}

403 Forbidden - Insufficient Paid Endpoint Permission

{
  "success": false,
  "error": "Paid endpoints require credit billing to be enabled"
}

403 Forbidden - Insufficient API Key Permissions

{
  "success": false,
  "error": "API key not authorized for this endpoint"
}

404 Not Found - Request path invalid

{
  "success": false,
  "error": "Not found"
}

404 Not Found - Unsupported Network

{
  "success": false,
  "error": "Network not supported"
}

429 Rate Limit Exceeded

{
  "success": false,
  "error": "Rate limit exceeded"
}

500 Internal Server Error - API Unavailable

{
  "success": false,
  "error": "External service unavailable"
}