EigenExplorer API returns machine readable error codes, human readable error messages and a link to the docs for more information.

Here is how an error response looks like:

{
    "error": {
        "code": "not_found",
        "message": "The requested resource was not found.",
        "doc_url": "https://api.eigenexplorer.com/api-reference/errors#not_found"
    }
}

Error Codes

Here is a list of all error codes EigenExplorer API returns:

bad_request

  • Status: 400
  • Problem: The request is malformed, either missing required fields, using wrong datatypes, or being syntactically incorrect.
  • Solution: Check the request and make sure it is properly formatted.

unauthorized

  • Status: 401
  • Problem: The request has not been applied because it lacks valid authentication credentials for the target resource.
  • Solution: Make sure you are using the correct API key or access token.

forbidden

  • Status: 403
  • Problem: The server understood the request, but is refusing to fulfill it because the client lacks proper permission.
  • Solution: Make sure you have the necessary permissions to access the resource.

not_found

  • Status: 404
  • Problem: The server has not found anything matching the request URI.
  • Solution: Check the request and make sure the resource exists.

unprocessable_entity

  • Status: 422
  • Problem: The server was unable to process the request because it contains invalid data.
  • Solution: Check the request and make sure input data is valid.

rate_limit_exceeded

  • Status: 429
  • Problem: The request has been rate limited.
  • Solution: Wait for a while and try again.

internal_server_error

  • Status: 500
  • Problem: The server encountered an unexpected condition that prevented it from fulfilling the request.
  • Solution: Try again later. If the problem persists, contact support.