Spot WebSocket Market Streams | Binance Developer Docs

Endpoint

Download schema

Aggregate Trade Streams

The Aggregate Trade Streams push trade information that is aggregated for a single taker order.

WSS

{symbol}@aggTrade

wss://stream.binance.com:9443

Update SpeedReal-time

Aggregate Trade Streams › Stream parameters

symbol

string · required

Symbol to query

Example: bnbusdt

Aggregate Trade Streams › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Aggregate Trade Streams › Responses

Aggregate Trade Streams

e

string

Event type

Example: aggTrade

E

integer · int64

Event time

Example: 1672515782136

s

string

Symbol

Example: BNBBTC

a

integer · int64

Aggregate trade ID

Example: 12345

p

string

Price

Example: 0.001

q

string

Quantity

Example: 100

f

integer · int64

First trade ID

Example: 100

l

integer · int64

Last trade ID

Example: 105

T

integer · int64

Trade time

Example: 1672515782136

m

boolean

Is the buyer the market maker?

Example: true

M

boolean

Ignore

Example: true

All Market Rolling Window Statistics Streams

Rolling window ticker statistics for all market symbols, computed over multiple windows.

Note that only tickers that have changed will be present in the array.

WSS

!ticker_{windowSize}@arr

wss://stream.binance.com:9443

Update Speed1000ms

All Market Rolling Window Statistics Streams › Stream parameters

windowSize

string · enum · required

Enum values:

Example: 1h

All Market Rolling Window Statistics Streams › Request

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

Raw stream: wss://stream.binance.com:9443/ws/!ticker_{windowSize}@arr
Combined stream via URL: wss://stream.binance.com:9443/stream?streams=!ticker_{windowSize}@arr
Combined stream via request: Connect to wss://stream.binance.com:9443/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_1h@arr"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

All Market Rolling Window Statistics Streams › Responses

All Market Rolling Window Statistics Streams

object

e

string

Event type

Example: 1hTicker

E

integer · int64

Event time

Example: 1672515782136

s

string

Symbol

Example: BNBBTC

p

string

Price change

Example: 0.0015

P

string

Price change percent

Example: 250

o

string

Open price

Example: 0.001

h

string

High price

Example: 0.0025

l

string

Low price

Example: 0.001

c

string

Last price

Example: 0.0025

w

string

Weighted average price

Example: 0.0018

v

string

Total traded base asset volume

Example: 10000

q

string

Total traded quote asset volume

Example: 18

O

integer · int64

Statistics open time

Example: 0

C

integer · int64

Statistics close time

Example: 1675216573749

F

integer · int64

First trade ID

Example: 0

L

integer · int64

Last trade Id

Example: 18150

n

integer · int64

Total number of trades

Example: 18151

All Market Mini Tickers Stream

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

WSS

!miniTicker@arr

wss://stream.binance.com:9443

Update Speed1000ms

All Market Mini Tickers Stream › Request

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

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

Event type

Example: 24hrMiniTicker

E

integer · int64

Event time

Example: 1672515782136

s

string

Symbol

Example: BNBBTC

c

string

Close price

Example: 0.0025

o

string

Open price

Example: 0.001

h

string

High price

Example: 0.0025

l

string

Low price

Example: 0.001

v

string

Total traded base asset volume

Example: 10000

q

string

Total traded quote asset volume

Example: 18

Average Price

Average price streams push changes in the average price over a fixed time interval.

WSS

{symbol}@avgPrice

wss://stream.binance.com:9443

Update Speed1000ms

Average Price › Stream parameters

symbol

string · required

Symbol to query

Example: bnbusdt

Average Price › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Average Price › Responses

Average Price

e

string

Event type

Example: avgPrice

E

integer · int64

Event time

Example: 1693907033000

s

string

Symbol

Example: BTCUSDT

i

string

Average price interval

Example: 5m

w

string

Average price

Example: 25776.86

T

integer · int64

Last trade time

Example: 1693907032213

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.

Multiple <symbol>@bookTicker streams can be subscribed to over one connection.

WSS

{symbol}@bookTicker

wss://stream.binance.com:9443

Update SpeedReal-time

Individual Symbol Book Ticker Streams › Stream parameters

symbol

string · required

Symbol to query

Example: bnbusdt

Individual Symbol Book Ticker Streams › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Individual Symbol Book Ticker Streams › Responses

Individual Symbol Book Ticker Streams

u

integer · int64

Order book updateId

Example: 400900217

s

string

Symbol

Example: BNBUSDT

b

string

Best bid price

Example: 25.3519

B

string

Best bid qty

Example: 31.21

a

string

Best ask price

Example: 25.3652

A

string

Best ask qty

Example: 40.66

Diff. Depth Stream

Order book price and quantity depth updates used to locally manage an order book.

WSS

{symbol}@depth@{updateSpeed}

wss://stream.binance.com:9443

Update Speed1000ms or 100ms

Diff. Depth Stream › Stream parameters

symbol

string · required

Symbol to query

Example: bnbusdt

updateSpeed

string · enum

Optional stream update speed suffix

Enum values:

100ms

Example: 100ms

Diff. Depth Stream › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Diff. Depth Stream › Responses

Diff. Depth Stream

e

string

Event type

Example: depthUpdate

E

integer · int64

Event time

Example: 1672515782136

s

string

Symbol

Example: BNBBTC

U

integer · int64

First update ID in event

Example: 157

u

integer · int64

Final update ID in event

Example: 160

array[]

Bids to be updated

array[]

Asks to be updated

Kline/Candlestick Streams for UTC

The Kline/Candlestick Stream push updates to the current klines/candlestick every second in UTC+0 timezone

WSS

{symbol}@kline_{interval}

wss://stream.binance.com:9443

Update Speed1000ms for `1s`, 2000ms for the other intervals

Kline/Candlestick Streams for UTC › Stream parameters

symbol

string · required

Symbol to query

Example: bnbusdt

interval

string · enum · required

Enum values:

15m

30m

Example: 1s

Kline/Candlestick Streams for UTC › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Kline/Candlestick Streams for UTC › Responses

Kline/Candlestick Streams for UTC

e

string

Event type

Example: kline

E

integer · int64

Event time

Example: 1672515782136

s

string

Symbol

Example: BNBBTC

object

Kline payload

Kline/Candlestick Streams with timezone offset

The Kline/Candlestick Stream push updates to the current klines/candlestick every second in UTC+8 timezone

Kline/Candlestick chart intervals:

Supported intervals: See Kline/Candlestick chart intervals

UTC+8 timezone offset:

Kline intervals open and close in the UTC+8 timezone. For example the 1d klines will open at the beginning of the UTC+8 day, and close at the end of the UTC+8 day.
Note that E (event time), t (start time) and T (close time) in the payload are Unix timestamps, which are always interpreted in UTC.

WSS

{symbol}@kline_{interval}@+08:00

wss://stream.binance.com:9443

Update Speed1000ms for `1s`, 2000ms for the other intervals

Kline/Candlestick Streams with timezone offset › Stream parameters

symbol

string · required

Symbol to query

Example: bnbusdt

interval

string · enum · required

Enum values:

15m

30m

Example: 1s

Kline/Candlestick Streams with timezone offset › Request

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

Raw stream: wss://stream.binance.com:9443/ws/{symbol}@kline_{interval}@+08:00
Combined stream via URL: wss://stream.binance.com:9443/stream?streams={symbol}@kline_{interval}@+08:00
Combined stream via request: Connect to wss://stream.binance.com:9443/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: ["bnbusdt@kline_1s@+08:00"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Kline/Candlestick Streams with timezone offset › Responses

Kline/Candlestick Streams with timezone offset

e

string

Event type

Example: kline

E

integer · int64

Event time

Example: 1672515782136

s

string

Symbol

Example: BNBBTC

object

Kline payload

Individual Symbol Mini Ticker Stream

24hr rolling window mini-ticker statistics. These are NOT the statistics of the UTC day, but a 24hr rolling window for the previous 24hrs.

WSS

{symbol}@miniTicker

wss://stream.binance.com:9443

Update Speed1000ms

Individual Symbol Mini Ticker Stream › Stream parameters

symbol

string · required

Symbol to query

Example: bnbusdt

Individual Symbol Mini Ticker Stream › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Individual Symbol Mini Ticker Stream › Responses

Individual Symbol Mini Ticker Stream

e

string

Event type

Example: 24hrMiniTicker

E

integer · int64

Event time

Example: 1672515782136

s

string

Symbol

Example: BNBBTC

c

string

Close price

Example: 0.0025

o

string

Open price

Example: 0.001

h

string

High price

Example: 0.0025

l

string

Low price

Example: 0.001

v

string

Total traded base asset volume

Example: 10000

q

string

Total traded quote asset volume

Example: 18

WebSocket Partial Book Depth Streams

Top <levels> bids and asks, pushed every second.

WSS

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

wss://stream.binance.com:9443

Update Speed1000ms or 100ms

WebSocket Partial Book Depth Streams › Stream parameters

symbol

string · required

Symbol to query

Example: bnbusdt

levels

string · enum · required

Enum values:

Example: 5

updateSpeed

string · enum

Optional stream update speed suffix

Enum values:

100ms

Example: 100ms

WebSocket Partial Book Depth Streams › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

WebSocket Partial Book Depth Streams › Responses

Partial Book Depth Streams

lastUpdateId

integer · int64

Last update ID

Example: 160

array[]

Bids to be updated

array[]

Asks to be updated

Reference Price Streams

Reference price stream for a symbol.

WSS

{symbol}@referencePrice

wss://stream.binance.com:9443

Update Speed1000ms

Reference Price Streams › Stream parameters

symbol

string · required

Symbol to query

Example: bazusd

Reference Price Streams › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Reference Price Streams › Responses

Reference Price Streams

e

string

Event type

Example: referencePrice

s

string

Symbol

Example: BAZUSD

r

string

Reference price (null if no reference price)

Example: 1.00

t

integer · int64

Engine timestamp when reference price was valid

Example: 1770313263917

Individual Symbol Rolling Window Statistics Streams

Rolling window ticker statistics for a single symbol, computed over multiple windows.

Note: This stream is different from the <symbol>@ticker stream. The open time "O" always starts on a minute, while the closing time "C" is the current time of the update. As such, the effective window might be up to 59999ms wider than <window_size>.

WSS

{symbol}@ticker_{windowSize}

wss://stream.binance.com:9443

Update Speed1000ms

Individual Symbol Rolling Window Statistics Streams › Stream parameters

symbol

string · required

Symbol to query

Example: bnbusdt

windowSize

string · enum · required

Enum values:

Example: 1h

Individual Symbol Rolling Window Statistics Streams › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Individual Symbol Rolling Window Statistics Streams › Responses

Individual Symbol Rolling Window Statistics Streams

e

string

Event type

Example: 1hTicker

E

integer · int64

Event time

Example: 1672515782136

s

string

Symbol

Example: BNBBTC

p

string

Price change

Example: 0.0015

P

string

Price change percent

Example: 250

o

string

Open price

Example: 0.001

h

string

High price

Example: 0.0025

l

string

Low price

Example: 0.001

c

string

Last price

Example: 0.0025

w

string

Weighted average price

Example: 0.0018

v

string

Total traded base asset volume

Example: 10000

q

string

Total traded quote asset volume

Example: 18

O

integer · int64

Statistics open time

Example: 0

C

integer · int64

Statistics close time

Example: 1675216573749

F

integer · int64

First trade ID

Example: 0

L

integer · int64

Last trade Id

Example: 18150

n

integer · int64

Total number of trades

Example: 18151

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 for the previous 24hrs.

WSS

{symbol}@ticker

wss://stream.binance.com:9443

Update Speed1000ms

Individual Symbol Ticker Streams › Stream parameters

symbol

string · required

Symbol to query

Example: bnbusdt

Individual Symbol Ticker Streams › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Individual Symbol Ticker Streams › Responses

Individual Symbol Ticker Streams

e

string

Event type

Example: 24hrTicker

E

integer · int64

Event time

Example: 1672515782136

s

string

Symbol

Example: BNBBTC

p

string

Price change

Example: 0.0015

P

string

Price change percent

Example: 250

w

string

Weighted average price

Example: 0.0018

x

string

First trade(F)-1 price (first trade before the 24hr rolling window)

Example: 0.0009

c

string

Last price

Example: 0.0025

Q

string

Last quantity

Example: 10

b

string

Best bid price

Example: 0.0024

B

string

Best bid quantity

Example: 10

a

string

Best ask price

Example: 0.0026

A

string

Best ask quantity

Example: 100

o

string

Open price

Example: 0.001

h

string

High price

Example: 0.0025

l

string

Low price

Example: 0.001

v

string

Total traded base asset volume

Example: 10000

q

string

Total traded quote asset volume

Example: 18

O

integer · int64

Statistics open time

Example: 0

C

integer · int64

Statistics close time

Example: 1675216573749

F

integer · int64

First trade ID

Example: 0

L

integer · int64

Last trade Id

Example: 18150

n

integer · int64

Total number of trades

Example: 18151

Trade Streams

The Trade Streams push raw trade information; each trade has a unique buyer and seller.

WSS

{symbol}@trade

wss://stream.binance.com:9443

Update SpeedReal-time

Trade Streams › Stream parameters

symbol

string · required

Symbol to query

Example: bnbusdt

Trade Streams › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Trade Streams › Responses

Trade Streams

e

string

Event type

Example: trade

E

integer · int64

Event time

Example: 1672515782136

s

string

Symbol

Example: BNBBTC

t

integer · int64

Trade ID

Example: 12345

p

string

Price

Example: 0.001

q

string

Quantity

Example: 100

T

integer · int64

Trade time

Example: 1672515782136

m

boolean

Is the buyer the market maker?

Example: true

M

boolean

Ignore

Example: true

Block Trade Streams

Block Trade Streams push block trade information in real-time.

WSS

{symbol}@blockTrade

wss://stream.binance.com:9443

Update SpeedReal-time

Block Trade Streams › Stream parameters

symbol

string · required

Symbol to query

Example: bnbusdt

Block Trade Streams › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Block Trade Streams › Responses

Block Trade Streams

e

string

Event type

Example: blockTrade

E

integer · int64

Event time

Example: 1772506983582

s

string

Symbol

Example: BNBBTC

t

integer · int64

Block Trade ID

Example: 582

p

string

Price

Example: 0.052

q

string

Quantity

Example: 5838

T

integer · int64

Trade time

Example: 1772506983321

m

boolean

Is the buyer the maker?

Example: true