Error Codes

Every Options order error carries error.slug and error.code next to its human-readable text in body, on the Order Management Stream, whether the order was sent over WebSocket or over HTTP: the HTTP routes answer 202 once the order is queued, and the engine reports its decision on the stream. The Error Reference describes the shape per transport and the SYS codes shared by every route; HTTP responses use only those. Options codes are OPT: OPT-00xx can answer any order command, OPT-01xx belongs to createOrder, OPT-02xx to cancelOrder, and OPT-03xx to modifyOrder. A condition shared by create and modify takes the same last two digits in both blocks. To send a refused request again, give it a new clientRequestId: the gateway answers a reused one with 409 for 60 seconds.

Any Order Command

Error Code	Error Slug	Server Status Code	Meaning
OPT-0001	CONTRACT_NOT_READY	`400`	The engine has not loaded the contract yet. Retry shortly.
OPT-0002	INACTIVE_CONTRACT	`400`	The contract does not exist or is not tradable: expired, retired or disabled. Refresh your contract list.
OPT-0003	ORDER_REJECTED	`400`	A rejection none of the other codes names. `body` carries the reason.
OPT-0004	ORDER_NOT_FOUND	`404`	No such order for your account: never accepted, or already filled or cancelled.
OPT-0005	RECEIVE_WINDOW_EXCEEDED	`400`	The request waited more than one second between queueing and engine pickup. Nothing was applied.
OPT-0006	RATE_LIMITED	`400`	The operation’s budget is spent. The frame carries no retry hint; back off.
OPT-0007	TOO_MANY_INFLIGHT_ORDERS	`400`	Too many requests are waiting for the engine: your account’s orders, the cancel lane, or the lane of cancel-all sweeps. Wait for their outcomes, then retry.
OPT-0008	ENGINE_OVERLOADED	`400`	The engine is shedding load across all accounts. Back off and retry.
OPT-0009	ENGINE_TIMEOUT	`400`	The request waited past its deadline for a busy contract. Nothing was applied.
OPT-0010	COMMIT_FAILED	`400`	The change could not be saved and was rolled back. Nothing was applied.
OPT-0011	INTERNAL_ERROR	`400`	An internal failure. Its effect is unknown: look the order up before resubmitting.
OPT-0012	MARK_PRICE_UNAVAILABLE	`400`	An open position has no mark price, so margin cannot be computed. Retry shortly.

createOrder

Error Code	Error Slug	Server Status Code	Meaning
OPT-0101	CREATE_ORDER_INSUFFICIENT_BALANCE	`400`	Available balance does not cover the order’s initial margin and fee.
OPT-0102	CREATE_ORDER_MARGIN_RATIO_EXCEEDED	`400`	Your short exposure already uses too much of your collateral for this order to fit. Reduce shorts or add collateral.
OPT-0103	CREATE_ORDER_MAX_OPEN_ORDERS	`400`	The per-contract open-orders cap is reached.
OPT-0104	CREATE_ORDER_SELF_TRADE	`400`	The order would match one of your own resting orders.
OPT-0105	CREATE_ORDER_WOULD_MATCH	`400`	A `postOnly` order would have taken liquidity.
OPT-0106	CREATE_ORDER_REDUCE_ONLY	`400`	A `reduceOnly` order exceeds what your position can close, or there is no position.
OPT-0107	CREATE_ORDER_MIN_VALUE	`400`	Price times quantity is below the $10 minimum. Reduce-only orders are exempt.
OPT-0108	CREATE_ORDER_DUPLICATE_ORDER_ID	`400`	An order with the same `orderId` already exists. Only an `orderId` you choose on Create Order can collide.

cancelOrder

Error Code	Error Slug	Server Status Code	Meaning
OPT-0201	CANCEL_ORDER_NOT_OWNED	`400`	The order belongs to another account.

modifyOrder

Error Code	Error Slug	Server Status Code	Meaning
OPT-0301	MODIFY_ORDER_INSUFFICIENT_BALANCE	`400`	Available balance does not cover the modified order’s initial margin and fee.
OPT-0302	MODIFY_ORDER_MARGIN_RATIO_EXCEEDED	`400`	Your short exposure already uses too much of your collateral for the modified order to fit.
OPT-0303	MODIFY_ORDER_MAX_OPEN_ORDERS	`400`	The modified order would exceed the per-contract open-orders cap.
OPT-0304	MODIFY_ORDER_SELF_TRADE	`400`	The modified order would match one of your own resting orders.
OPT-0305	MODIFY_ORDER_WOULD_MATCH	`400`	The modified `postOnly` price would take liquidity.
OPT-0306	MODIFY_ORDER_REDUCE_ONLY	`400`	The modified `reduceOnly` order exceeds what your position can close, or there is no position.
OPT-0307	MODIFY_ORDER_MIN_VALUE	`400`	Price times quantity is below the $10 minimum. Reduce-only orders are exempt.
OPT-0308	MODIFY_ORDER_NOT_OWNED	`400`	The resting order belongs to another account.
OPT-0309	MODIFY_ORDER_QUANTITY_BELOW_FILLED	`400`	The new quantity is below what has already filled.

A refused modify leaves the original order unchanged.

cancelAllOrders

A sweep is refused only with OPT-0005, OPT-0006 or OPT-0007, and a refused sweep cancels nothing. The cancels a sweep expands into report as cancelOrder with the codes above; an order that fills before its cancel reports OPT-0004.

Shared Codes

The order routes also answer with these codes from the Error Reference:

Error Code	Error Slug	Server Status Code	Meaning on the Options order routes
SYS-0006	BAD_REQUEST	`400`	A field is missing or invalid: no `market`, a quantity that is not positive or not a multiple of the contract’s `lotSize`, a price that is not positive or is finer than the tick size, `postOnly` on a market order, `maxSlippage` out of range or on a limit order, an unsupported time in force, or a request that does not parse. `body` names the problem.
SYS-0014	TRADING_DISABLED	`400`	Your account is not in the `active` state.

A snapshot request (emit*) that fails answers under its response resultType with SYS-0006 for a pageToken it cannot read, or SYS-0002 SERVER_ERROR otherwise. A snapshot changes nothing, so sending it again is safe.

Guides

Formulas

Go SDK

WebSocket API Reference

HTTP API Reference

Any Order Command

createOrder

cancelOrder

modifyOrder

cancelAllOrders

Shared Codes

​Any Order Command

​createOrder

​cancelOrder

​modifyOrder

​cancelAllOrders

​Shared Codes

Any Order Command

createOrder

cancelOrder

modifyOrder

cancelAllOrders

Shared Codes