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
| Field | Type | Required | Notes |
|---|---|---|---|
side | ENUM SUBSCRIBE | REDEEM | No | Defaults to SUBSCRIBE. |
exchangeUserId | string | Yes | Your end-user id. 1–128 chars, [A-Za-z0-9._:-]. |
clientOrderId | string | Yes | Your idempotency key. 1–128 chars, same charset. |
product | string | Yes | Product slug, e.g. ORBIS. ≤32 chars, [A-Z0-9_-]. Must be an ACTIVE pool. |
usdtAmount | string | SUBSCRIBE only | USDT notional. > 0, ≤6 decimals, ≤10 integer digits (e.g. "10000.00"). |
units | string | REDEEM only | ORBIS 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
- JavaScript
- Python
- HTTP
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"
}'
const res = await fetch("https://api.orbitum.io/api/v1/cex/orders", {
method: "POST",
headers: {
"X-Api-Key": process.env.ORBITUM_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
side: "SUBSCRIBE",
exchangeUserId: "user-123",
clientOrderId: "ord-2026-0001",
product: "ORBIS",
usdtAmount: "10000.00", // string, never a number
}),
});
const { data } = await res.json();
import os, requests
res = requests.post(
"https://api.orbitum.io/api/v1/cex/orders",
headers={"X-Api-Key": os.environ["ORBITUM_API_KEY"]},
json={
"side": "SUBSCRIBE",
"exchangeUserId": "user-123",
"clientOrderId": "ord-2026-0001",
"product": "ORBIS",
"usdtAmount": "10000.00", # str, use decimal.Decimal to build it
},
)
data = res.json()["data"]
POST /api/v1/cex/orders HTTP/1.1
Host: api.orbitum.io
X-Api-Key: <your-key>
Content-Type: application/json
{"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
| Status | Meaning | Terminal? | Next |
|---|---|---|---|
INIT | Accepted, placement in progress | No | PENDING |
PENDING | Priced & reserved; awaiting settlement | No | CANCELLED, settled |
CANCELLED | Cancelled; hold released | Yes | — |
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.