Order options
string
limit rests at a price you set. market executes immediately against the book and never rests.string
buy or sell.string
A whole number of contracts.
string
gtc rests until filled or cancelled, ioc fills what it can immediately then cancels the rest, fok fills fully or not at all.boolean
Rejects the order if it would take liquidity — guarantees you stay on the maker side.
boolean
Rejects the order if it would increase your position — use it for exit-only orders.
string
Your own id. Resending the same order with the same id returns the original result instead of placing a duplicate.
marginMode (isolated by default, or cross) and the conditional triggers stopPrice, stopLossPrice, and takeProfitPrice. An order with a trigger is held and submitted once the OCX order-book mid reaches the trigger — see Place an order.
Preview before you trade
Both venues have a preview endpoint that dry-runs an order with no side effects. It returns the notional, the estimated fee, the margin required, and whether the order would be approved.Placing orders
Futures orders use
/fut/orders. Option orders use /orders. Multi-leg option strategies use /orders/strategy.Multi-leg option strategies
Combine 2–8 option legs into a single strategy (for example a vertical spread or a straddle). Strategies sent to/orders/strategy are all-or-none and immediate: every leg must fully fill against the book or nothing executes.
Order lifecycle
1
Submit
You place (or preview) an order. It passes a margin check before acceptance; if the only problem is collateral sitting elsewhere in your account, the gateway moves it and retries once.
2
Match or rest
A marketable order matches immediately against the book. Any unfilled remainder rests (
gtc) or is cancelled (ioc); a fok order that cannot fill in full does not execute. A postOnly order that would take liquidity is rejected outright.3
Fill
Each fill records its price, quantity, fee, and whether you were the maker or taker (
liquidity). Fills update your position immediately.4
Amend or cancel
Cancel one order by id or cancel all your orders in a market. Resting orders can be amended:
POST /fut/orders/{id}/amend for futures and POST /options/orders/{id}/modify for options.