Price-lock & reservation
SUBSCRIBE — price is locked, stock is reserved
When you place a SUBSCRIBE order, the API:
- Locks the price to the latest POSTED base NAV (returned as
lockedPrice). - Computes units =
floor(usdtAmount / lockedPrice)at 6-decimal granularity. - Reserves those ORBIS units on the CEX stock account (a hold).
- Enforces the daily cap and per-order limit.
If there is no valid POSTED NAV, the order is rejected with CEX_NAV_UNAVAILABLE
(retry once a NAV is posted) or CEX_NAV_INVALID. If the reserved stock isn't
available, CEX_NO_STOCK.
stateDiagram-v2
[*] --> INIT
INIT --> PENDING: price locked + stock reserved
PENDING --> CANCELLED: you cancel (hold released)
PENDING --> SETTLED: included in a daily settlement batch
CANCELLED --> [*]
SETTLED --> [*]
A PENDING order holds its reservation until it settles in a daily batch or you
cancel it (which releases the hold).
REDEEM — always accepted (except insufficient omnibus)
A REDEEM order unstakes ORBIS units. REDEEM does not touch the
reservation or the daily-cap counter and is always accepted — except when your
omnibus doesn't hold enough ORBIS to cover it
(CEX_INSUFFICIENT_OMNIBUS). USDT liquidity never blocks a REDEEM.