Place Option Order (TRADE)
Place an option limit order.
The server calculates the amount to lock based on positionIntent and the contract type: buy to open locks the premium plus fees; sell to open locks the underlying shares for a covered call, or the strike-equivalent cash for a cash-secured put. Fees are calculated by the server; callers do not pass payment details.
positionIntent: may be omitted, in which case it is derived from side: BUY → BUY_TO_OPEN, SELL → SELL_TO_CLOSE. The derivation is unreliable in two cases, and an order without positionIntent is rejected (parameter error): a BUY while you hold a short position in the contract (it may be meant as BUY_TO_CLOSE), and a SELL while you hold no long position in the contract (it can only be SELL_TO_OPEN). Therefore always pass it for the short side (SELL_TO_OPEN / BUY_TO_CLOSE). When passed, it must match side (BUY_* with BUY, SELL_* with SELL), otherwise the order is rejected.
Only LIMIT orders with timeInForce = DAY are supported, and quantity must be a whole number of contracts.
Resubmitting with the same clientOrderId is idempotent: if the original order was accepted or is still processing, the original order is returned (S / P); if the original order failed, 497401 is returned.
If the request returns 497001, 497301 or a broker-rejection error code after the order has already been submitted to the broker, the order may still be processing. Retry with the same clientOrderId (a replay then returns P) or query Option Order Detail by clientOrderId for the final status. Do not retry with a new clientOrderId.
Rate limit: 200 requests / min (UID).
Place Option Order (TRADE) › Authorization
Place Option Order (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
symbolOCC contract symbol.
sideBUY / SELL.
quantityNumber of contracts. Must be a whole number, minimum 1.
priceLimit price (premium) per share, minimum 0.01, must be a multiple of tickSize. For a put SELL order it cannot exceed the strike price (497438).
timestampTimestamp in milliseconds.
quoteAssetQuote asset. Only USDC (default) is supported; other values return 497104.
positionIntentMay be omitted and derived from side (BUY → BUY_TO_OPEN, SELL → SELL_TO_CLOSE); always pass it for the short side (SELL_TO_OPEN / BUY_TO_CLOSE). Must match side when passed.
timeInForceOnly DAY (default) is supported. Other values return a parameter error.
walletTypePayment wallet: CARD (default) / MAIN.
clientOrderIdClient order ID. Format ^[a-zA-Z0-9-_]{32,36}$. Generated by the server when omitted.
recvWindowThe value cannot be greater than 60000.
Place Option Order (TRADE) › Responses
Place Option Order
statusS = accepted; P = processing. A failed order is always returned as an error code (see Error Code); a successful response never carries a failed status.
orderIdOption order ID. Omitted when status = P; query Option Order Detail by clientOrderId instead.
clientOrderIdEchoes the supplied or server-generated client order ID.
Cancel Option Order (TRADE)
Cancel an open order by orderId.
Cancellation applies to the caller's own brokerage account and is not restricted by asset class: passing the orderId of a stock order also cancels it, and /sapi/v1/equity/order/cancel can likewise cancel option orders. Only the caller's own orders can be canceled.
Errors on this endpoint use the Stocks Trading error codes (486xxx). See Stocks Trading Error Code.
Cancel Option Order (TRADE) › Authorization
Cancel Option Order (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
orderIdOption order ID.
timestampTimestamp in milliseconds.
recvWindowThe value cannot be greater than 60000.
Cancel Option Order (TRADE) › Responses
Cancel Option Order
orderIdEchoes the order ID in the request.
statusAlways S, meaning the cancel request was accepted upstream. A failed cancellation (e.g. order not found or already filled) is returned as an error code (486xxx).
Cancel All Option Orders (TRADE)
Cancel all of the caller's open orders.
This also cancels open stock orders. Cancel-all is account-level at the broker and does not distinguish asset classes; it is the same operation as /sapi/v1/equity/order/cancel-all.
To cancel option orders only, fetch them with Current Open Option Orders and cancel each one with Cancel Option Order.
Errors on this endpoint use the Stocks Trading error codes (486xxx). See Stocks Trading Error Code.
Cancel All Option Orders (TRADE) › Authorization
Cancel All Option Orders (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
timestampTimestamp in milliseconds.
recvWindowThe value cannot be greater than 60000.
Cancel All Option Orders (TRADE) › Responses
Cancel All Option Orders
successtrue if the cancel-all request was accepted upstream. Individual orders may still fail to cancel (e.g. already filled); check with Current Open Option Orders.
Submit Option Exercise (TRADE)
Submit an exercise request for a long option position.
Requires the TRADE permission, because exercising changes positions and balances.
Exercise is asynchronous. The request returns PROCESSING; delivery is handled by the broker. Poll Option Exercise Detail for the final status.
quantity cannot exceed availableQty from Exercisable Options.
Resubmitting with the same clientOrderId is idempotent: if the original exercise was accepted or is still processing, it is returned with its current status; if it failed, 497401 is returned. If the request returns 497001, 497301 or a broker-rejection error code, the exercise may still be processing: retry with the same clientOrderId or query Option Exercise Detail by clientOrderId. Do not resubmit with a new clientOrderId.
Submit Option Exercise (TRADE) › Authorization
Submit Option Exercise (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
symbolOCC contract symbol to exercise.
quantityNumber of contracts to exercise. Whole number, minimum 1, up to availableQty.
timestampTimestamp in milliseconds.
quoteAssetQuote asset. Only USDC (default) is supported; other values return 497104.
clientOrderIdClient ID. Format ^[a-zA-Z0-9-_]{32,36}$. Generated by the server when omitted.
recvWindowThe value cannot be greater than 60000.
Submit Option Exercise (TRADE) › Responses
Submit Option Exercise
tranIdExercise transaction ID; use it to query Option Exercise Detail.
clientOrderIdEchoes the supplied or server-generated client ID.
statusPROCESSING on a first successful submission. When replayed with the same clientOrderId, the current status of the original exercise (PROCESSING / SUCCESS) is returned.