User Streams

Endpointwss://nbstream.binance.com/equity

Order Report Stream

Real-time push of the authenticated user's order state transitions — both open-state updates (ORDER_UPDATE) and terminal-state notifications (ORDER_TERMINAL). Prerequisite: obtain a listenKey via the Listen Key endpoint first.

WSS

{listenKey}@orderReport

wss://nbstream.binance.com/equity

Order Report Stream › Stream parameters

listenKey

string · required

User data listen key obtained from the Listen Key endpoint.

Example: pqia91ma19a5s61cv6a81va65sdf19v8a65a1a5s6af0dkfj2a97b8a91d

Order Report Stream › Request

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

Raw stream: wss://nbstream.binance.com/equity/ws/{listenKey}@orderReport
Combined stream via URL: wss://nbstream.binance.com/equity/stream?streams={listenKey}@orderReport
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: ["pqia91ma19a5s61cv6a81va65sdf19v8a65a1a5s6af0dkfj2a97b8a91d@orderReport"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Order Report Stream › Responses

Order Report Stream

e

string

Event type, always "orderReport".

Example: orderReport

E

integer · int64

Event time (epoch milliseconds); server push time.

Example: 1710000000000

x

string · enum

Execution type: "ORDER_UPDATE" (still open) or "ORDER_TERMINAL" (reached terminal state).

Enum values:

ORDER_UPDATE

ORDER_TERMINAL

Example: ORDER_UPDATE

i

string

Order ID (UUID).

Example: b0b6dd9d-8b9b-48a9-ba46-b9d54906e415

ai

string

Asset ID (internal identifier).

Example: 4ce9353c-66d1-46c2-898f-fce867ab0247

b

string

Base asset — the internal asset code with an EQ_ prefix (e.g. "EQ_AAPL"), not the bare ticker used in REST responses / order input. Strip the EQ_ prefix to match a symbol used elsewhere.

Example: EQ_AAPL

q

string

Quote currency, e.g. "USD".

Example: USD

S

string

Order side: "buy" or "sell". Note: lowercase, unlike REST responses.

Example: buy

o

string

Order type: "market" / "limit" / "stop" / "stop_limit" / "trailing_stop". Note: lowercase.

Example: limit

p

number | null

Limit price; null for market orders.

Example: 185.5

Q

number

Order quantity (shares); 0 when the order was submitted as notional.

Example: 10

N

number | null

Order notional; set when the order was submitted as notional (market buy), null when submitted as quantity.

Example: null

fq

number

Filled quantity.

Example: 5

FN

number

Filled notional (= filledQty × filledAvgPrice).

Example: 927.5

tc

number

Total cost — cumulative buy-in cost including the commission fee.

Example: 1856.2

Z

number

Fill progress percentage (0–100, 2 dp). By notional: FN / N × 100. By qty: fq / Q × 100.

Example: 50

n

string

Trading session label, e.g. "Regular", "24 Hours Trading".

Example: Regular

s

string

Order status, e.g. "accepted", "partially_filled", "filled", "canceled". Note: lowercase, unlike REST responses.

Example: partially_filled

T

integer · int64

Order create time (epoch milliseconds).

Example: 1710000000000

U

integer · int64

Order update time (epoch milliseconds).

Example: 1710000060000

WSS{listenKey}@orderReport

wscat -c wss://nbstream.binance.com/equity/stream -x '{
  "method": "SUBSCRIBE",
  "params": [
    "pqia91ma19a5s61cv6a81va65sdf19v8a65a1a5s6af0dkfj2a97b8a91d@orderReport"
  ],
  "id": "e9d6b4349871b40611412680b3445fac"
}' -w 30

Example Request

{
  "method": "SUBSCRIBE",
  "params": [
    "pqia91ma19a5s61cv6a81va65sdf19v8a65a1a5s6af0dkfj2a97b8a91d@orderReport"
  ],
  "id": "e9d6b4349871b40611412680b3445fac"
}

json

application/json

Example Responses

{
  "e": "orderReport",
  "E": 1710000000000,
  "x": "ORDER_UPDATE",
  "i": "b0b6dd9d-8b9b-48a9-ba46-b9d54906e415",
  "ai": "4ce9353c-66d1-46c2-898f-fce867ab0247",
  "b": "EQ_AAPL",
  "q": "USD",
  "S": "buy",
  "o": "limit",
  "p": 185.5,
  "Q": 10,
  "N": null,
  "fq": 5,
  "FN": 927.5,
  "tc": 1856.2,
  "Z": 50,
  "n": "Regular",
  "s": "partially_filled",
  "T": 1710000000000,
  "U": 1710000060000
}

json

application/json

Order Report Stream

WSS

{listenKey}@orderReport

wss://nbstream.binance.com/equity

Order Report Stream › Stream parameters

listenKey

string · required

User data listen key obtained from the Listen Key endpoint.

Example: pqia91ma19a5s61cv6a81va65sdf19v8a65a1a5s6af0dkfj2a97b8a91d

Order Report Stream › Request

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

Raw stream: wss://nbstream.binance.com/equity/ws/{listenKey}@orderReport
Combined stream via URL: wss://nbstream.binance.com/equity/stream?streams={listenKey}@orderReport
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: ["pqia91ma19a5s61cv6a81va65sdf19v8a65a1a5s6af0dkfj2a97b8a91d@orderReport"]

id

string · required

Unique WebSocket request ID.

Example: e9d6b4349871b40611412680b3445fac

Order Report Stream › Responses

Order Report Stream

e

string

Event type, always "orderReport".

Example: orderReport

E

integer · int64

Event time (epoch milliseconds); server push time.

Example: 1710000000000

x

string · enum

Execution type: "ORDER_UPDATE" (still open) or "ORDER_TERMINAL" (reached terminal state).

Enum values:

ORDER_UPDATE

ORDER_TERMINAL

Example: ORDER_UPDATE

i

string

Order ID (UUID).

Example: b0b6dd9d-8b9b-48a9-ba46-b9d54906e415

ai

string

Asset ID (internal identifier).

Example: 4ce9353c-66d1-46c2-898f-fce867ab0247

b

string

Base asset — the internal asset code with an EQ_ prefix (e.g. "EQ_AAPL"), not the bare ticker used in REST responses / order input. Strip the EQ_ prefix to match a symbol used elsewhere.

Example: EQ_AAPL

q

string

Quote currency, e.g. "USD".

Example: USD

S

string

Order side: "buy" or "sell". Note: lowercase, unlike REST responses.

Example: buy

o

string

Order type: "market" / "limit" / "stop" / "stop_limit" / "trailing_stop". Note: lowercase.

Example: limit

p

number | null

Limit price; null for market orders.

Example: 185.5

Q

number

Order quantity (shares); 0 when the order was submitted as notional.

Example: 10

N

number | null

Order notional; set when the order was submitted as notional (market buy), null when submitted as quantity.

Example: null

fq

number

Filled quantity.

Example: 5

FN

number

Filled notional (= filledQty × filledAvgPrice).

Example: 927.5

tc

number

Total cost — cumulative buy-in cost including the commission fee.

Example: 1856.2

Z

number

Fill progress percentage (0–100, 2 dp). By notional: FN / N × 100. By qty: fq / Q × 100.

Example: 50

n

string

Trading session label, e.g. "Regular", "24 Hours Trading".

Example: Regular

s

string

Order status, e.g. "accepted", "partially_filled", "filled", "canceled". Note: lowercase, unlike REST responses.

Example: partially_filled

T

integer · int64

Order create time (epoch milliseconds).

Example: 1710000000000

U

integer · int64

Order update time (epoch milliseconds).

Example: 1710000060000