Error Codes

The API uses standard HTTP status codes to indicate whether a request succeeded or failed.

HTTP Status Codes

Status Code	Meaning	Description
200	OK	The request completed successfully.
201	Created	A resource was created successfully.
400	Bad Request	The request is invalid or missing required fields.
401	Unauthorized	The API key is missing or invalid.
404	Not Found	The requested resource could not be found.
500	Internal Server Error	An unexpected server error occurred.

Common Errors

Invalid API Key

Status Code

401 Unauthorized

Response

{
  "detail": "Invalid API Key"
}

Resolution

• Verify that the x-api-key header is included.
• Ensure you are using an active API key.
• Confirm you are using the correct environment (development or production).

Invalid Request

Status Code

400 Bad Request

Response

{
  "detail": "Invalid wallet address"
}

Resolution

Check that all required request fields are provided and correctly formatted. It could be invalid wallet address or the amount could be zero or less than zero.

Transaction Not Found

Status Code

404 Not Found

Response

{
  "detail": "Transaction not found"
}

Resolution

Verify that the transaction hash is correct and belongs to your account.