Current prices in one call
Best bid, best ask, sizes, mid, spread and last trade for up to 100 matches. Each match also gets the sum of the three mids and the widest spread, so you can reject a thin book.
GET /quotesPolymarket soccer · order books · live and replay
Home, draw and away order books for about 300 soccer matches at a time, from 36 hours before kickoff to 4 hours after. Read the current price in one call, or ask what the book looked like at any past moment.
Measured on the collector in November 2026. The number of matches changes with the fixture calendar.
What you get
Every message from the exchange is stored before it is parsed. The books are rebuilt from that log, so live data and history come from the same source.
Best bid, best ask, sizes, mid, spread and last trade for up to 100 matches. Each match also gets the sum of the three mids and the widest spread, so you can reject a thin book.
GET /quotesAsk for a match "as of" any timestamp. You get only what was observable at that moment, with the age of each quote, so a backtest cannot see the future.
GET /matches/{id}/state?at=Up to 20 price levels on each side of each contract, now or at a past time. The rebuilt books were checked level by level against the exchange's own book.
GET /markets/{asset}/book?at=Live score, minute and status merged with every quote in the order they arrived. Line up how home, draw and away moved around each goal.
GET /matches/{id}/timelineStable league keys with the season split out, kickoff windows, and an updated_since filter so your sync reads only what changed.
Reconnects, crossed books and stale levels are flagged, never hidden. A quote that cannot be trusted says so, and a stale feed answers 503 at once.
The API
Read-only REST under /api/v1. No SDK needed.
"0.47". No float rounding./quotes answers 503 feed_stale with Retry-After instead of old prices.{"error", "message"}.Response shapes are real. The values are an example.
Coverage
The collector follows each listed match with a home, draw and away market. The league tier sets how finely the book is stored. The raw log keeps every message for every tier.
Live score and minute come from Polymarket's sports feed, which covers only part of the matches (36 of about 100 on 2026-11-09). The other matches have a final result from the market resolution.
Who uses it
Market prices with real money behind them, stored so that you can test against them honestly.
Measure how fast the market reprices after a goal, a red card or a lineup leak. Replay with ?at= so that the model sees only what was known.
Use fair, live odds as the difficulty of each pick. One /quotes call before kickoff prices a whole round of matches.
Compare your own probabilities with the exchange's mid price and spread at kickoff, and with the final result.
Pricing
All plans read the same feed. They differ in the endpoints, the history and the call volume. During the beta we set the price with each team.
For apps and games that need current prices before kickoff.
For research and models that need the book and its history.
?at=For teams that want the raw message log and longer history.
Questions
From Polymarket's public market feed, sports feed and event API. Our collector records every message as it arrives and rebuilds the order books from that log. We are not affiliated with Polymarket.
Each response tells you the time it is current to and the age of each quote. In normal operation that is seconds. If the feed falls more than 5 minutes behind, the API answers with an error instead of an old price.
The match-winner market of each soccer match: three contracts for home win, draw and away win, settled on the result after 90 minutes. Half-time, exact score and other side markets are not included.
No. Live score and minute come from Polymarket's sports feed, which covers only part of the matches. Every match gets its final result from the market resolution.
Polymarket also lists NBA, NHL, NFL, college basketball and UFC with full schedules. They are on the roadmap. Tell us in the access form which ones you need.
Access
Keys are given out by hand while we are in beta. Tell us what you are building, and we will send a key and the docs.