Skip to main content

Error Reference

Errors use RFC 9457 application/problem+json — see Anatomy.

Branch on code, not text

Switch 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​

CodeHTTPRetryableMeaning
CEX_AMOUNT_TOO_SMALL422 UNPROCESSABLE_ENTITYnoAmount too small to buy a whole unit
CEX_BALANCE_UNVERIFIABLE503 SERVICE_UNAVAILABLEyesOn-chain balance could not be verified
CEX_DAILY_CAP_EXCEEDED422 UNPROCESSABLE_ENTITYnoDaily USD cap exceeded
CEX_IDEMPOTENCY_CONFLICT422 UNPROCESSABLE_ENTITYnoIdempotency key reused with different parameters
CEX_INSUFFICIENT_OMNIBUS400 BAD_REQUESTnoOmnibus holds insufficient ORBIS to redeem
CEX_NAV_INVALID409 CONFLICTnoPOSTED NAV price is invalid
CEX_NAV_UNAVAILABLE409 CONFLICTyesNo POSTED NAV available to lock a price
CEX_NO_STOCK400 BAD_REQUESTnoInsufficient ORBIS stock to reserve
CEX_ORDER_NOT_CANCELLABLE409 CONFLICTnoOrder is not in a cancellable state
CEX_ORDER_NOT_FOUND404 NOT_FOUNDnoOrder not found
CEX_PARTNER_CONFIG_UNAVAILABLE409 CONFLICTnoNo active partner configuration
CEX_PARTNER_SUSPENDED403 FORBIDDENnoCEX partner is not active
CEX_PER_ORDER_EXCEEDED422 UNPROCESSABLE_ENTITYnoPer-order USD limit exceeded
CEX_PLACEMENT_RACE409 CONFLICTyesOrder placement was interrupted by a concurrent operation
CEX_UNAUTHORIZED401 UNAUTHORIZEDnoMissing or invalid API key
CEX_UNITS_OUT_OF_RANGE422 UNPROCESSABLE_ENTITYnoComputed units are out of range
CEX_VALIDATION_FAILED400 BAD_REQUESTnoRequest validation failed

Product / offering (returned at order time)​

CodeHTTPRetryableMeaning
CEX_OFFERING_CHAIN_UNSERVED409 CONFLICTnoOffering chain is not served by the omnibus
CEX_OFFERING_NOT_ACCEPTED409 CONFLICTnoOffering has not been accepted
CEX_OFFERING_SUSPENDED409 CONFLICTnoOffering is suspended
CEX_PRODUCT_NOT_OFFERED404 NOT_FOUNDnoProduct is not offered to this partner

Payment confirmation (advanced, flag-gated)​

CodeHTTPRetryableMeaning
CEX_BATCH_UNDER_REVIEW409 CONFLICTyesSettlement batch is under review
CEX_BATCH_VOIDED409 CONFLICTnoSettlement batch has been voided
CEX_BATCH_VOIDING409 CONFLICTnoSettlement batch is being voided
CEX_DEPOSIT_ALREADY_MATCHED409 CONFLICTnoThis deposit already settled another batch
CEX_PAID_PAST_DEADLINE422 UNPROCESSABLE_ENTITYnoPayment finalized after the settlement deadline; contact operations
CEX_PAYMENT_MISMATCH422 UNPROCESSABLE_ENTITYnoPayment does not match the settlement batch
CEX_PAYMENT_PENDING_FINALITY409 CONFLICTyesPayment not yet final; retry after your confirmations land
CEX_PAYMENT_VERIFICATION_UNAVAILABLE503 SERVICE_UNAVAILABLEyesOn-chain verification is temporarily unavailable; retry
CEX_SETTLEMENT_NOT_FOUND404 NOT_FOUNDnoSettlement batch not found
CEX_TX_NOT_FOUND422 UNPROCESSABLE_ENTITYyesTransaction 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.