Skip to main content

Place order

POST /api/v1/cex/orders → 201

Place a SUBSCRIBE (buy in with USDT) or REDEEM (unstake ORBIS units) order.

Monetary values are strings

All amounts are strings at 6-decimal scale. Never parse them as floats — see money handling.

Request body​

FieldTypeRequiredNotes
sideENUM SUBSCRIBE | REDEEMNoDefaults to SUBSCRIBE.
exchangeUserIdstringYesYour end-user id. 1–128 chars, [A-Za-z0-9._:-].
clientOrderIdstringYesYour idempotency key. 1–128 chars, same charset.
productstringYesProduct slug, e.g. ORBIS. ≤32 chars, [A-Z0-9_-]. Must be an ACTIVE pool.
usdtAmountstringSUBSCRIBE onlyUSDT notional. > 0, ≤6 decimals, ≤10 integer digits (e.g. "10000.00").
unitsstringREDEEM onlyORBIS units to unstake. > 0, ≤6 decimals (e.g. "9771.290000").

Provide exactly one of usdtAmount (SUBSCRIBE) or units (REDEEM) — both or neither returns CEX_VALIDATION_FAILED.

Example​

curl https://api.orbitum.io/api/v1/cex/orders \
-H "X-Api-Key: $ORBITUM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"side": "SUBSCRIBE",
"exchangeUserId": "user-123",
"clientOrderId": "ord-2026-0001",
"product": "ORBIS",
"usdtAmount": "10000.00"
}'

Response 201​

{
"requestId": "req_8f3c1a",
"data": {
"orderRef": "CXO-20260902-001",
"side": "SUBSCRIBE",
"product": "ORBIS",
"usdtAmount": "10000.00",
"lockedPrice": "1.023400",
"units": "9771.290000",
"status": "PENDING"
}
}

Order status​

StatusMeaningTerminal?Next
INITAccepted, placement in progressNoPENDING
PENDINGPriced & reserved; awaiting settlementNoCANCELLED, settled
CANCELLEDCancelled; hold releasedYes—

Settled orders appear in settlement batches.

Errors​

Common: CEX_VALIDATION_FAILED, CEX_NO_STOCK, CEX_NAV_UNAVAILABLE, CEX_DAILY_CAP_EXCEEDED, CEX_OFFERING_NOT_ACCEPTED, CEX_IDEMPOTENCY_CONFLICT, CEX_INSUFFICIENT_OMNIBUS (REDEEM). Full list: Error Reference.