Futures (COIN-M) WebSocket Market Streams

Endpoint

Aggregate Trade Streams

The Aggregate Trade Streams push market trade information that is aggregated for fills with same price and taking side every 100 milliseconds.

After CM migration, the payload is appended with a new st field (1 = UM, 2 = CM).

WSS

{symbol}@aggTrade

wss://dstream.binance.com

Update Speed100ms

Aggregate Trade Streams › Stream parameters

symbol

string · required

The symbol parameter

Example: btcusdt

Aggregate Trade Streams › Request

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

Raw stream: wss://dstream.binance.com/ws/{symbol}@aggTrade
Combined stream via URL: wss://dstream.binance.com/stream?streams={symbol}@aggTrade
Combined stream via request: Connect to wss://dstream.binance.com/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@aggTrade"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Aggregate Trade Streams › Responses

Aggregate Trade Streams

e

string · enum

Event type

Enum values:

aggTrade

Example: aggTrade

E

integer · int64

Event time

Example: 1591261134288

a

integer · int64

Aggregate trade ID

Example: 424951

s

string

Symbol

Example: BTCUSD_200626

p

string

Price

Example: 9643.5

q

string

Quantity

Example: 2

f

integer · int64

First trade ID

Example: 606073

l

integer · int64

Last trade ID

Example: 606073

T

integer · int64

Trade time

Example: 1591261134199

m

boolean

Is the buyer the market maker?

Example: false

st

integer

(After CM migration) Symbol type: 1 = UM, 2 = CM

Example: 1

All Book Tickers Stream

Pushes any update to the best bid or ask's price or quantity in real-time for all symbols.

After CM migration, this stream pushes the merged UM + CM universe (subscribable on both fstream and dstream); each payload is appended with a new st field (1 = UM, 2 = CM).

WSS

!bookTicker

wss://dstream.binance.com

Update SpeedReal-time

All Book Tickers Stream › Request

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

Raw stream: wss://dstream.binance.com/ws/!bookTicker
Combined stream via URL: wss://dstream.binance.com/stream?streams=!bookTicker
Combined stream via request: Connect to wss://dstream.binance.com/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: ["!bookTicker"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

All Book Tickers Stream › Responses

All Book Tickers Stream

e

string · enum

Event type

Enum values:

bookTicker

Example: bookTicker

u

integer · int64

Order book update Id

Example: 17242169

s

string

Symbol

Example: BTCUSD_200626

b

string

Best bid price

Example: 9548.1

B

string

Best bid qty

Example: 52

a

string

Best ask price

Example: 9548.5

A

string

Best ask qty

Example: 11

T

integer · int64

Transaction time

Example: 1591268628155

E

integer · int64

Event time

Example: 1591268628166

ps

string

Pair

Example: BTCUSD

st

integer

(After CM migration) Symbol type: 1 = UM, 2 = CM

Example: 1

All Market Liquidation Order Streams

The All Liquidation Order Snapshot Streams push force liquidation order information for all symbols in the market. For each symbol，only the latest one liquidation order within 1000ms will be pushed as the snapshot. If no liquidation happens in the interval of 1000ms, no stream will be pushed.

After CM migration, this stream pushes the merged UM + CM universe (subscribable on both fstream and dstream); each payload is appended with a new st field (1 = UM, 2 = CM).

WSS

!forceOrder@arr

wss://dstream.binance.com

Update Speed1000ms

All Market Liquidation Order Streams › Request

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

Raw stream: wss://dstream.binance.com/ws/!forceOrder@arr
Combined stream via URL: wss://dstream.binance.com/stream?streams=!forceOrder@arr
Combined stream via request: Connect to wss://dstream.binance.com/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: ["!forceOrder@arr"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

All Market Liquidation Order Streams › Responses

All Market Liquidation Order Streams

e

string · enum

Event Type

Enum values:

forceOrder

Example: forceOrder

E

integer · int64

Event Time

Example: 1591154240950

object

Order Type

st

integer

(After CM migration) Symbol type: 1 = UM, 2 = CM

Example: 1

All Market Mini Tickers Stream

24hr rolling window mini-ticker statistics for all symbols. These are NOT the statistics of the UTC day, but a 24hr rolling window from requestTime to 24hrs before. Note that only tickers that have changed will be present in the array.

After CM migration, this stream pushes the merged UM + CM universe (subscribable on both fstream and dstream); each payload is appended with a new st field (1 = UM, 2 = CM).

WSS

!miniTicker@arr

wss://dstream.binance.com

Update Speed1000ms

All Market Mini Tickers Stream › Request

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

Raw stream: wss://dstream.binance.com/ws/!miniTicker@arr
Combined stream via URL: wss://dstream.binance.com/stream?streams=!miniTicker@arr
Combined stream via request: Connect to wss://dstream.binance.com/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: ["!miniTicker@arr"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

All Market Mini Tickers Stream › Responses

All Market Mini Tickers Stream

object

e

string · enum

Event type

Enum values:

24hrMiniTicker

Example: 24hrMiniTicker

E

integer · int64

Event time

Example: 1591267704450

s

string

Symbol

Example: BTCUSD_200626

ps

string

Pair

Example: BTCUSD

c

string

Close price

Example: 9561.7

o

string

Open price

Example: 9580.9

h

string

High price

Example: 10000.0

l

string

Low price

Example: 7000.0

v

string

Total traded volume

Example: 487476

q

string

Total traded base asset volume

Example: 33264343847.22378500

st

integer

(After CM migration) Symbol type: 1 = UM, 2 = CM

Example: 1

All Market Tickers Streams

24hr rolling window ticker statistics for all symbols. These are NOT the statistics of the UTC day, but a 24hr rolling window from requestTime to 24hrs before. Note that only tickers that have changed will be present in the array.

After CM migration, this stream pushes the merged UM + CM universe (subscribable on both fstream and dstream); each payload is appended with a new st field (1 = UM, 2 = CM).

WSS

!ticker@arr

wss://dstream.binance.com

Update Speed1000ms

All Market Tickers Streams › Request

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

Raw stream: wss://dstream.binance.com/ws/!ticker@arr
Combined stream via URL: wss://dstream.binance.com/stream?streams=!ticker@arr
Combined stream via request: Connect to wss://dstream.binance.com/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: ["!ticker@arr"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

All Market Tickers Streams › Responses

All Market Tickers Streams

object

e

string · enum

Event type

Enum values:

24hrTicker

Example: 24hrTicker

E

integer · int64

Event time

Example: 1591268262453

s

string

Symbol

Example: BTCUSD_200626

p

string

Price change

Example: -43.4

P

string

Price change percent

Example: -0.452

w

string

Weighted average price

Example: 0.00147974

c

string

Last price

Example: 9548.5

Q

string

Last quantity

Example: 2

o

string

Open price

Example: 9591.9

h

string

High price

Example: 10000.0

l

string

Low price

Example: 7000.0

v

string

Total traded volume

Example: 487850

q

string

Total traded base asset volume

Example: 32968676323.46222700

O

integer · int64

Statistics open time

Example: 1591181820000

C

integer · int64

Statistics close time

Example: 1591268262442

F

integer · int64

First trade ID

Example: 512014

L

integer · int64

Last trade Id

Example: 615289

n

integer · int64

Total number of trades

Example: 103272

ps

string

Pair

Example: BTCUSD

st

integer

(After CM migration) Symbol type: 1 = UM, 2 = CM

Example: 1

WSS!ticker@arr

wscat -c wss://dstream.binance.com//stream -x '{
  "method": "SUBSCRIBE",
  "params": [
    "!ticker@arr"
  ],
  "id": "e9d6b4349871b40611412680b3445fac"
}' -w 30

Example Request

{
  "method": "SUBSCRIBE",
  "params": [
    "!ticker@arr"
  ],
  "id": "e9d6b4349871b40611412680b3445fac"
}

json

application/json

Example Responses

[
  {
    "e": "24hrTicker",
    "E": 1591268262453,
    "s": "BTCUSD_200626",
    "p": "-43.4",
    "P": "-0.452",
    "w": "0.00147974",
    "c": "9548.5",
    "Q": "2",
    "o": "9591.9",
    "h": "10000.0",
    "l": "7000.0",
    "v": "487850",
    "q": "32968676323.46222700",
    "O": 1591181820000,
    "C": 1591268262442,
    "F": 512014,
    "L": 615289,
    "n": 103272,
    "ps": "BTCUSD",
    "st": 1
  }
]

json

application/json

Continuous Contract Kline/Candlestick Streams

Kline update every second

After CM migration, both fstream and dstream may subscribe to either UM or CM symbols on this stream.

WSS

{pair}_{contractType}@continuousKline_{interval}

wss://dstream.binance.com

Update Speed250ms

Continuous Contract Kline/Candlestick Streams › Stream parameters

pair

string · required

The pair parameter

Example: btcusdt

contractType

string · enum · required

The contractType parameter

Enum values:

perpetual

current_quarter

next_quarter

Example: next_quarter

interval

string · enum · required

The interval parameter

Enum values:

15m

30m

Example: 1m

Continuous Contract Kline/Candlestick Streams › Request

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

Raw stream: wss://dstream.binance.com/ws/{pair}_{contractType}@continuousKline_{interval}
Combined stream via URL: wss://dstream.binance.com/stream?streams={pair}_{contractType}@continuousKline_{interval}
Combined stream via request: Connect to wss://dstream.binance.com/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_next_quarter@continuousKline_1m"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Continuous Contract Kline/Candlestick Streams › Responses

Continuous Contract Kline/Candlestick Streams

e

string · enum

eventType

Enum values:

continuous_kline

Example: continuous_kline

E

integer · int64

eventTime

Example: 1591261542539

ps

string

Pair

Example: BTCUSD

ct

string

Contract type

Example: NEXT_QUARTER

object

Kline payload

WSS{pair}_{contractType}@continuousKline_{interval}

wscat -c wss://dstream.binance.com//stream -x '{
  "method": "SUBSCRIBE",
  "params": [
    "btcusdt_next_quarter@continuousKline_1m"
  ],
  "id": "e9d6b4349871b40611412680b3445fac"
}' -w 30

Example Request

{
  "method": "SUBSCRIBE",
  "params": [
    "btcusdt_next_quarter@continuousKline_1m"
  ],
  "id": "e9d6b4349871b40611412680b3445fac"
}

json

application/json

Example Responses

{
  "e": "continuous_kline",
  "E": 1591261542539,
  "ps": "BTCUSD",
  "ct": "NEXT_QUARTER",
  "k": {
    "t": 1591261500000,
    "T": 1591261559999,
    "i": "1m",
    "f": 606400,
    "L": 606430,
    "o": "9638.9",
    "c": "9639.8",
    "h": "9639.8",
    "l": "9638.6",
    "v": "156",
    "n": 31,
    "x": false,
    "q": "1.61836886",
    "V": "73",
    "Q": "0.75731156",
    "B": "0"
  }
}

json

application/json

Contract Info Stream

ContractInfo stream pushes when contract info updates(listing/settlement/contract bracket update). bks field only shows up when bracket gets updated.

After CM migration, this stream pushes the merged UM + CM universe (subscribable on both fstream and dstream); each payload is appended with a new st field (1 = UM, 2 = CM).

WSS

!contractInfo

wss://dstream.binance.com

Update SpeedReal-time

Contract Info Stream › Request

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

Raw stream: wss://dstream.binance.com/ws/!contractInfo
Combined stream via URL: wss://dstream.binance.com/stream?streams=!contractInfo
Combined stream via request: Connect to wss://dstream.binance.com/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: ["!contractInfo"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Contract Info Stream › Responses

Contract Info Stream

e

string · enum

Event Type

Enum values:

contractInfo

Example: contractInfo

E

integer · int64

Event Time

Example: 1669647330375

s

string

Symbol

Example: APTUSD_PERP

ps

string

Pair

Example: APTUSD

ct

string

Contract type

Example: PERPETUAL

dt

integer · int64

Delivery date time

Example: 4133404800000

ot

integer · int64

onboard date time

Example: 1666594800000

cs

string

Contract status

Example: TRADING

object[]

Bracket list.

st

integer

(After CM migration) Symbol type: 1 = UM, 2 = CM

Example: 1

Diff. Book Depth Streams

Bids and asks, pushed every 250 milliseconds, 500 milliseconds, or 100 milliseconds

After CM migration, the payload is appended with a new st field (1 = UM, 2 = CM).

WSS

{symbol}@depth@{updateSpeed}

wss://dstream.binance.com

Update Speed250ms or 500ms or 100ms

Diff. Book Depth Streams › Stream parameters

symbol

string · required

The symbol parameter

Example: btcusdt

updateSpeed

string · enum

WebSocket stream update speed

Enum values:

100ms

500ms

Example: 100ms

Diff. Book Depth Streams › Request

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

Raw stream: wss://dstream.binance.com/ws/{symbol}@depth@{updateSpeed}
Combined stream via URL: wss://dstream.binance.com/stream?streams={symbol}@depth@{updateSpeed}
Combined stream via request: Connect to wss://dstream.binance.com/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@depth@100ms"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Diff. Book Depth Streams › Responses

Diff. Book Depth Streams

e

string · enum

Event type

Enum values:

depthUpdate

Example: depthUpdate

E

integer · int64

Event time

Example: 1591270260907

T

integer · int64

Transction time

Example: 1591270260891

s

string

Symbol

Example: BTCUSD_200626

ps

string

Pair

Example: BTCUSD

U

integer · int64

First update ID in event

Example: 17285681

u

integer · int64

Final update ID in event

Example: 17285702

pu

integer · int64

Final update Id in last stream(ie u in last stream)

Example: 17285675

b

array[]

Bids to be updated

a

array[]

Asks to be updated

st

integer

(After CM migration) Symbol type: 1 = UM, 2 = CM

Example: 1

Index Kline/Candlestick Streams

After CM migration, both fstream and dstream may subscribe to CM symbols on this stream.

WSS

{pair}@indexPriceKline_{interval}

wss://dstream.binance.com

Update Speed250ms

Index Kline/Candlestick Streams › Stream parameters

pair

string · required

The pair parameter

Example: btcusdt

interval

string · enum · required

The interval parameter

Enum values:

15m

30m

Example: 1m

Index Kline/Candlestick Streams › Request

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

Raw stream: wss://dstream.binance.com/ws/{pair}@indexPriceKline_{interval}
Combined stream via URL: wss://dstream.binance.com/stream?streams={pair}@indexPriceKline_{interval}
Combined stream via request: Connect to wss://dstream.binance.com/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@indexPriceKline_1m"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Index Kline/Candlestick Streams › Responses

Index Kline/Candlestick Streams

e

string · enum

eventType

Enum values:

indexPrice_kline

Example: indexPrice_kline

E

integer · int64

eventTime

Example: 1591267070033

ps

string

Pair

Example: BTCUSD

object

Kline payload

WSS{pair}@indexPriceKline_{interval}

wscat -c wss://dstream.binance.com//stream -x '{
  "method": "SUBSCRIBE",
  "params": [
    "btcusdt@indexPriceKline_1m"
  ],
  "id": "e9d6b4349871b40611412680b3445fac"
}' -w 30

Example Request

{
  "method": "SUBSCRIBE",
  "params": [
    "btcusdt@indexPriceKline_1m"
  ],
  "id": "e9d6b4349871b40611412680b3445fac"
}

json

application/json

Example Responses

{
  "e": "indexPrice_kline",
  "E": 1591267070033,
  "ps": "BTCUSD",
  "k": {
    "t": 1591267020000,
    "T": 1591267079999,
    "s": "0",
    "i": "1m",
    "f": 1591267020000,
    "L": 1591267070000,
    "o": "9542.21900000",
    "c": "9542.50440000",
    "h": "9542.71640000",
    "l": "9542.21040000",
    "v": "0",
    "n": 51,
    "x": false,
    "q": "0",
    "V": "0",
    "Q": "0",
    "B": "0"
  }
}

json

application/json

Index Price Stream

WSS

{pair}@indexPrice@{updateSpeed}

wss://dstream.binance.com

Update Speed3000ms OR 1000ms

Index Price Stream › Stream parameters

pair

string · required

The pair parameter

Example: btcusdt

updateSpeed

string · enum

WebSocket stream update speed

Enum values:

Example: 1s

Index Price Stream › Request

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

Raw stream: wss://dstream.binance.com/ws/{pair}@indexPrice@{updateSpeed}
Combined stream via URL: wss://dstream.binance.com/stream?streams={pair}@indexPrice@{updateSpeed}
Combined stream via request: Connect to wss://dstream.binance.com/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@indexPrice@1s"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Index Price Stream › Responses

Index Price Stream

e

string · enum

Event type

Enum values:

indexPriceUpdate

Example: indexPriceUpdate

E

integer · int64

Event time

Example: 1591261236000

i

string

Pair

Example: BTCUSD

p

string

Index Price

Example: 9636.57860000

Individual Symbol Book Ticker Streams

Pushes any update to the best bid or ask's price or quantity in real-time for a specified symbol.

After CM migration, the payload is appended with a new st field (1 = UM, 2 = CM).

WSS

{symbol}@bookTicker

wss://dstream.binance.com

Update SpeedReal-time

Individual Symbol Book Ticker Streams › Stream parameters

symbol

string · required

The symbol parameter

Example: btcusdt

Individual Symbol Book Ticker Streams › Request

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

Raw stream: wss://dstream.binance.com/ws/{symbol}@bookTicker
Combined stream via URL: wss://dstream.binance.com/stream?streams={symbol}@bookTicker
Combined stream via request: Connect to wss://dstream.binance.com/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@bookTicker"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Individual Symbol Book Ticker Streams › Responses

Individual Symbol Book Ticker Streams

e

string · enum

Event type

Enum values:

bookTicker

Example: bookTicker

u

integer · int64

Order book update Id

Example: 17242169

s

string

Symbol

Example: BTCUSD_200626

b

string

Best bid price

Example: 9548.1

B

string

Best bid qty

Example: 52

a

string

Best ask price

Example: 9548.5

A

string

Best ask qty

Example: 11

T

integer · int64

Transaction time

Example: 1591268628155

E

integer · int64

Event time

Example: 1591268628166

ps

string

Pair

Example: BTCUSD

st

integer

(After CM migration) Symbol type: 1 = UM, 2 = CM

Example: 2

Individual Symbol Mini Ticker Stream

24hr rolling window mini-ticker statistics for a single symbol. These are NOT the statistics of the UTC day, but a 24hr rolling window from requestTime to 24hrs before.

After CM migration, the payload is appended with a new st field (1 = UM, 2 = CM).

WSS

{symbol}@miniTicker

wss://dstream.binance.com

Update Speed500ms

Individual Symbol Mini Ticker Stream › Stream parameters

symbol

string · required

The symbol parameter

Example: btcusdt

Individual Symbol Mini Ticker Stream › Request

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

Raw stream: wss://dstream.binance.com/ws/{symbol}@miniTicker
Combined stream via URL: wss://dstream.binance.com/stream?streams={symbol}@miniTicker
Combined stream via request: Connect to wss://dstream.binance.com/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@miniTicker"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Individual Symbol Mini Ticker Stream › Responses

Individual Symbol Mini Ticker Stream

e

string · enum

Event type

Enum values:

24hrMiniTicker

Example: 24hrMiniTicker

E

integer · int64

Event time

Example: 1591267704450

s

string

Symbol

Example: BTCUSD_200626

ps

string

Pair

Example: BTCUSD

c

string

Close price

Example: 9561.7

o

string

Open price

Example: 9580.9

h

string

High price

Example: 10000.0

l

string

Low price

Example: 7000.0

v

string

Total traded volume

Example: 487476

q

string

Total traded base asset volume

Example: 33264343847.22378500

st

integer

(After CM migration) Symbol type: 1 = UM, 2 = CM

Example: 1

Individual Symbol Ticker Streams

24hr rolling window ticker statistics for a single symbol. These are NOT the statistics of the UTC day, but a 24hr rolling window from requestTime to 24hrs before.

After CM migration, the payload is appended with a new st field (1 = UM, 2 = CM).

WSS

{symbol}@ticker

wss://dstream.binance.com

Update Speed500ms

Individual Symbol Ticker Streams › Stream parameters

symbol

string · required

The symbol parameter

Example: btcusdt

Individual Symbol Ticker Streams › Request

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

Raw stream: wss://dstream.binance.com/ws/{symbol}@ticker
Combined stream via URL: wss://dstream.binance.com/stream?streams={symbol}@ticker
Combined stream via request: Connect to wss://dstream.binance.com/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@ticker"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Individual Symbol Ticker Streams › Responses

Individual Symbol Ticker Streams

e

string · enum

Event type

Enum values:

24hrTicker

Example: 24hrTicker

E

integer · int64

Event time

Example: 1591268262453

s

string

Symbol

Example: BTCUSD_200626

p

string

Price change

Example: -43.4

P

string

Price change percent

Example: -0.452

w

string

Weighted average price

Example: 0.00147974

c

string

Last price

Example: 9548.5

Q

string

Last quantity

Example: 2

o

string

Open price

Example: 9591.9

h

string

High price

Example: 10000.0

l

string

Low price

Example: 7000.0

v

string

Total traded volume

Example: 487850

q

string

Total traded base asset volume

Example: 32968676323.46222700

O

integer · int64

Statistics open time

Example: 1591181820000

C

integer · int64

Statistics close time

Example: 1591268262442

F

integer · int64

First trade ID

Example: 512014

L

integer · int64

Last trade Id

Example: 615289

n

integer · int64

Total number of trades

Example: 103272

ps

string

Pair

Example: BTCUSD

st

integer

(After CM migration) Symbol type: 1 = UM, 2 = CM

Example: 1

Kline/Candlestick Streams

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

After CM migration, both fstream and dstream may subscribe to either UM or CM symbols on this stream.

WSS

{symbol}@kline_{interval}

wss://dstream.binance.com

Update Speed250ms

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://dstream.binance.com/ws/{symbol}@kline_{interval}
Combined stream via URL: wss://dstream.binance.com/stream?streams={symbol}@kline_{interval}
Combined stream via request: Connect to wss://dstream.binance.com/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

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Kline/Candlestick Streams › Responses

Kline/Candlestick Streams

e

string · enum

Event type

Enum values:

kline

Example: kline

E

integer · int64

Event time

Example: 1591261542539

s

string

Symbol

Example: BTCUSD_200626

object

Kline payload

WSS{symbol}@kline_{interval}

wscat -c wss://dstream.binance.com//stream -x '{
  "method": "SUBSCRIBE",
  "params": [
    "btcusdt@kline_1m"
  ],
  "id": "e9d6b4349871b40611412680b3445fac"
}' -w 30

Example Request

{
  "method": "SUBSCRIBE",
  "params": [
    "btcusdt@kline_1m"
  ],
  "id": "e9d6b4349871b40611412680b3445fac"
}

json

application/json

Example Responses

{
  "e": "kline",
  "E": 1591261542539,
  "s": "BTCUSD_200626",
  "k": {
    "t": 1591261500000,
    "T": 1591261559999,
    "s": "BTCUSD_200626",
    "i": "1m",
    "f": 606400,
    "L": 606430,
    "o": "9638.9",
    "c": "9639.8",
    "h": "9639.8",
    "l": "9638.6",
    "v": "156",
    "n": 31,
    "x": false,
    "q": "1.61836886",
    "V": "73",
    "Q": "0.75731156",
    "B": "0"
  }
}

json

application/json

Market Liquidation Order Streams

The Liquidation Order Snapshot Streams push force liquidation order information for specific symbol. For each symbol，only the latest one liquidation order within 1000ms will be pushed as the snapshot. If no liquidation happens in the interval of 1000ms, no stream will be pushed.

WSS

{symbol}@forceOrder

wss://dstream.binance.com

Update Speed1000ms

Market Liquidation Order Streams › Stream parameters

symbol

string · required

The symbol parameter

Example: btcusdt

Market Liquidation Order Streams › Request

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

Raw stream: wss://dstream.binance.com/ws/{symbol}@forceOrder
Combined stream via URL: wss://dstream.binance.com/stream?streams={symbol}@forceOrder
Combined stream via request: Connect to wss://dstream.binance.com/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@forceOrder"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Market Liquidation Order Streams › Responses

Liquidation Order Streams

e

string · enum

Event Type

Enum values:

forceOrder

Example: forceOrder

E

integer · int64

Event Time

Example: 1591154240950

object

Order Type

Mark Price Kline/Candlestick Streams

After CM migration, both fstream and dstream may subscribe to CM symbols on this stream.

WSS

{symbol}@markPriceKline_{interval}

wss://dstream.binance.com

Update Speed250ms

Mark Price 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

Mark Price Kline/Candlestick Streams › Request

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

Raw stream: wss://dstream.binance.com/ws/{symbol}@markPriceKline_{interval}
Combined stream via URL: wss://dstream.binance.com/stream?streams={symbol}@markPriceKline_{interval}
Combined stream via request: Connect to wss://dstream.binance.com/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@markPriceKline_1m"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Mark Price Kline/Candlestick Streams › Responses

Mark Price Kline/Candlestick Streams

e

string · enum

Event Name

Enum values:

markPrice_kline

Example: markPrice_kline

E

integer · int64

Event Time

Example: 1591267398004

ps

string

Pair

Example: BTCUSD

object

Kline payload

WSS{symbol}@markPriceKline_{interval}

wscat -c wss://dstream.binance.com//stream -x '{
  "method": "SUBSCRIBE",
  "params": [
    "btcusdt@markPriceKline_1m"
  ],
  "id": "e9d6b4349871b40611412680b3445fac"
}' -w 30

Example Request

{
  "method": "SUBSCRIBE",
  "params": [
    "btcusdt@markPriceKline_1m"
  ],
  "id": "e9d6b4349871b40611412680b3445fac"
}

json

application/json

Example Responses

{
  "e": "markPrice_kline",
  "E": 1591267398004,
  "ps": "BTCUSD",
  "k": {
    "t": 1591267380000,
    "T": 1591267439999,
    "s": "BTCUSD_200626",
    "i": "1m",
    "f": 1591267380000,
    "L": 1591267398000,
    "o": "9539.67161333",
    "c": "9540.82761333",
    "h": "9540.82761333",
    "l": "9539.66961333",
    "v": "0",
    "n": 19,
    "x": false,
    "q": "0",
    "V": "0",
    "Q": "0",
    "B": "0"
  }
}

json

application/json

Mark Price of All Symbols of a Pair

After CM migration, the payload is appended with a new st field (1 = UM, 2 = CM); both fstream and dstream may subscribe to either UM or CM symbols on this stream.

WSS

{pair}@markPrice@{updateSpeed}

wss://dstream.binance.com

Update Speed3000ms OR 1000ms

Mark Price of All Symbols of a Pair › Stream parameters

pair

string · required

The pair parameter

Example: btcusdt

updateSpeed

string · enum

WebSocket stream update speed

Enum values:

Example: 1s

Mark Price of All Symbols of a Pair › Request

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

Raw stream: wss://dstream.binance.com/ws/{pair}@markPrice@{updateSpeed}
Combined stream via URL: wss://dstream.binance.com/stream?streams={pair}@markPrice@{updateSpeed}
Combined stream via request: Connect to wss://dstream.binance.com/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@markPrice@1s"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Mark Price of All Symbols of a Pair › Responses

Mark Price of All Symbols of a Pair

object

e

string · enum

Event type

Enum values:

markPriceUpdate

Example: markPriceUpdate

E

integer · int64

Event time

Example: 1596095725000

s

string

Symbol

Example: BTCUSD_201225

p

string

Mark Price

Example: 10934.62615417

P

string

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

Example: 10962.17178236

i

string

Index Price

Example: 10933.62615417

r

string

funding rate for perpetual symbol, "" will be shown for delivery symbol

Example:

T

integer · int64

next funding time for perpetual symbol, 0 will be shown for delivery symbol

Example: 0

st

integer

(After CM migration) Symbol type: 1 = UM, 2 = CM

Example: 1

Mark Price Stream

Mark price update stream

After CM migration, the payload is appended with a new st field (1 = UM, 2 = CM); both fstream and dstream may subscribe to either UM or CM symbols on this stream.

WSS

{symbol}@markPrice@{updateSpeed}

wss://dstream.binance.com

Update Speed3000ms OR 1000ms

Mark Price Stream › Stream parameters

symbol

string · required

The symbol parameter

Example: btcusdt

updateSpeed

string · enum

WebSocket stream update speed

Enum values:

Example: 1s

Mark Price Stream › Request

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

Raw stream: wss://dstream.binance.com/ws/{symbol}@markPrice@{updateSpeed}
Combined stream via URL: wss://dstream.binance.com/stream?streams={symbol}@markPrice@{updateSpeed}
Combined stream via request: Connect to wss://dstream.binance.com/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@markPrice@1s"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Mark Price Stream › Responses

Mark Price Stream

e

string · enum

Event type

Enum values:

markPriceUpdate

Example: markPriceUpdate

E

integer · int64

Event time

Example: 1596095725000

s

string

Symbol

Example: BTCUSD_201225

p

string

Mark Price

Example: 10934.62615417

P

string

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

Example: 10962.17178236

i

string

Index Price

Example: 10933.62615417

r

string

funding rate for perpetual symbol, "" will be shown for delivery symbol

Example:

T

integer · int64

next funding time for perpetual symbol, 0 will be shown for delivery symbol

Example: 0

st

integer

(After CM migration) Symbol type: 1 = UM, 2 = CM

Example: 1

Partial Book Depth Streams

Top levels bids and asks.

After CM migration, the payload is appended with a new st field (1 = UM, 2 = CM).

WSS

{symbol}@depth{levels}@{updateSpeed}

wss://dstream.binance.com

Update Speed250ms, 500ms or 100ms

Partial Book Depth Streams › Stream parameters

symbol

string · required

The symbol parameter

Example: btcusdt

levels

string · enum · required

The levels parameter

Enum values:

Example: 10

updateSpeed

string · enum

WebSocket stream update speed

Enum values:

100ms

500ms

Example: 100ms

Partial Book Depth Streams › Request

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

Raw stream: wss://dstream.binance.com/ws/{symbol}@depth{levels}@{updateSpeed}
Combined stream via URL: wss://dstream.binance.com/stream?streams={symbol}@depth{levels}@{updateSpeed}
Combined stream via request: Connect to wss://dstream.binance.com/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@depth10@100ms"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Partial Book Depth Streams › Responses

Partial Book Depth Streams

e

string · enum

Event type

Enum values:

depthUpdate

Example: depthUpdate

E

integer · int64

Event time

Example: 1591269996801

T

integer · int64

Transaction time

Example: 1591269996646

s

string

Symbol

Example: BTCUSD_200626

ps

string

Pair

Example: BTCUSD

U

integer · int64

First update ID in event

Example: 17276694

u

integer · int64

updateId

Example: 17276701

pu

integer · int64

Final update Id in last stream(ie u in last stream)

Example: 17276678

b

array[]

Bids to be updated

a

array[]

Asks to be updated

st

integer

(After CM migration) Symbol type: 1 = UM, 2 = CM

Example: 1