Feeds / Polymarket (live)

Polymarket — prediction markets

Prediction markets (yes/no and multi-outcome): politics, sports, crypto, economics; the 200 markets with the most 24-hour volume. A full book per token on subscribe (and again after trades), then price_change messages that give the new absolute size of a price level together with the exchange's best bid and ask.

Live in productionWebSocketFull book

Live now

-
books live
-
messages / s
-
level changes / s
-
KB / s

Messages / s and KB / s are what our handler receives from the exchange (KB after decompression, REST snapshots included); level changes / s are counted after normalization, for the markets we publish.

Open live books

How we connect

Market
Prediction markets (yes/no and multi-outcome): politics, sports, crypto, economics; the 200 markets with the most 24-hour volume
WebSocket
wss://ws-subscriptions-clob.polymarket.com/ws/market
Channels
market — one connection carries every subscribed token: book, price_change, last_trade_price, tick_size_change
Update model
A full book per token on subscribe (and again after trades), then price_change messages that give the new absolute size of a price level together with the exchange's best bid and ask. Our book is the market's first outcome (usually YES), priced in dollars from $0 to $1.
Snapshot (REST)
https://gamma-api.polymarket.com/markets?active=true&closed=false&order=volume24hr&ascending=false&limit=50 (market list, paged by 50; books come over the WebSocket)
Sequencing
No sequence numbers. Every change is checked against the best bid and ask the exchange sends with it; a book that disagrees for more than 5 s is treated as out of sync.
On a gap
On a dropped connection the hot standby takes over and replays its buffered messages from the last applied exchange timestamp, so no resync is needed. If both connections are down, or a book stays out of line with the exchange's best prices, the handler reconnects and resubscribes for fresh books. Every 10 minutes a new capture file opens with the handler's own full books.
Depth
Full book
Authentication
None: the market channel and the Gamma market list are public.
Heartbeat
We send a text PING every 8 s and the server answers PONG. A dropped connection is retried after 1 s; 30 s without data on a connection counts as a drop.
Symbol format
30917853047681848974124763406524368436482316036542704956055886396093348090575

Subscribe message

{"assets_ids":["30917853047681848974124763406524368436482316036542704956055886396093348090575",...],"type":"market","operation":"subscribe"}

What our handler takes care of

Instruments

loading...

Official documentation

Polymarket — real-time data (WebSocket market channel) ↗docs.polymarket.comPolymarket — prices and order books ↗docs.polymarket.comPolymarket — order book concepts ↗docs.polymarket.comPolymarket — discover markets (Gamma API) ↗docs.polymarket.comPolymarket — rate limits ↗docs.polymarket.comPolymarket — changelog ↗docs.polymarket.comSystem status ↗status.polymarket.com

Links go to the exchange's own documentation; it is theirs and may change. Our handler follows the version described above.