Error Reference
Errors use RFC 9457 application/problem+json — see Anatomy.
code, not textSwitch on the stable machine-readable code. The human title/detail may
change without notice and must never be shown to end users verbatim.
The Retryable column tells you whether re-sending the identical request can
help: business/validation errors (4xx) are not retryable — fix the request;
transient errors and 503/429 are retryable with backoff (see
Rate limits & 429).
Stable error codes (machine API)
Order placement & cancel
| Code | HTTP | Retryable | Meaning |
|---|---|---|---|
CEX_AMOUNT_TOO_SMALL | 422 UNPROCESSABLE_ENTITY | no | Amount too small to buy a whole unit |
CEX_BALANCE_UNVERIFIABLE | 503 SERVICE_UNAVAILABLE | yes | On-chain balance could not be verified |
CEX_DAILY_CAP_EXCEEDED | 422 UNPROCESSABLE_ENTITY | no | Daily USD cap exceeded |
CEX_IDEMPOTENCY_CONFLICT | 422 UNPROCESSABLE_ENTITY | no | Idempotency key reused with different parameters |
CEX_INSUFFICIENT_OMNIBUS | 400 BAD_REQUEST | no | Omnibus holds insufficient ORBIS to redeem |
CEX_NAV_INVALID | 409 CONFLICT | no | POSTED NAV price is invalid |
CEX_NAV_UNAVAILABLE | 409 CONFLICT | yes | No POSTED NAV available to lock a price |
CEX_NO_STOCK | 400 BAD_REQUEST | no | Insufficient ORBIS stock to reserve |
CEX_ORDER_NOT_CANCELLABLE | 409 CONFLICT | no | Order is not in a cancellable state |
CEX_ORDER_NOT_FOUND | 404 NOT_FOUND | no | Order not found |
CEX_PARTNER_CONFIG_UNAVAILABLE | 409 CONFLICT | no | No active partner configuration |
CEX_PARTNER_SUSPENDED | 403 FORBIDDEN | no | CEX partner is not active |
CEX_PER_ORDER_EXCEEDED | 422 UNPROCESSABLE_ENTITY | no | Per-order USD limit exceeded |
CEX_PLACEMENT_RACE | 409 CONFLICT | yes | Order placement was interrupted by a concurrent operation |
CEX_UNAUTHORIZED | 401 UNAUTHORIZED | no | Missing or invalid API key |
CEX_UNITS_OUT_OF_RANGE | 422 UNPROCESSABLE_ENTITY | no | Computed units are out of range |
CEX_VALIDATION_FAILED | 400 BAD_REQUEST | no | Request validation failed |
Product / offering (returned at order time)
| Code | HTTP | Retryable | Meaning |
|---|---|---|---|
CEX_OFFERING_CHAIN_UNSERVED | 409 CONFLICT | no | Offering chain is not served by the omnibus |
CEX_OFFERING_NOT_ACCEPTED | 409 CONFLICT | no | Offering has not been accepted |
CEX_OFFERING_SUSPENDED | 409 CONFLICT | no | Offering is suspended |
CEX_PRODUCT_NOT_OFFERED | 404 NOT_FOUND | no | Product is not offered to this partner |
Payment confirmation (advanced, flag-gated)
| Code | HTTP | Retryable | Meaning |
|---|---|---|---|
CEX_BATCH_UNDER_REVIEW | 409 CONFLICT | yes | Settlement batch is under review |
CEX_BATCH_VOIDED | 409 CONFLICT | no | Settlement batch has been voided |
CEX_BATCH_VOIDING | 409 CONFLICT | no | Settlement batch is being voided |
CEX_DEPOSIT_ALREADY_MATCHED | 409 CONFLICT | no | This deposit already settled another batch |
CEX_PAID_PAST_DEADLINE | 422 UNPROCESSABLE_ENTITY | no | Payment finalized after the settlement deadline; contact operations |
CEX_PAYMENT_MISMATCH | 422 UNPROCESSABLE_ENTITY | no | Payment does not match the settlement batch |
CEX_PAYMENT_PENDING_FINALITY | 409 CONFLICT | yes | Payment not yet final; retry after your confirmations land |
CEX_PAYMENT_VERIFICATION_UNAVAILABLE | 503 SERVICE_UNAVAILABLE | yes | On-chain verification is temporarily unavailable; retry |
CEX_SETTLEMENT_NOT_FOUND | 404 NOT_FOUND | no | Settlement batch not found |
CEX_TX_NOT_FOUND | 422 UNPROCESSABLE_ENTITY | yes | Transaction not found on-chain |
Each code's stable type URI is https://api.orbitum.io/problems/{code}. Every
response carries an X-Request-Id header (and requestId in the body) — log it and
include it in support requests.
Portal-surface codes (
CEX_PORTAL_*,CEX_API_KEY_*,CEX_OMNIBUS_*,CEX_POOL_*) are not part of the machine API and are covered in the Onboarding journey.