Private beta: prices are set with each team. Write to api-info@sporticker.com.

Polymarket soccer · order books · live and replay

Every price move around every goal.

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.

Every order-book update kept Live score and minute Point-in-time replay
Home FC vs. Away United
Mid price of the three outcome contracts, kickoff to full time
Example data
58'
Home win
–
–
Draw
–
–
Away win
–
–
~315
matches followed at the same time
112
league feeds seen in one day
3
contracts per match: home, draw, away
20
price levels per side in each book
40 h
window: 36 h before kickoff, 4 h after

Measured on the collector in November 2026. The number of matches changes with the fixture calendar.

What you get

One feed. Six ways to read it.

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.

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 /quotes

Point-in-time replay

Ask 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=

Full order-book depth

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=

Score and price on one timeline

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}/timeline

Leagues and fixtures

Stable league keys with the season split out, kickoff windows, and an updated_since filter so your sync reads only what changed.

GET /leagues · GET /matches

Gaps you can see

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.

GET /data-quality

The API

Plain JSON over HTTP.

Read-only REST under /api/v1. No SDK needed.

  • Prices and sizes are decimal strings, like "0.47". No float rounding.
  • All times are ISO 8601 in UTC. Each quote has the exchange time and the time we received it.
  • Stable ids: a match id never changes, also after a rebuild.
  • If the feed falls more than 5 minutes behind, /quotes answers 503 feed_stale with Retry-After instead of old prices.
  • One error shape everywhere: {"error", "message"}.

        

Response shapes are real. The values are an example.

Coverage

Every soccer match-winner market on Polymarket.

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.

High tier

WebSocket
Top of book
every change
Full depth
every 5 s
Trades
every trade
Premier LeagueLa LigaSerie ABundesligaLigue 1UEFA competitions

Normal tier

WebSocket
Top of book
at most every 2 s
Full depth
every 15 s
Trades
every trade
ChampionshipEredivisiePrimeira LigaLiga MXBrasileirãoLiga ProfesionalMLS

Low tier

REST snapshots
Book snapshot
every 60 s
Full depth
on each snapshot
Trades
last price only
Lower divisionsSmaller national leaguesClub friendliesEvery unlisted league

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

Built for people who price football.

Market prices with real money behind them, stored so that you can test against them honestly.

Quant research

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.

Prediction games and apps

Use fair, live odds as the difficulty of each pick. One /quotes call before kickoff prices a whole round of matches.

Model checks

Compare your own probabilities with the exchange's mid price and spread at kickoff, and with the final result.

Pricing

Pay for the depth you need.

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.

Starter

Betaprice on request

For apps and games that need current prices before kickoff.

  • /quotes, /matches, /leagues
  • All leagues, all tiers
  • 5,000 calls per day
  • Replay and depth endpoints
Choose Starter

Data

Custom

For teams that want the raw message log and longer history.

  • Everything in Pro
  • Bulk export of the raw log and Parquet tables
  • History beyond 14 days
  • Custom call limits
Talk to us

Questions

Before you subscribe

Where does the data come from?

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.

How fresh is a "current" price?

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.

Which markets are included?

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.

Do you have live scores for every match?

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.

Are other sports coming?

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

Get an API key.

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.

This page does not send anything. It writes your request so that you can copy it into an email.