Error Handling

The API uses standard HTTP status codes and returns JSON error responses.

HTTP Status Codes

Code

Meaning

Description

200

OK

Request successful

400

Bad Request

Invalid request parameters

401

Unauthorized

Invalid or missing API key

403

Forbidden

Insufficient permissions

404

Not Found

Resource not found

500

Server Error

Internal server error

503

Service Unavailable

Temporarily offline for maintenance

Error Response Example

{
  "success": false,
  "message": "Insufficient wallet balance",
  "error_code": "INSUFFICIENT_BALANCE",
  "data": {
    "required_amount": 53000,
    "current_balance": 25000,
    "shortfall": 28000
  }
}
Updated on