Error Handling

API responses use a structured error envelope with machine-readable codes and descriptive messages.

Error Envelope

{
  "error": {
    "code": "validation_error",
    "message": "The amount must be at least 10000.00 USDT.",
    "field": "amount"
  }
}

Status	Code	When It Happens
400 Bad Request	validation_error	Payload structure or field validation fails
401 Unauthorized	unauthorized	Missing or invalid bearer token
403 Forbidden	forbidden	Insufficient scope or missing CSRF token
404 Not Found	resource_not_found	Requested resource ID not present
409 Conflict	conflict	Resource state conflict or duplicate action
422 Unprocessable	business_rule_violation	Request valid but blocked by platform rules
429 Too Many Requests	rate_limit_exceeded	Request volume exceeded rate limit
500 Internal Server Error	internal_error	Unexpected server-side failure

For retry-safe create operations, include an idempotency key header.

Idempotency-Key: 5e24c6f9-1806-440f-8f89-f2d3edced8f1

Docs Navigation

Current: Error Codes

Open all sections

Overview

Getting Started

Role Guides

Compliance & Trust

Developer Reference

Home / Documentation / API Error Codes

API responses use a structured error envelope with machine-readable codes and descriptive messages.

{
  "error": {
    "code": "validation_error",
    "message": "The amount must be at least 10000.00 USDT.",
    "field": "amount"
  }
}

Status	Code	When It Happens
400 Bad Request	validation_error	Payload structure or field validation fails
401 Unauthorized	unauthorized	Missing or invalid bearer token
403 Forbidden	forbidden	Insufficient scope or missing CSRF token
404 Not Found	resource_not_found	Requested resource ID not present
409 Conflict	conflict	Resource state conflict or duplicate action
422 Unprocessable	business_rule_violation	Request valid but blocked by platform rules
429 Too Many Requests	rate_limit_exceeded	Request volume exceeded rate limit
500 Internal Server Error	internal_error	Unexpected server-side failure

For retry-safe create operations, include an idempotency key header.

Idempotency-Key: 5e24c6f9-1806-440f-8f89-f2d3edced8f1