Introduction
Stock Option Trading — trade US-listed stock options with crypto.
The Stock Option Trading API lets you look up option contracts, place and cancel option orders,
exercise long positions, and query positions, orders, fills and settlement events through the SAPI
endpoint family. All endpoints live under the /sapi/v1/equity/option/* prefix.
Before You Start
Option trading must be enabled in the Binance App before calling these endpoints. Enabling it
includes an investor profile questionnaire, an options knowledge test, and acceptance of the
required agreements and risk disclosures. There is no API for account opening. Orders and exercise
requests from an account without options enabled are rejected with 497203.
What's Included
| Group | 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 | Current Open Option Orders, Option Order History, Option Order Detail, Option Trade History, Option Positions, Exercisable Options, Option Exercise Detail, Option Exercise History, Option Settlement Event History, Option Settlement Event Detail |
| User Data Streams | Listen Key, Order Report V2 |
Defaults and Conventions
- Base URL: same as other SAPI endpoints (see root General Info).
- URL prefix:
/sapi/v1/equity/option/*. - Symbol: the OCC option contract symbol, e.g.
NVDA260930C00100000. Parameters that filter by underlying are namedunderlyingSymboland take the stock ticker, e.g.NVDA. - Quote asset: prices are in USD; orders are paid in
USDConly (USDC1:1). - Order type: limit orders only,
timeInForce = DAY, whole contracts only. - No market data: no option prices, quotes, Greeks or implied volatility are provided. The Market Data endpoints return contract reference data only.
- Signing: same HMAC / Ed25519 scheme as other SAPI endpoints.
MARKET_DATAendpoints need only theX-MBX-APIKEYheader and are not signed.
See General Info for rate limits and data formats, and Common Definition for contract symbols, contract status and position intent.