General Info
This module documents the Stock Option Trading REST API. Base URL, HMAC / Ed25519 signing,
timestamps, recvWindow, and the SAPI error envelope are identical to other SAPI endpoint families
— see the root General Info for those.
This page lists only what is specific to the Stock Option Trading module.
Enabling Options
There is no API for account opening. Enable option trading in the Binance App first; orders and
exercise requests from an account without options enabled are rejected with 497203.
Rate Limits
In addition to the shared SAPI weight / IP limits, the following endpoint carries a per-UID request-rate cap:
| Endpoint | Limit |
|---|---|
POST /order/place | 200 requests / min (UID) |
Other endpoints (market data, queries, cancel, cancel-all, exercise, listenKey) have no separate per-UID cap.
When the per-UID cap is exceeded, HTTP 429 is returned:
Code
The limit is counted per minute and resets in the next window.
Stock option and stock endpoints also share a global upstream broker limit. When it is reached,
Place Option Order and Submit Option Exercise return 497301. For orders, retry with the same
clientOrderId (see Error Code).
Request Security
| Security type | Endpoints |
|---|---|
MARKET_DATA | Option Expirations, Option Contracts, Option Exchange Info |
TRADE | Place Option Order, Cancel Option Order, Cancel All Option Orders, Submit Option Exercise |
USER_DATA | Order, trade, position, exercise and settlement event queries |
USER_STREAM | Create / Renew Listen Key |
MARKET_DATA endpoints only require the X-MBX-APIKEY header; no signature, timestamp or
recvWindow is needed.
Submit Option Exercise requires TRADE rather than USER_DATA, because exercising changes
positions and balances.
URL Prefix
All endpoints in this module share the prefix:
Code
There is no /sapi/v1/bstocks/option/ alias.
Numbers and Timestamps
- Decimal fields are returned as strings in REST responses, with trailing zeros removed:
1.50is returned as"1.5",148.00as"148". Parse them as decimal strings; do not convert to floating point before comparing. Integer fields (e.g.contractSize,tranId, the pagingtotal, timestamps) are JSON numbers. The user data stream pushes JSON numbers instead (see WebSocket Streams General Info). - Empty fields are omitted rather than returned as
null. Fields documented as "not returned when ..." or "returned only when ..." follow this rule. - Time fields (
*Time,*At,settlementDate) are millisecond timestamps (integers). expirationDate: Option Expirations and Option Contracts return aYYYY-MM-DDstring. All other endpoints, including theedfield of the user data stream, return the millisecond timestamp of 12:00 ET on the expiration day. Convert it in theAmerica/New_Yorktime zone and take the date part. Converting in UTC gives the same date, but time zones at UTC+8 or further east (during US daylight saving time) / UTC+7 or further east (during US standard time) read it as the next day. It is not the expiration moment; the expiration moment is the market close (seeoptionsLateClosein Option Exchange Info).
Quote Asset
- Prices are in USD. USDC
is 1:1, and orders are paid in USDConly. quoteAssetdefaults toUSDC; other values are rejected with497104.
No Market Data
No option market data is provided, including but not limited to last price, previous close, best bid / ask and size, mark price, volume, open interest, implied volatility, Greeks (delta / gamma / theta / vega) and break-even price. The Market Data endpoints return contract reference data only.
Order Constraints
- Limit orders only: there is no
orderTypeparameter; every order isLIMIT. Query endpoints may return orders withorderType=MARKET: these are automatic liquidations by the broker on the expiration date, executed as market orders (autoLiquidation=truein Option Order History / Option Order Detail). timeInForceisDAYonly.- Whole contracts only: fractional contracts are not supported.
- Fees are calculated by the server: the premium and all fees are calculated and locked at placement. Callers do not and cannot pass payment details.
- Price checks: a limit price must be a multiple of
tickSize; the order notional (price×quantity×multiplier, excluding fees) must fall within[minNotional, maxNotional](inclusive) from Option Exchange Info; the limit price of aSELLput order must not exceed the strike price.