Market Streams

Endpointwss://nbstream.binance.com/equity

Price Stream

Push-all price snapshot, polled every 3 seconds. One message carries the latest price for every active US-equity symbol. Also reachable via the SUBSCRIBE/UNSUBSCRIBE RPC — see Subscribing via RPC.

WSS

price

wss://nbstream.binance.com/equity

Price Stream › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Price Stream › Responses

Price Stream

e

string

Event type, always "price".

Example: price

object[]

One entry per symbol.

s

string

Symbol (UPPERCASE ticker), e.g. "AAPL".

Example: AAPL

ac

string

Internal asset code, EQ_{symbol}. Reference only; do not use as a trading identifier.

Example: EQ_AAPL

p

string

Latest price, trailing-zero stripped.

Example: 182.5

t

integer | null · int64

Price time (epoch milliseconds UTC); may be null.

Example: 1710320400000

pc

string

Previous day's RTH close price (reference); absent when unknown.

Example: 181.2000

tc

string

Today's RTH close price; absent before After-Hours.

Example: 182.0000

mp

string · enum

Per-symbol market phase: C Closed, ON Overnight, PRE Pre-Market, O Market Open, POST Post-Market.

Enum values:

PRE

POST

Example: O

Quote Stream

Per-symbol real-time best-bid / best-ask. Each symbol has its own stream. Per-symbol throttle: at most one push per symbol every 200 ms. Also reachable via the SUBSCRIBE/UNSUBSCRIBE RPC — see Subscribing via RPC.

WSS

{symbol}@quote

wss://nbstream.binance.com/equity

Quote Stream › Stream parameters

symbol

string · required

US-equity ticker (UPPERCASE), e.g. AAPL.

Example: AAPL

Quote Stream › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Quote Stream › Responses

Quote Stream

e

string

Event type, always "quote".

Example: quote

E

integer · int64

Event time — epoch milliseconds when the server pushed the message.

Example: 1710320400000

s

string

Symbol (UPPERCASE ticker), e.g. "AAPL".

Example: AAPL

bp

string

Best bid price.

Example: 182.50

ap

string

Best ask price.

Example: 182.55

bs

integer

Best bid size (shares).

Example: 100

as

integer

Best ask size (shares).

Example: 200

T

integer | null · int64

Source quote timestamp (epoch milliseconds); may be null.

Example: 1710320399500

Kline Stream

Per-symbol candlestick updates. One stream per (symbol, interval) combination. Supported intervals: 5m, 1h, 1d, 1w, 1M. Also reachable via the SUBSCRIBE/UNSUBSCRIBE RPC — see Subscribing via RPC.

WSS

{symbol}@kline_{interval}

wss://nbstream.binance.com/equity

Kline Stream › Stream parameters

symbol

string · required

US-equity ticker (UPPERCASE), e.g. AAPL.

Example: AAPL

interval

string · required

Kline interval — 5m / 1h / 1d / 1w / 1M.

Example: 5m

Kline Stream › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Kline Stream › Responses

Kline Stream

e

string

Event type, always "kline".

Example: kline

E

integer · int64

Event time (epoch milliseconds); server-side system time when the message is pushed.

Example: 1710320400000

s

string

Symbol (UPPERCASE ticker).

Example: AAPL

object

Candlestick payload.

t

integer · int64

Open time (epoch milliseconds).

Example: 1710316800000

ct

integer · int64

Close time (epoch milliseconds). For fixed intervals: openTime + duration − 1ms. For 1M: last day of month at 23:59:59.999 UTC.

Example: 1710317099999

s

string

Symbol (UPPERCASE ticker).

Example: AAPL

i

string · enum

Interval — "5m" / "1h" / "1d" / "1w" / "1M".

Enum values:

Example: 5m

o

string

Open price.

Example: 182.50

c

string

Close price (latest print within the interval).

Example: 183.20

h

string

High price.

Example: 183.50

l

string

Low price.

Example: 182.30

v

string

Volume (shares), default "0".

Example: 15000

n

integer | null

Trade count; absent when upstream did not populate.

Example: 120

x

boolean

Candle is closed — true once the interval has ended.

Example: false

vw

string | null

VWAP (volume-weighted average price); absent when upstream did not populate.

Example: 182.95

Calendar Stream

Single-stream broadcast of market-phase transitions. One message per transition; no periodic heartbeat payload. Server polls every 5 seconds. Also reachable via the SUBSCRIBE/UNSUBSCRIBE RPC — see Subscribing via RPC.

WSS

calendar

wss://nbstream.binance.com/equity

Calendar Stream › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Calendar Stream › Responses

Calendar Stream

e

string

Event type, always "calendar".

Example: calendar

from

string · enum

Previous market phase.

Enum values:

MARKET_CLOSED

OVERNIGHT

PRE_MARKET

MARKET_OPEN

POST_MARKET

Example: PRE_MARKET

to

string · enum

New market phase.

Enum values:

MARKET_CLOSED

OVERNIGHT

PRE_MARKET

MARKET_OPEN

POST_MARKET

Example: MARKET_OPEN

ts

integer · int64

Event timestamp (epoch milliseconds UTC) when the transition was detected.

Example: 1710334200000

Tradability Stream

Per-symbol push whenever the tradable direction of a symbol changes. Pushed only when the value actually changes (new value ≠ old value). Also reachable via the SUBSCRIBE/UNSUBSCRIBE RPC — see Subscribing via RPC.

WSS

{symbol}@tradability

wss://nbstream.binance.com/equity

Tradability Stream › Stream parameters

symbol

string · required

US-equity ticker (UPPERCASE), e.g. AAPL.

Example: AAPL

Tradability Stream › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Tradability Stream › Responses

Tradability Stream

e

string

Event type, always "tradability".

Example: tradability

symbol

string

Symbol (UPPERCASE ticker).

Example: AAPL

assetCode

string | null

Internal asset code EQ_{symbol}; reference only. May be null for symbols not yet in the symbol dictionary.

Example: EQ_AAPL

tradability

string · enum

The new tradability value. OFFMARKET and DELISTING are protected states — trading-status events will not transition a symbol out of them.

Enum values:

BUY_SELL

BUY

SELL

NONE

OFFMARKET

DELISTING

Example: BUY_SELL

t

integer · int64

Push time (epoch milliseconds UTC).

Example: 1712345678000

Trading Status Stream

Per-symbol trading-status transitions (halts, resumes, SSR, LULD pauses, etc.). Events that do not match a known status/reason rule are not pushed. Also reachable via the SUBSCRIBE/UNSUBSCRIBE RPC — see Subscribing via RPC.

WSS

{symbol}@tradingStatus

wss://nbstream.binance.com/equity

Trading Status Stream › Stream parameters

symbol

string · required

US-equity ticker (UPPERCASE), e.g. AAPL.

Example: AAPL

Trading Status Stream › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Trading Status Stream › Responses

Trading Status Stream

e

string

Event type, always "tradingStatus".

Example: tradingStatus

symbol

string

Symbol (UPPERCASE ticker), e.g. "AAPL".

Example: AAPL

assetCode

string

Internal asset code EQ_{symbol}; reference only.

Example: EQ_AAPL

status

string · enum

Trading status.

Enum values:

TRADING_HALTED

TRADING_PAUSED

SHORT_SALE_RESTRICTED

TRADING_RESUMED

QUOTATION_RESUMED

TRADING_SUSPENDED

UNAVAILABLE

Example: TRADING_HALTED

msg

string

Reason code.

Example: MATERIAL_NEWS

time

integer · int64

Status-effective time (epoch milliseconds UTC). May be in the future.

Example: 1614021300000

z

string · enum

Tape designation: C = CTA (NYSE / AMEX), N = UTP (Nasdaq).

Enum values:

Example: C

tradability

string · enum

Tradability after the status change: BUY_SELL / BUY / SELL / NONE.

Enum values:

BUY_SELL

BUY

SELL

NONE

Example: NONE

Market Streams

Endpointwss://nbstream.binance.com/equity

Download schema

Price Stream

Push-all price snapshot, polled every 3 seconds. One message carries the latest price for every active US-equity symbol. Also reachable via the SUBSCRIBE/UNSUBSCRIBE RPC — see Subscribing via RPC.

WSS

price

wss://nbstream.binance.com/equity

Price Stream › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Price Stream › Responses

Price Stream

e

string

Event type, always "price".

Example: price

object[]

One entry per symbol.

s

string

Symbol (UPPERCASE ticker), e.g. "AAPL".

Example: AAPL

ac

string

Internal asset code, EQ_{symbol}. Reference only; do not use as a trading identifier.

Example: EQ_AAPL

p

string

Latest price, trailing-zero stripped.

Example: 182.5

t

integer | null · int64

Price time (epoch milliseconds UTC); may be null.

Example: 1710320400000

pc

string

Previous day's RTH close price (reference); absent when unknown.

Example: 181.2000

tc

string

Today's RTH close price; absent before After-Hours.

Example: 182.0000

mp

string · enum

Per-symbol market phase: C Closed, ON Overnight, PRE Pre-Market, O Market Open, POST Post-Market.

Enum values:

PRE

POST

Example: O

Quote Stream

WSS

{symbol}@quote

wss://nbstream.binance.com/equity

Quote Stream › Stream parameters

symbol

string · required

US-equity ticker (UPPERCASE), e.g. AAPL.

Example: AAPL

Quote Stream › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Quote Stream › Responses

Quote Stream

e

string

Event type, always "quote".

Example: quote

E

integer · int64

Event time — epoch milliseconds when the server pushed the message.

Example: 1710320400000

s

string

Symbol (UPPERCASE ticker), e.g. "AAPL".

Example: AAPL

bp

string

Best bid price.

Example: 182.50

ap

string

Best ask price.

Example: 182.55

bs

integer

Best bid size (shares).

Example: 100

as

integer

Best ask size (shares).

Example: 200

T

integer | null · int64

Source quote timestamp (epoch milliseconds); may be null.

Example: 1710320399500

Kline Stream

Per-symbol candlestick updates. One stream per (symbol, interval) combination. Supported intervals: 5m, 1h, 1d, 1w, 1M. Also reachable via the SUBSCRIBE/UNSUBSCRIBE RPC — see Subscribing via RPC.

WSS

{symbol}@kline_{interval}

wss://nbstream.binance.com/equity

Kline Stream › Stream parameters

symbol

string · required

US-equity ticker (UPPERCASE), e.g. AAPL.

Example: AAPL

interval

string · required

Kline interval — 5m / 1h / 1d / 1w / 1M.

Example: 5m

Kline Stream › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Kline Stream › Responses

Kline Stream

e

string

Event type, always "kline".

Example: kline

E

integer · int64

Event time (epoch milliseconds); server-side system time when the message is pushed.

Example: 1710320400000

s

string

Symbol (UPPERCASE ticker).

Example: AAPL

object

Candlestick payload.

t

integer · int64

Open time (epoch milliseconds).

Example: 1710316800000

ct

integer · int64

Close time (epoch milliseconds). For fixed intervals: openTime + duration − 1ms. For 1M: last day of month at 23:59:59.999 UTC.

Example: 1710317099999

s

string

Symbol (UPPERCASE ticker).

Example: AAPL

i

string · enum

Interval — "5m" / "1h" / "1d" / "1w" / "1M".

Enum values:

Example: 5m

o

string

Open price.

Example: 182.50

c

string

Close price (latest print within the interval).

Example: 183.20

h

string

High price.

Example: 183.50

l

string

Low price.

Example: 182.30

v

string

Volume (shares), default "0".

Example: 15000

n

integer | null

Trade count; absent when upstream did not populate.

Example: 120

x

boolean

Candle is closed — true once the interval has ended.

Example: false

vw

string | null

VWAP (volume-weighted average price); absent when upstream did not populate.

Example: 182.95

Calendar Stream

WSS

calendar

wss://nbstream.binance.com/equity

Calendar Stream › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Calendar Stream › Responses

Calendar Stream

e

string

Event type, always "calendar".

Example: calendar

from

string · enum

Previous market phase.

Enum values:

MARKET_CLOSED

OVERNIGHT

PRE_MARKET

MARKET_OPEN

POST_MARKET

Example: PRE_MARKET

to

string · enum

New market phase.

Enum values:

MARKET_CLOSED

OVERNIGHT

PRE_MARKET

MARKET_OPEN

POST_MARKET

Example: MARKET_OPEN

ts

integer · int64

Event timestamp (epoch milliseconds UTC) when the transition was detected.

Example: 1710334200000

Tradability Stream

WSS

{symbol}@tradability

wss://nbstream.binance.com/equity

Tradability Stream › Stream parameters

symbol

string · required

US-equity ticker (UPPERCASE), e.g. AAPL.

Example: AAPL

Tradability Stream › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Tradability Stream › Responses

Tradability Stream

e

string

Event type, always "tradability".

Example: tradability

symbol

string

Symbol (UPPERCASE ticker).

Example: AAPL

assetCode

string | null

Internal asset code EQ_{symbol}; reference only. May be null for symbols not yet in the symbol dictionary.

Example: EQ_AAPL

tradability

string · enum

The new tradability value. OFFMARKET and DELISTING are protected states — trading-status events will not transition a symbol out of them.

Enum values:

BUY_SELL

BUY

SELL

NONE

OFFMARKET

DELISTING

Example: BUY_SELL

t

integer · int64

Push time (epoch milliseconds UTC).

Example: 1712345678000

Trading Status Stream

WSS

{symbol}@tradingStatus

wss://nbstream.binance.com/equity

Trading Status Stream › Stream parameters

symbol

string · required

US-equity ticker (UPPERCASE), e.g. AAPL.

Example: AAPL

Trading Status Stream › Request

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

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

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Trading Status Stream › Responses

Trading Status Stream

e

string

Event type, always "tradingStatus".

Example: tradingStatus

symbol

string

Symbol (UPPERCASE ticker), e.g. "AAPL".

Example: AAPL

assetCode

string

Internal asset code EQ_{symbol}; reference only.

Example: EQ_AAPL

status

string · enum

Trading status.

Enum values:

TRADING_HALTED

TRADING_PAUSED

SHORT_SALE_RESTRICTED

TRADING_RESUMED

QUOTATION_RESUMED

TRADING_SUSPENDED

UNAVAILABLE

Example: TRADING_HALTED

msg

string

Reason code.

Example: MATERIAL_NEWS

time

integer · int64

Status-effective time (epoch milliseconds UTC). May be in the future.

Example: 1614021300000

z

string · enum

Tape designation: C = CTA (NYSE / AMEX), N = UTP (Nasdaq).

Enum values:

Example: C

tradability

string · enum

Tradability after the status change: BUY_SELL / BUY / SELL / NONE.

Enum values:

BUY_SELL

BUY

SELL

NONE

Example: NONE