Skip to main content
Only a 2xx response spends credits. Any other response is stored in List API Request Logs with credits_charged of 0. Use the HTTP status, error.code, and error.request_id when you contact support@defiorbit.xyz.

Error body

Every failure uses this JSON:

Status codes

Each reference page shows 200, then 400, 401, 402, 403, 429, and 500. 502, 503, and 504 are on the page for the route that returns them. Any other failure is returned as NOT_FOUND on 404, INVALID_REQUEST on any other 4xx, and INTERNAL_ERROR on 5xx.

Retry

Retry 429 after the Retry-After value. Retry 502, 503, and 504 after a short wait. Leave 400, 401, 402, 403, and 404 alone until the request or the account changes.

Suspended organizations

Suspending an organization suspends its DeFi Orbit API access. Calls then return 403 ACCOUNT_SUSPENDED. Restoring the organization restores API access with the same keys and credit balance. While it is suspended, creating a key from the dashboard returns HTTP 403 with ACCOUNT_SUSPENDED. Contact support@defiorbit.xyz if you need the organization resumed.

Rate limit

New organizations start at 5 requests per second. The limit applies to the organization, and it can be adjusted.

Request logs

GET /v1/usage/logs returns method, path, status code, latency, credits charged, time, and the key id and name. Filter with range (5m, 1h, 24h, 7d, 30d), from and to, api_key_id, path, status_code, and errors (all, success, or errors).