Prediction Trading Streams | Binance Developer Docs

Endpointwss://api.binance.com/sapi/wss

Download schema

Prediction Order Book by marketId

Order book (bid/ask) updates for one market. Only active markets are pushed.

WSS

web3_prediction_orderbook_{marketId}

wss://api.binance.com/sapi/wss

Update SpeedReal-time

Prediction Order Book by marketId › Stream parameters

marketId

string · required

Market ID to subscribe to — the marketId inside markets[] returned by market/list or market/detail. It is not marketTopicId and not externalId. A wrong id is never rejected: subscribing with marketTopicId, externalId, or with a closed or resolved market returns the same successful COMMAND reply as a correct id and then pushes nothing at all, so a stream that stays silent is far more likely a wrong id than a broken connection.

Example: 8859231

Prediction Order Book by marketId › Request

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

Raw stream: wss://api.binance.com/sapi/wss/ws/web3_prediction_orderbook_{marketId}
Combined stream via URL: wss://api.binance.com/sapi/wss/stream?streams=web3_prediction_orderbook_{marketId}
Combined stream via request: Connect to wss://api.binance.com/sapi/wss/stream, then send the SUBSCRIBE request shown below.

command

string · enum · required

Subscription command.

Enum values:

UNSUBSCRIBE

Example: SUBSCRIBE

value

string · required

Topics to subscribe to, joined by |.

Example: web3_prediction_orderbook_8859231

Prediction Order Book by marketId › Responses

Prediction Stream response

msgType

string

Message type, always orderbook.

Example: orderbook

marketId

integer · int64

Market ID of this order book, the same markets[].marketId used by the REST API.

Example: 8859231

updateTimestampMs

integer · int64

Quote update time in milliseconds (UTC). Messages for the same market may arrive out of order, so discard anything older than the snapshot you already have.

Example: 1717420800123

array[]

Ask levels sorted by price ascending, usually the top 50 or fewer; an empty array means no asks. Values may carry floating-point noise (e.g. 6865.999999999999), so round them before display.

Example: [[0.32,500],[0.33,1200.5]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

number · double · required

Price between 0 and 1 — 0.32 means 0.32 USDT per share.

Example: 0.32

[1]

number · double · required

Number of shares, decimals allowed. Always greater than 0.

Example: 500

array[]

Bid levels sorted by price descending, usually the top 50 or fewer; an empty array means no bids. Values may carry floating-point noise (e.g. 6865.999999999999), so round them before display.

Example: [[0.31,800],[0.3,2000]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

number · double · required

Price between 0 and 1 — 0.31 means 0.31 USDT per share.

Example: 0.31

[1]

number · double · required

Number of shares, decimals allowed. Always greater than 0.

Example: 800

Reward claim failed

Pushed when a claim fails completely — a single claim, or every item of a batch. For a batch, only the first failed item's amount and outcome are included.

WSS

web3_prediction_pm_claim_fail

wss://api.binance.com/sapi/wss

Update SpeedReal-time

Reward claim failed › Request

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

Raw stream: wss://api.binance.com/sapi/wss/ws/web3_prediction_pm_claim_fail
Combined stream via URL: wss://api.binance.com/sapi/wss/stream?streams=web3_prediction_pm_claim_fail
Combined stream via request: Connect to wss://api.binance.com/sapi/wss/stream, then send the SUBSCRIBE request shown below.

command

string · enum · required

Subscription command.

Enum values:

UNSUBSCRIBE

Example: SUBSCRIBE

value

string · required

Topics to subscribe to, joined by |.

Example: web3_prediction_pm_claim_fail

Reward claim failed › Responses

Prediction Stream response

pushId

string

Unique ID of this push. Use it to remove duplicates.

Example: pm_CLAIM_BATCH_20260528002_pm_claim_fail_d0e1f2a3

amount

string

Amount of the first failed claim. Rounded down to 2 decimals; shown as <0.01 if smaller.

Example: 10.00

outcome

string

Outcome name of the first failed claim, such as Yes or No; empty if unavailable.

Example: Yes

Batch claim partially succeeded

Pushed when only part of a batch claim succeeds. Only pushId is included — call the REST API for details.

WSS

web3_prediction_pm_claim_partial_success

wss://api.binance.com/sapi/wss

Update SpeedReal-time

Batch claim partially succeeded › Request

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

Raw stream: wss://api.binance.com/sapi/wss/ws/web3_prediction_pm_claim_partial_success
Combined stream via URL: wss://api.binance.com/sapi/wss/stream?streams=web3_prediction_pm_claim_partial_success
Combined stream via request: Connect to wss://api.binance.com/sapi/wss/stream, then send the SUBSCRIBE request shown below.

command

string · enum · required

Subscription command.

Enum values:

UNSUBSCRIBE

Example: SUBSCRIBE

value

string · required

Topics to subscribe to, joined by |.

Example: web3_prediction_pm_claim_partial_success

Batch claim partially succeeded › Responses

Prediction Stream response

pushId

string

Unique ID of this push. Use it to remove duplicates.

Example: pm_CLAIM_BATCH_20260528003_pm_claim_partial_success_e1f2a3b4

Reward claim succeeded

Pushed when a claim fully succeeds — a single claim, or every item of a batch. Only the total is reported; no market title or outcome is included.

WSS

web3_prediction_pm_claim_success

wss://api.binance.com/sapi/wss

Update SpeedReal-time

Reward claim succeeded › Request

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

Raw stream: wss://api.binance.com/sapi/wss/ws/web3_prediction_pm_claim_success
Combined stream via URL: wss://api.binance.com/sapi/wss/stream?streams=web3_prediction_pm_claim_success
Combined stream via request: Connect to wss://api.binance.com/sapi/wss/stream, then send the SUBSCRIBE request shown below.

command

string · enum · required

Subscription command.

Enum values:

UNSUBSCRIBE

Example: SUBSCRIBE

value

string · required

Topics to subscribe to, joined by |.

Example: web3_prediction_pm_claim_success

Reward claim succeeded › Responses

Prediction Stream response

pushId

string

Unique ID of this push. Use it to remove duplicates.

Example: pm_CLAIM_BATCH_20260528001_pm_claim_success_c9d0e1f2

amount

string

Total USDT claimed. Rounded down to 2 decimals; shown as <0.01 if smaller.

Example: 50.00

Limit order fully filled

Pushed when a limit order is fully filled.

WSS

web3_prediction_pm_limit_order_filled

wss://api.binance.com/sapi/wss

Update SpeedReal-time

Limit order fully filled › Request

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

Raw stream: wss://api.binance.com/sapi/wss/ws/web3_prediction_pm_limit_order_filled
Combined stream via URL: wss://api.binance.com/sapi/wss/stream?streams=web3_prediction_pm_limit_order_filled
Combined stream via request: Connect to wss://api.binance.com/sapi/wss/stream, then send the SUBSCRIBE request shown below.

command

string · enum · required

Subscription command.

Enum values:

UNSUBSCRIBE

Example: SUBSCRIBE

value

string · required

Topics to subscribe to, joined by |.

Example: web3_prediction_pm_limit_order_filled

Limit order fully filled › Responses

Prediction Stream response

pushId

string

Unique ID of this push. Use it to remove duplicates.

Example: pm_PM2026052812347_pm_limit_order_filled_a7b8c9d0

amount

string

Filled amount in USDT — paid for a buy, received after fees for a sell. Rounded down to 2 decimals; shown as <0.01 if smaller.

Example: 100.00

topic

string

Market title, cut to 12 characters with .. added when longer; empty if unavailable.

Example: BTC will hi..

Limit order partially filled

Pushed on each new partial fill of a limit order. One order can be pushed several times, so always remove duplicates by pushId.

WSS

web3_prediction_pm_limit_order_partial_fill

wss://api.binance.com/sapi/wss

Update SpeedReal-time

Limit order partially filled › Request

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

Raw stream: wss://api.binance.com/sapi/wss/ws/web3_prediction_pm_limit_order_partial_fill
Combined stream via URL: wss://api.binance.com/sapi/wss/stream?streams=web3_prediction_pm_limit_order_partial_fill
Combined stream via request: Connect to wss://api.binance.com/sapi/wss/stream, then send the SUBSCRIBE request shown below.

command

string · enum · required

Subscription command.

Enum values:

UNSUBSCRIBE

Example: SUBSCRIBE

value

string · required

Topics to subscribe to, joined by |.

Example: web3_prediction_pm_limit_order_partial_fill

Limit order partially filled › Responses

Prediction Stream response

pushId

string

Unique ID of this push. Use it to remove duplicates.

Example: pm_PM2026052812347_pm_limit_order_partial_fill_b8c9d0e1

amount

string

Total filled so far in USDT, not just this fill — paid for a buy, received after fees for a sell. Rounded down to 2 decimals; shown as <0.01 if smaller.

Example: 30.00

topic

string

Market title, cut to 12 characters with .. added when longer; empty if unavailable.

Example: BTC will hi..

Limit order submission failed

Pushed when a limit order is rejected when placed. No amount is included.

WSS

web3_prediction_pm_limit_submit_fail

wss://api.binance.com/sapi/wss

Update SpeedReal-time

Limit order submission failed › Request

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

Raw stream: wss://api.binance.com/sapi/wss/ws/web3_prediction_pm_limit_submit_fail
Combined stream via URL: wss://api.binance.com/sapi/wss/stream?streams=web3_prediction_pm_limit_submit_fail
Combined stream via request: Connect to wss://api.binance.com/sapi/wss/stream, then send the SUBSCRIBE request shown below.

command

string · enum · required

Subscription command.

Enum values:

UNSUBSCRIBE

Example: SUBSCRIBE

value

string · required

Topics to subscribe to, joined by |.

Example: web3_prediction_pm_limit_submit_fail

Limit order submission failed › Responses

Prediction Stream response

pushId

string

Unique ID of this push. Use it to remove duplicates.

Example: pm_PM2026052812347_pm_limit_submit_fail_f6a7b8c9

topic

string

Market title, cut to 12 characters with .. added when longer; empty if unavailable.

Example: BTC will hi..

Limit order submitted successfully

Pushed when the user's limit order is successfully placed on the order book.

WSS

web3_prediction_pm_limit_submit_success

wss://api.binance.com/sapi/wss

Update SpeedReal-time

Limit order submitted successfully › Request

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

Raw stream: wss://api.binance.com/sapi/wss/ws/web3_prediction_pm_limit_submit_success
Combined stream via URL: wss://api.binance.com/sapi/wss/stream?streams=web3_prediction_pm_limit_submit_success
Combined stream via request: Connect to wss://api.binance.com/sapi/wss/stream, then send the SUBSCRIBE request shown below.

command

string · enum · required

Subscription command.

Enum values:

UNSUBSCRIBE

Example: SUBSCRIBE

value

string · required

Topics to subscribe to, joined by |.

Example: web3_prediction_pm_limit_submit_success

Limit order submitted successfully › Responses

Prediction Stream response

pushId

string

Unique ID of this push. Use it to remove duplicates.

Example: pm_PM2026052812347_pm_limit_submit_success_e5f6a7b8

amount

string

Total order amount in USDT, before fees. Rounded down to 2 decimals; shown as <0.01 if smaller.

Example: 100.00

topic

string

Market title, cut to 12 characters with .. added when longer; empty if unavailable.

Example: BTC will hi..

Market buy order failed / expired

Pushed when the user's market buy order fails or expires.

WSS

web3_prediction_pm_market_buy_fail

wss://api.binance.com/sapi/wss

Update SpeedReal-time

Market buy order failed / expired › Request

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

Raw stream: wss://api.binance.com/sapi/wss/ws/web3_prediction_pm_market_buy_fail
Combined stream via URL: wss://api.binance.com/sapi/wss/stream?streams=web3_prediction_pm_market_buy_fail
Combined stream via request: Connect to wss://api.binance.com/sapi/wss/stream, then send the SUBSCRIBE request shown below.

command

string · enum · required

Subscription command.

Enum values:

UNSUBSCRIBE

Example: SUBSCRIBE

value

string · required

Topics to subscribe to, joined by |.

Example: web3_prediction_pm_market_buy_fail

Market buy order failed / expired › Responses

Prediction Stream response

pushId

string

Unique ID of this push. Use it to remove duplicates.

Example: pm_PM2026052812345_pm_market_buy_fail_b2c3d4e5

amount

string

Original order amount in USDT — not actually charged. Rounded down to 2 decimals; shown as <0.01 if smaller.

Example: 12.34

topic

string

Market title, cut to 12 characters with .. added when longer; empty if unavailable.

Example: BTC will hi..

Market buy order fully filled

Pushed when the user's market buy order is fully filled.

WSS

web3_prediction_pm_market_buy_success

wss://api.binance.com/sapi/wss

Update SpeedReal-time

Market buy order fully filled › Request

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

Raw stream: wss://api.binance.com/sapi/wss/ws/web3_prediction_pm_market_buy_success
Combined stream via URL: wss://api.binance.com/sapi/wss/stream?streams=web3_prediction_pm_market_buy_success
Combined stream via request: Connect to wss://api.binance.com/sapi/wss/stream, then send the SUBSCRIBE request shown below.

command

string · enum · required

Subscription command.

Enum values:

UNSUBSCRIBE

Example: SUBSCRIBE

value

string · required

Topics to subscribe to, joined by |.

Example: web3_prediction_pm_market_buy_success

Market buy order fully filled › Responses

Prediction Stream response

pushId

string

Unique ID of this push. Use it to remove duplicates.

Example: pm_PM2026052812345_pm_market_buy_success_a1b2c3d4

amount

string

USDT the user paid. Rounded down to 2 decimals; shown as <0.01 if smaller.

Example: 12.34

topic

string

Market title, cut to 12 characters with .. added when longer; empty if unavailable.

Example: BTC will hi..

Market sell order failed / expired

Pushed when the user's market sell order fails or expires.

WSS

web3_prediction_pm_market_sell_fail

wss://api.binance.com/sapi/wss

Update SpeedReal-time

Market sell order failed / expired › Request

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

Raw stream: wss://api.binance.com/sapi/wss/ws/web3_prediction_pm_market_sell_fail
Combined stream via URL: wss://api.binance.com/sapi/wss/stream?streams=web3_prediction_pm_market_sell_fail
Combined stream via request: Connect to wss://api.binance.com/sapi/wss/stream, then send the SUBSCRIBE request shown below.

command

string · enum · required

Subscription command.

Enum values:

UNSUBSCRIBE

Example: SUBSCRIBE

value

string · required

Topics to subscribe to, joined by |.

Example: web3_prediction_pm_market_sell_fail

Market sell order failed / expired › Responses

Prediction Stream response

pushId

string

Unique ID of this push. Use it to remove duplicates.

Example: pm_PM2026052812346_pm_market_sell_fail_d4e5f6a7

amount

string

USDT the user would have received after fees — not credited. Rounded down to 2 decimals; shown as <0.01 if smaller.

Example: 10.50

topic

string

Market title, cut to 12 characters with .. added when longer; empty if unavailable.

Example: ETH price..

Market sell order fully filled

Pushed when the user's market sell order is fully filled.

WSS

web3_prediction_pm_market_sell_success

wss://api.binance.com/sapi/wss

Update SpeedReal-time

Market sell order fully filled › Request

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

Raw stream: wss://api.binance.com/sapi/wss/ws/web3_prediction_pm_market_sell_success
Combined stream via URL: wss://api.binance.com/sapi/wss/stream?streams=web3_prediction_pm_market_sell_success
Combined stream via request: Connect to wss://api.binance.com/sapi/wss/stream, then send the SUBSCRIBE request shown below.

command

string · enum · required

Subscription command.

Enum values:

UNSUBSCRIBE

Example: SUBSCRIBE

value

string · required

Topics to subscribe to, joined by |.

Example: web3_prediction_pm_market_sell_success

Market sell order fully filled › Responses

Prediction Stream response

pushId

string

Unique ID of this push. Use it to remove duplicates.

Example: pm_PM2026052812346_pm_market_sell_success_c3d4e5f6

amount

string

USDT the user received, after fees. Rounded down to 2 decimals; shown as <0.01 if smaller.

Example: 10.50

topic

string

Market title, cut to 12 characters with .. added when longer; empty if unavailable.

Example: ETH price..

Fund transfer failed

Pushed when a fund transfer fails.

WSS

web3_prediction_pm_transfer_fail

wss://api.binance.com/sapi/wss

Update SpeedReal-time

Fund transfer failed › Request

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

Raw stream: wss://api.binance.com/sapi/wss/ws/web3_prediction_pm_transfer_fail
Combined stream via URL: wss://api.binance.com/sapi/wss/stream?streams=web3_prediction_pm_transfer_fail
Combined stream via request: Connect to wss://api.binance.com/sapi/wss/stream, then send the SUBSCRIBE request shown below.

command

string · enum · required

Subscription command.

Enum values:

UNSUBSCRIBE

Example: SUBSCRIBE

value

string · required

Topics to subscribe to, joined by |.

Example: web3_prediction_pm_transfer_fail

Fund transfer failed › Responses

Prediction Stream response

pushId

string

Unique ID of this push. Use it to remove duplicates.

Example: pm_TRANSFER_20260528002_pm_transfer_fail_a3b4c5d6

amount

string

Amount of the attempted transfer. Rounded down to 2 decimals; shown as <0.01 if smaller.

Example: 100.00

Fund transfer succeeded

Pushed when a fund transfer into or out of the prediction wallet succeeds. The direction and the token are not included (currently USDT only).

WSS

web3_prediction_pm_transfer_success

wss://api.binance.com/sapi/wss

Update SpeedReal-time

Fund transfer succeeded › Request

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

Raw stream: wss://api.binance.com/sapi/wss/ws/web3_prediction_pm_transfer_success
Combined stream via URL: wss://api.binance.com/sapi/wss/stream?streams=web3_prediction_pm_transfer_success
Combined stream via request: Connect to wss://api.binance.com/sapi/wss/stream, then send the SUBSCRIBE request shown below.

command

string · enum · required

Subscription command.

Enum values:

UNSUBSCRIBE

Example: SUBSCRIBE

value

string · required

Topics to subscribe to, joined by |.

Example: web3_prediction_pm_transfer_success

Fund transfer succeeded › Responses

Prediction Stream response

pushId

string

Unique ID of this push. Use it to remove duplicates.

Example: pm_TRANSFER_20260528001_pm_transfer_success_f2a3b4c5

amount

string

Amount transferred. Rounded down to 2 decimals; shown as <0.01 if smaller.

Example: 100.00

Market resolution notification

Pushed when a market is resolved, to every user holding a position in it, win or lose. No amount or outcome is included — call the REST API for the user's profit and loss.

WSS

web3_prediction_pm_market_close

wss://api.binance.com/sapi/wss

Update SpeedReal-time

Market resolution notification › Request

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

Raw stream: wss://api.binance.com/sapi/wss/ws/web3_prediction_pm_market_close
Combined stream via URL: wss://api.binance.com/sapi/wss/stream?streams=web3_prediction_pm_market_close
Combined stream via request: Connect to wss://api.binance.com/sapi/wss/stream, then send the SUBSCRIBE request shown below.

command

string · enum · required

Subscription command.

Enum values:

UNSUBSCRIBE

Example: SUBSCRIBE

value

string · required

Topics to subscribe to, joined by |.

Example: web3_prediction_pm_market_close

Market resolution notification › Responses

Prediction Stream response

pushId

string

Unique ID of this push. Use it to remove duplicates.

Example: pm_8859231_pm_market_close_b4c5d6e7

topic

string

Market title, cut to 12 characters with .. added when longer; empty if unavailable.

Example: BTC will hi..