Skip to main content

Price-lock & reservation

SUBSCRIBE — price is locked, stock is reserved​

When you place a SUBSCRIBE order, the API:

  1. Locks the price to the latest POSTED base NAV (returned as lockedPrice).
  2. Computes units = floor(usdtAmount / lockedPrice) at 6-decimal granularity.
  3. Reserves those ORBIS units on the CEX stock account (a hold).
  4. 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.