Market Data

Endpoint

Download schema

Check Server Time

Test connectivity to the Rest API and get the current server time.

GET

/eapi/v1/time

https://eapi.binance.com

Check Server Time › 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.

IP Weight1

Check Server Time › Responses

200

Check Server Time

serverTime

integer · int64

server Time

Example: 1592387156596

Exchange Information

Current exchange trading rules and symbol information

GET

/eapi/v1/exchangeInfo

https://eapi.binance.com

Exchange Information › 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.

IP Weight1

Exchange Information › Responses

200

Exchange Information

timezone

string

Time zone used by the server

Example: UTC

serverTime

integer · int64

Current system time

Example: 1592387337630

object[]

Option contract underlying asset info

baseAsset

string

Base currency

Example: BTC

quoteAsset

string

Quotation asset

Example: USDT

underlying

string

Name of the underlying asset of the option contract

Example: BTCUSDT

settleAsset

string

Settlement currency

Example: USDT

object[]

Option asset info

name

string

Asset name

Example: USDT

object[]

Option trading pair info

expiryDate

integer · int64

expiry time

Example: 1660521600000

object[]

filters

filterType

string

filter Type

Example: PRICE_FILTER

minPrice

string

min Price

Example: 0.02

maxPrice

string

max Price

Example: 80000.01

tickSize

string

tick Size

Example: 0.01

minQty

string

Minimum order quantity

Example: 0.01

maxQty

string

Maximum order quantity

Example: 100

stepSize

string

step Size

Example: 0.01

symbol

string

Trading pair name

Example: BTC-220815-50000-C

side

string

Direction: CALL long, PUT short

Example: CALL

strikePrice

string

Strike price

Example: 50000

underlying

string

Name of the underlying asset of the option contract

Example: BTCUSDT

unit

integer · int64

Contract unit, the quantity of the underlying asset represented by a single contract.

Example: 1

liquidationFeeRate

string

liquidation fee rate

Example: 0.0019000

minQty

string

Minimum order quantity

Example: 0.01

maxQty

string

Maximum order quantity

Example: 100

initialMargin

string

Initial Magin Ratio

Example: 0.15

maintenanceMargin

string

Maintenance Margin Ratio

Example: 0.075

minInitialMargin

string

Min Initial Margin Ratio

Example: 0.1

minMaintenanceMargin

string

Min Maintenance Margin Ratio

Example: 0.05

priceScale

integer · int64

price precision

Example: 2

quantityScale

integer · int64

quantity precision

Example: 2

quoteAsset

string

Quotation asset

Example: USDT

contractType

string

Contract type

Example: CRYPTO_OPTIONS

underlyingType

string

Underlying type

Example: CRYPTO

nakedSell

boolean

Whether naked selling is allowed for this symbol

Example: false

status

string

Trading Status

Example: TRADING

object[]

rate Limits

rateLimitType

string

rate Limit Type

Example: REQUEST_WEIGHT

interval

string

interval

Example: MINUTE

intervalNum

integer · int64

interval Num

Example: 1

limit

integer · int64

limit

Example: 2400

GET/eapi/v1/exchangeInfo

curl --request GET \
  --url https://eapi.binance.com/eapi/v1/exchangeInfo

Example Responses

{
  "timezone": "UTC",
  "serverTime": 1592387337630,
  "optionContracts": [
    {
      "baseAsset": "BTC",
      "quoteAsset": "USDT",
      "underlying": "BTCUSDT",
      "settleAsset": "USDT"
    }
  ],
  "optionAssets": [
    {
      "name": "USDT"
    }
  ],
  "optionSymbols": [
    {
      "expiryDate": 1660521600000,
      "filters": [
        {
          "filterType": "PRICE_FILTER",
          "minPrice": "0.02",
          "maxPrice": "80000.01",
          "tickSize": "0.01",
          "minQty": "0.01",
          "maxQty": "100",
          "stepSize": "0.01"
        }
      ],
      "symbol": "BTC-220815-50000-C",
      "side": "CALL",
      "strikePrice": "50000",
      "underlying": "BTCUSDT",
      "unit": 1,
      "liquidationFeeRate": "0.0019000",
      "minQty": "0.01",
      "maxQty": "100",
      "initialMargin": "0.15",
      "maintenanceMargin": "0.075",
      "minInitialMargin": "0.1",
      "minMaintenanceMargin": "0.05",
      "priceScale": 2,
      "quantityScale": 2,
      "quoteAsset": "USDT",
      "contractType": "CRYPTO_OPTIONS",
      "underlyingType": "CRYPTO",
      "nakedSell": false,
      "status": "TRADING"
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 2400
    }
  ]
}

json

application/json

Historical Exercise Records

Get historical exercise records.

REALISTIC_VALUE_STRICKEN -> Exercised
EXTRINSIC_VALUE_EXPIRED -> Expired OTM

GET

/eapi/v1/exerciseHistory

https://eapi.binance.com

Historical Exercise Records › 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.

IP Weight3

Historical Exercise Records › Query Parameters

underlying

string

Underlying asset.

Example: BTCUSDT

startTime

integer · int64

Start Time, e.g 1593511200000

Example: 1623319461670

endTime

integer · int64

End Time, e.g 1593512200000

Example: 1641782889000

limit

integer · int64 · max: 100

Number of result sets returned

Example: 20

Default: 100

Historical Exercise Records › Responses

200

Historical Exercise Records

object

symbol

string

symbol

Example: BTC-220121-60000-P

strikePrice

string

strike price

Example: 60000

realStrikePrice

string

real strike price

Example: 38844.69652571

expiryDate

integer · int64

Exercise time

Example: 1642752000000

strikeResult

string

strike result

Example: REALISTIC_VALUE_STRICKEN

Index Price

Get spot index price for option underlying.

GET

/eapi/v1/index

https://eapi.binance.com

Index Price › 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.

IP Weight1

Index Price › Query Parameters

underlying

string · required

Underlying asset.

Example: BTCUSDT

Index Price › Responses

200

Index Price

time

integer · int64

time

Example: 1656647305000

indexPrice

string

index Price

Example: 105917.75

Kline/Candlestick Data

Kline/candlestick bars for an option symbol. Klines are uniquely identified by their open time.

GET

/eapi/v1/klines

https://eapi.binance.com

Kline/Candlestick Data › 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.

IP Weight1

Kline/Candlestick Data › Query Parameters

symbol

string · required

Option trading pair

Example: BTC-200730-9000-C

interval

string · enum · required

Time interval

Enum values:

15m

30m

Example: 1m

startTime

integer · int64

Start Time, e.g 1593511200000

Example: 1623319461670

endTime

integer · int64

End Time, e.g 1593512200000

Example: 1641782889000

limit

integer · int64 · max: 1500

Number of result sets returned

Example: 20

Default: 500

Kline/Candlestick Data › Responses

200

Kline/Candlestick Data

array[]

tuple[12] · minItems: 12 · maxItems: 12

[0]

integer · int64 · required

Open time

Example: 1762779600000

[1]

string · required

Open

Example: 1300.000

[2]

string · required

High

Example: 1300.000

[3]

string · required

Low

Example: 1300.000

[4]

string · required

Example: 1300.000

[5]

string · required

Volume

Example: 0.1000

[6]

integer · int64 · required

Close time

Example: 1762780499999

[7]

string · required

Quote asset volume

Example: 130.0000000

[8]

integer · required

Number of trades

Example: 1

[9]

string · required

Taker buy base asset volume

Example: 0.1000

[10]

string · required

Taker buy quote asset volume

Example: 130.0000000

[11]

string · required

Ignore

Example: 0

Open Interest

Get open interest for specific underlying asset on specific expiration date.

GET

/eapi/v1/openInterest

https://eapi.binance.com

Open Interest › 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.

IP Weight0

Open Interest › Query Parameters

underlyingAsset

string · required

Underlying asset.

Example: ETH/BTC

expiration

string · required

expiration date

Example: 221225

Open Interest › Responses

200

Open Interest

object

symbol

string

symbol

Example: ETH-221119-1175-P

sumOpenInterest

string

sum Open Interest

Example: 4.01

sumOpenInterestUsd

string

sum Open Interest Usd

Example: 4880.2985615624

timestamp

string

timestamp

Example: 1668754020000

Option Mark Price

Option mark price and greek info.

GET

/eapi/v1/mark

https://eapi.binance.com

Option Mark Price › 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.

IP Weight5

Option Mark Price › Query Parameters

symbol

string

Option trading pair

Example: BTC-200730-9000-C

Option Mark Price › Responses

200

Option Mark Price

object

symbol

string

symbol

Example: BTC-200730-9000-C

markPrice

string

Mark price

Example: 1343.2883

bidIV

string

Implied volatility Buy

Example: 1.40000077

askIV

string

Implied volatility Sell

Example: 1.50000153

markIV

string

Implied volatility mark

Example: 1.45000000

delta

string

delta

Example: 0.55937056

theta

string

theta

Example: 3739.82509871

gamma

string

gamma

Example: 0.00010969

vega

string

vega

Example: 978.58874732

highPriceLimit

string

Current highest buy price

Example: 1618.241

lowPriceLimit

string

Current lowest sell price

Example: 1068.3356

riskFreeInterest

string

risk free rate

Example: 0.1

Order Book

Check orderbook depth on specific symbol

GET

/eapi/v1/depth

https://eapi.binance.com

Order Book › 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.

IP Weight

limit	weight
5, 10, 20, 50	1
100	5
500	10
1000	20

Order Book › Query Parameters

symbol

string · required

Option trading pair

Example: BTC-200730-9000-C

limit

integer · int64 · max: 1000

Default:100 Max:1000.Optional value:[10, 20, 50, 100, 500, 1000]

Example: 20

Default: 100

Order Book › Responses

200

Order Book

array[]

Bid orders. Each entry is [price, quantity].

Example: [["1000.000","0.1000"]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

string · required

Price

Example: 1000.000

[1]

string · required

Quantity

Example: 0.1000

array[]

Ask orders. Each entry is [price, quantity].

Example: [["1900.000","0.1000"]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

string · required

Price

Example: 1900.000

[1]

string · required

Quantity

Example: 0.1000

T

integer · int64

transaction time

Example: 1762780909676

lastUpdateId

integer · int64

update id

Example: 361

Recent Block Trades List

Get recent block trades

GET

/eapi/v1/blockTrades

https://eapi.binance.com

Recent Block Trades List › 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.

IP Weight5

Recent Block Trades List › Query Parameters

symbol

string

Option trading pair

Example: BTC-200730-9000-C

limit

integer · int64 · max: 500

Number of records

Example: 20

Default: 100

Recent Block Trades List › Responses

200

Recent Block Trades List

object

id

integer · int64

Example: 1125899906901081100

tradeId

integer · int64

trade Id

Example: 389

symbol

string

symbol

Example: ETH-250725-1200-P

price

string

price

Example: 342.40

qty

string

qty

Example: -2167.20

quoteQty

string

quote Qty

Example: -4.90

side

integer · int64

side

Example: -1

time

integer · int64

time

Example: 1733950676483

Recent Trades List

Get recent market trades

GET

/eapi/v1/trades

https://eapi.binance.com

Recent Trades List › 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.

IP Weight5

Recent Trades List › Query Parameters

symbol

string · required

Option trading pair

Example: BTC-200730-9000-C

limit

integer · int64 · max: 500

Number of result sets returned

Example: 20

Default: 100

Recent Trades List › Responses

200

Recent Trades List

object

id

integer · int64

Example: 2323857420768529000

tradeId

integer · int64

TradeId

Example: 1

symbol

string

Option trading pair

Example: BTC-251123-126000-C

price

string

Completed trade price

Example: 1300

qty

string

Completed trade quantity

Example: 0.1

quoteQty

string

Completed trade amount

Example: 130

side

integer · int64

Completed trade direction（-1 Sell，1 Buy）

Example: -1

time

integer · int64

Time

Example: 1762780453623

Test Connectivity

Test connectivity to the Rest API.

GET

/eapi/v1/ping

https://eapi.binance.com

Test Connectivity › 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.

IP Weight1

Test Connectivity › Responses

200

No data returned

24hr Ticker Price Change Statistics

24 hour rolling window price change statistics.

GET

/eapi/v1/ticker

https://eapi.binance.com

24hr Ticker Price Change Statistics › 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.

IP Weight

1 for a single symbol; 40 when the symbol parameter is omitted

24hr Ticker Price Change Statistics › Query Parameters

symbol

string

Option trading pair

Example: BTC-200730-9000-C

24hr Ticker Price Change Statistics › Responses

200

24hr Ticker Price Change Statistics

object

symbol

string

symbol

Example: BTC-200730-9000-C

priceChange

string

24-hour price change

Example: -16.2038

priceChangePercent

string

24-hour percent price change

Example: -0.0162

lastPrice

string

Last trade price

Example: 1000

lastQty

string

Last trade amount

Example: 1000

open

string

24-hour open price

Example: 1016.2038

high

string

24-hour high

Example: 1016.2038

low

string

24-hour low

Example: 0

volume

string

Trading volume(contracts)

Example: 5

amount

string

Trade amount(in quote asset)

Example: 1

bidPrice

string

The best buy price

Example: 999.34

askPrice

string

The best sell price

Example: 1000.23

openTime

integer · int64

Time the first trade occurred within the last 24 hours

Example: 1592317127349

closeTime

integer · int64

Time the last trade occurred within the last 24 hours

Example: 1592380593516

firstTradeId

integer · int64

First trade ID

Example: 1

tradeCount

integer · int64

Number of trades

Example: 5

strikePrice

string

Strike price

Example: 9000

exercisePrice

string

return estimated settlement price one hour before exercise, return index price at other times

Example: 3000.3356