Skip to main content
The Blockradar API uses standard HTTP status codes to indicate whether a request succeeded or failed. When a request fails, the response body contains a message field describing what went wrong.

​
HTTP status codes

CodeMeaning
200Success. The request completed as expected.
400Bad request. A required parameter is missing or malformed.
401Unauthorized. Your API key is missing or invalid.
403Forbidden. Your API key does not have permission for this action.
404Not found. The requested resource does not exist.
422Unprocessable entity. The request was well-formed but failed validation.
429Too many requests. You have exceeded the rate limit.
500Internal server error. Something went wrong on our end.

​
Error response format

{
  "statusCode": 400,
  "message": "walletId is required"
}

​
Handling errors

Check the statusCode field on every response. For 4xx errors, inspect message to understand what to fix. For 500 errors, retry with exponential backoff and contact support if the issue persists.

Full API Reference

View the errors reference in the API Reference tab.