Market

Endpoint

Download schema

Index Price Streams

Underlying(e.g ETHUSDT) index stream.

WSS

!index@arr

wss://fstream.binance.com

Update Speed1000ms

Index Price Streams › Request

You can subscribe to this stream using one of the following options:

Raw stream: wss://fstream.binance.com/market/ws/!index@arr
Combined stream via URL: wss://fstream.binance.com/market/stream?streams=!index@arr
Combined stream via request: Connect to wss://fstream.binance.com/market/stream, then send the SUBSCRIBE request shown below.

method

string · enum · required

WebSocket Streams method name.

Enum values:

Example: SUBSCRIBE

params

string[] · required

List of streams to subscribe to.

Example: ["!index@arr"]

id

integer · int32 · required

Unique WebSocket request ID.

Example: 532601580

Index Price Streams › Responses

Index Price Streams

object

e

string

event type

Example: indexPrice

E

integer · int64

time

Example: 1763092572229

s

string

underlying symbol

Example: ETHUSDT

p

string

index price

Example: 3224.51976744

Kline/Candlestick Streams

The Kline/Candlestick Stream push updates to the current klines/candlestick every 1000 milliseconds (if existing).

WSS

{symbol}@kline_{interval}

wss://fstream.binance.com

Update Speed1000ms

Kline/Candlestick Streams › Stream parameters

symbol

string · required

The symbol parameter

Example: btcusdt

interval

string · enum · required

The interval parameter

Enum values:

15m

30m

Example: 1m

Kline/Candlestick Streams › Request

You can subscribe to this stream using one of the following options:

Raw stream: wss://fstream.binance.com/market/ws/{symbol}@kline_{interval}
Combined stream via URL: wss://fstream.binance.com/market/stream?streams={symbol}@kline_{interval}
Combined stream via request: Connect to wss://fstream.binance.com/market/stream, then send the SUBSCRIBE request shown below.

method

string · enum · required

WebSocket Streams method name.

Enum values:

Example: SUBSCRIBE

params

string[] · required

List of streams to subscribe to.

Example: ["btcusdt@kline_1m"]

id

integer · int32 · required

Unique WebSocket request ID.

Example: 532601580

Kline/Candlestick Streams › Responses

Kline/Candlestick Streams

e

string

event type

Example: kline

E

integer · int64

event time

Example: 1638747660000

s

string

Option trading symbol

Example: BTC-200630-9000-P

object

Option Mark Price

The mark price for all option symbols on specific underlying asset. E.g.btcusdt@optionMarkPrice

WSS

{underlying}@optionMarkPrice

wss://fstream.binance.com

Update Speed1000ms

Option Mark Price › Stream parameters

underlying

string · required

The underlying parameter

Example: btcusdt

Option Mark Price › Request

You can subscribe to this stream using one of the following options:

Raw stream: wss://fstream.binance.com/market/ws/{underlying}@optionMarkPrice
Combined stream via URL: wss://fstream.binance.com/market/stream?streams={underlying}@optionMarkPrice
Combined stream via request: Connect to wss://fstream.binance.com/market/stream, then send the SUBSCRIBE request shown below.

method

string · enum · required

WebSocket Streams method name.

Enum values:

Example: SUBSCRIBE

params

string[] · required

List of streams to subscribe to.

Example: ["btcusdt@optionMarkPrice"]

id

integer · int32 · required

Unique WebSocket request ID.

Example: 532601580

Option Mark Price › Responses

Mark Price

object

s

string

Symbol

Example: BTC-251120-126000-C

mp

string

Mark price

Example: 770.543

E

integer · int64

Event time

Example: 1762867543321

e

string

Event type

Example: markPrice

i

string

Index price

Example: 104334.60217391

P

string

Estimated Settle Price, only useful in the 0.5 hour before the settlement starts

Example: 0.000

bo

string

The best buy price

Example: 0.000

ao

string

The best sell price

Example: 900.000

bq

string

The best buy quantity

Example: 0.0000

aq

string

The best sell quantity

Example: 0.2000

b

string

BuyImplied volatility

Example: -1.0

a

string

SellImplied volatility

Example: 0.98161161

hl

string

Buy Maximum price

Example: 924.652

ll

string

Sell Minimum price

Example: 616.435

vo

string

volatility

Example: 0.9408058

rf

string

risk free rate

Example: 0.0

d

string

delta

Example: 0.11111964

t

string

theta

Example: -164.26702615

g

string

gamma

Example: 0.00001245

v

string

vega

Example: 30.63855919

WSS{underlying}@optionMarkPrice

wscat -c wss://fstream.binance.com//market/stream -x '{
  "method": "SUBSCRIBE",
  "params": [
    "btcusdt@optionMarkPrice"
  ],
  "id": 532601580
}' -w 30

Example Request

{
  "method": "SUBSCRIBE",
  "params": [
    "btcusdt@optionMarkPrice"
  ],
  "id": 532601580
}

json

application/json

Example Responses

[
  {
    "s": "BTC-251120-126000-C",
    "mp": "770.543",
    "E": 1762867543321,
    "e": "markPrice",
    "i": "104334.60217391",
    "P": "0.000",
    "bo": "0.000",
    "ao": "900.000",
    "bq": "0.0000",
    "aq": "0.2000",
    "b": "-1.0",
    "a": "0.98161161",
    "hl": "924.652",
    "ll": "616.435",
    "vo": "0.9408058",
    "rf": "0.0",
    "d": "0.11111964",
    "t": "-164.26702615",
    "g": "0.00001245",
    "v": "30.63855919"
  }
]

json

application/json

New Symbol Info

New symbol listing stream.

WSS

!optionSymbol

wss://fstream.binance.com

Update Speed50ms

New Symbol Info › Request

You can subscribe to this stream using one of the following options:

Raw stream: wss://fstream.binance.com/market/ws/!optionSymbol
Combined stream via URL: wss://fstream.binance.com/market/stream?streams=!optionSymbol
Combined stream via request: Connect to wss://fstream.binance.com/market/stream, then send the SUBSCRIBE request shown below.

method

string · enum · required

WebSocket Streams method name.

Enum values:

Example: SUBSCRIBE

params

string[] · required

List of streams to subscribe to.

Example: ["!optionSymbol"]

id

integer · int32 · required

Unique WebSocket request ID.

Example: 532601580

New Symbol Info › Responses

New Symbol Info

e

string

Event Type

Example: optionSymbol

E

integer · int64

Event Time

Example: 1669356423908

s

string

Symbol

Example: BTC-250926-140000-C

ps

string

Underlying index of the contract

Example: BTCUSDT

qa

string

Quotation asset

Example: USDT

d

string

Option type

Example: CALL

sp

string

Strike price

Example: 21000

dt

integer · int64

Delivery date time

Example: 4133404800000

u

integer · int64

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

Example: 1

ot

integer · int64

onboard date time

Example: 1569398400000

cs

string

Contract status

Example: TRADING

Open Interest

Option open interest for specific underlying asset on specific expiration date. E.g.ethusdt@openInterest@221125

WSS

{underlying}@openInterest@{expirationDate}

wss://fstream.binance.com

Update Speed60s

Open Interest › Stream parameters

underlying

string · required

The underlying parameter

Example: btcusdt

expirationDate

string · required

The expirationDate parameter

Example: 220930

Open Interest › Request

You can subscribe to this stream using one of the following options:

Raw stream: wss://fstream.binance.com/market/ws/{underlying}@openInterest@{expirationDate}
Combined stream via URL: wss://fstream.binance.com/market/stream?streams={underlying}@openInterest@{expirationDate}
Combined stream via request: Connect to wss://fstream.binance.com/market/stream, then send the SUBSCRIBE request shown below.

method

string · enum · required

WebSocket Streams method name.

Enum values:

Example: SUBSCRIBE

params

string[] · required

List of streams to subscribe to.

Example: ["btcusdt@openInterest@220930"]

id

integer · int32 · required

Unique WebSocket request ID.

Example: 532601580

Open Interest › Responses

Open Interest

object

e

string

Event type

Example: openInterest

E

integer · int64

Event time

Example: 1668759300045

s

string

Option symbol

Example: ETH-221125-2700-C

o

string

Open interest in contracts

Example: 1580.87

h

string

Open interest in USDT

Example: 1912992.178168204

Market

Endpoint

Download schema

Index Price Streams

Underlying(e.g ETHUSDT) index stream.

WSS

!index@arr

wss://fstream.binance.com

Update Speed1000ms

Index Price Streams › Request

You can subscribe to this stream using one of the following options:

Raw stream: wss://fstream.binance.com/market/ws/!index@arr
Combined stream via URL: wss://fstream.binance.com/market/stream?streams=!index@arr
Combined stream via request: Connect to wss://fstream.binance.com/market/stream, then send the SUBSCRIBE request shown below.

method

string · enum · required

WebSocket Streams method name.

Enum values:

Example: SUBSCRIBE

params

string[] · required

List of streams to subscribe to.

Example: ["!index@arr"]

id

integer · int32 · required

Unique WebSocket request ID.

Example: 532601580

Index Price Streams › Responses

Index Price Streams

object

e

string

event type

Example: indexPrice

E

integer · int64

time

Example: 1763092572229

s

string

underlying symbol

Example: ETHUSDT

p

string

index price

Example: 3224.51976744

Kline/Candlestick Streams

The Kline/Candlestick Stream push updates to the current klines/candlestick every 1000 milliseconds (if existing).

WSS

{symbol}@kline_{interval}

wss://fstream.binance.com

Update Speed1000ms

Kline/Candlestick Streams › Stream parameters

symbol

string · required

The symbol parameter

Example: btcusdt

interval

string · enum · required

The interval parameter

Enum values:

15m

30m

Example: 1m

Kline/Candlestick Streams › Request

You can subscribe to this stream using one of the following options:

Raw stream: wss://fstream.binance.com/market/ws/{symbol}@kline_{interval}
Combined stream via URL: wss://fstream.binance.com/market/stream?streams={symbol}@kline_{interval}
Combined stream via request: Connect to wss://fstream.binance.com/market/stream, then send the SUBSCRIBE request shown below.

method

string · enum · required

WebSocket Streams method name.

Enum values:

Example: SUBSCRIBE

params

string[] · required

List of streams to subscribe to.

Example: ["btcusdt@kline_1m"]

id

integer · int32 · required

Unique WebSocket request ID.

Example: 532601580

Kline/Candlestick Streams › Responses

Kline/Candlestick Streams

e

string

event type

Example: kline

E

integer · int64

event time

Example: 1638747660000

s

string

Option trading symbol

Example: BTC-200630-9000-P

object

Option Mark Price

The mark price for all option symbols on specific underlying asset. E.g.btcusdt@optionMarkPrice

WSS

{underlying}@optionMarkPrice

wss://fstream.binance.com

Update Speed1000ms

Option Mark Price › Stream parameters

underlying

string · required

The underlying parameter

Example: btcusdt

Option Mark Price › Request

You can subscribe to this stream using one of the following options:

Raw stream: wss://fstream.binance.com/market/ws/{underlying}@optionMarkPrice
Combined stream via URL: wss://fstream.binance.com/market/stream?streams={underlying}@optionMarkPrice
Combined stream via request: Connect to wss://fstream.binance.com/market/stream, then send the SUBSCRIBE request shown below.

method

string · enum · required

WebSocket Streams method name.

Enum values:

Example: SUBSCRIBE

params

string[] · required

List of streams to subscribe to.

Example: ["btcusdt@optionMarkPrice"]

id

integer · int32 · required

Unique WebSocket request ID.

Example: 532601580

Option Mark Price › Responses

Mark Price

object

s

string

Symbol

Example: BTC-251120-126000-C

mp

string

Mark price

Example: 770.543

E

integer · int64

Event time

Example: 1762867543321

e

string

Event type

Example: markPrice

i

string

Index price

Example: 104334.60217391

P

string

Estimated Settle Price, only useful in the 0.5 hour before the settlement starts

Example: 0.000

bo

string

The best buy price

Example: 0.000

ao

string

The best sell price

Example: 900.000

bq

string

The best buy quantity

Example: 0.0000

aq

string

The best sell quantity

Example: 0.2000

b

string

BuyImplied volatility

Example: -1.0

a

string

SellImplied volatility

Example: 0.98161161

hl

string

Buy Maximum price

Example: 924.652

ll

string

Sell Minimum price

Example: 616.435

vo

string

volatility

Example: 0.9408058

rf

string

risk free rate

Example: 0.0

d

string

delta

Example: 0.11111964

t

string

theta

Example: -164.26702615

g

string

gamma

Example: 0.00001245

v

string

vega

Example: 30.63855919

WSS{underlying}@optionMarkPrice

wscat -c wss://fstream.binance.com//market/stream -x '{
  "method": "SUBSCRIBE",
  "params": [
    "btcusdt@optionMarkPrice"
  ],
  "id": 532601580
}' -w 30

Example Request

{
  "method": "SUBSCRIBE",
  "params": [
    "btcusdt@optionMarkPrice"
  ],
  "id": 532601580
}

json

application/json

Example Responses

[
  {
    "s": "BTC-251120-126000-C",
    "mp": "770.543",
    "E": 1762867543321,
    "e": "markPrice",
    "i": "104334.60217391",
    "P": "0.000",
    "bo": "0.000",
    "ao": "900.000",
    "bq": "0.0000",
    "aq": "0.2000",
    "b": "-1.0",
    "a": "0.98161161",
    "hl": "924.652",
    "ll": "616.435",
    "vo": "0.9408058",
    "rf": "0.0",
    "d": "0.11111964",
    "t": "-164.26702615",
    "g": "0.00001245",
    "v": "30.63855919"
  }
]

json

application/json

New Symbol Info

New symbol listing stream.

WSS

!optionSymbol

wss://fstream.binance.com

Update Speed50ms

New Symbol Info › Request

You can subscribe to this stream using one of the following options:

Raw stream: wss://fstream.binance.com/market/ws/!optionSymbol
Combined stream via URL: wss://fstream.binance.com/market/stream?streams=!optionSymbol
Combined stream via request: Connect to wss://fstream.binance.com/market/stream, then send the SUBSCRIBE request shown below.

method

string · enum · required

WebSocket Streams method name.

Enum values:

Example: SUBSCRIBE

params

string[] · required

List of streams to subscribe to.

Example: ["!optionSymbol"]

id

integer · int32 · required

Unique WebSocket request ID.

Example: 532601580

New Symbol Info › Responses

New Symbol Info

e

string

Event Type

Example: optionSymbol

E

integer · int64

Event Time

Example: 1669356423908

s

string

Symbol

Example: BTC-250926-140000-C

ps

string

Underlying index of the contract

Example: BTCUSDT

qa

string

Quotation asset

Example: USDT

d

string

Option type

Example: CALL

sp

string

Strike price

Example: 21000

dt

integer · int64

Delivery date time

Example: 4133404800000

u

integer · int64

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

Example: 1

ot

integer · int64

onboard date time

Example: 1569398400000

cs

string

Contract status

Example: TRADING

Open Interest

Option open interest for specific underlying asset on specific expiration date. E.g.ethusdt@openInterest@221125

WSS

{underlying}@openInterest@{expirationDate}

wss://fstream.binance.com

Update Speed60s

Open Interest › Stream parameters

underlying

string · required

The underlying parameter

Example: btcusdt

expirationDate

string · required

The expirationDate parameter

Example: 220930

Open Interest › Request

You can subscribe to this stream using one of the following options:

Raw stream: wss://fstream.binance.com/market/ws/{underlying}@openInterest@{expirationDate}
Combined stream via URL: wss://fstream.binance.com/market/stream?streams={underlying}@openInterest@{expirationDate}
Combined stream via request: Connect to wss://fstream.binance.com/market/stream, then send the SUBSCRIBE request shown below.

method

string · enum · required

WebSocket Streams method name.

Enum values:

Example: SUBSCRIBE

params

string[] · required

List of streams to subscribe to.

Example: ["btcusdt@openInterest@220930"]

id

integer · int32 · required

Unique WebSocket request ID.

Example: 532601580

Open Interest › Responses

Open Interest

object

e

string

Event type

Example: openInterest

E

integer · int64

Event time

Example: 1668759300045

s

string

Option symbol

Example: ETH-221125-2700-C

o

string

Open interest in contracts

Example: 1580.87

h

string

Open interest in USDT

Example: 1912992.178168204