Pro+

Orderbook Channel

Watch orderbook depth shift in real time. Get top-of-book bid/ask prices and USD depth for every subscribed market, the moment levels change.

Requires Pro tier. This channel is not available on the Free tier. View plans & pricing

Access & scope

Available on
ProEnterprise
Subscription scope
market_ids

Orderbook data is per-market. Subscribe with specific market IDs.

Subscribe

client → server
json
{"action": "subscribe", "channel": "orderbook", "market_ids": ["12345"]}

Example message

Each update delivers the current top-of-book snapshot as an orderbook_update message.

server → client
json
{
  "channel": "orderbook",
  "type": "orderbook_update",
  "ts": 1712847600.123,
  "data": {
    "type": "orderbook_update",
    "market_id": "12345",
    "source": "polymarket",
    "yes": {"bid": 0.65, "ask": 0.67, "bid_usd": 1250.0, "ask_usd": 800.0},
    "no":  {"bid": 0.33, "ask": 0.35, "bid_usd": 950.0,  "ask_usd": 1100.0}
  }
}
Tip

The bid_usd and ask_usd fields reflect dollar depth at the top of book where supported by the venue.