Skip to main content
OddsPapi aggregates 350+ bookmakers, anchored on the books that matter for price discovery rather than optimized for a headline count. The catalog available to you is determined by your key — query GET /bookmakers for the live list.

​
Categories

Sharp trading books — the core of the feed. The books that are most accurate in pricing and dominate global sports prediction (e.g. Pinnacle, Singbet, Circa Sports). These are what trading systems benchmark against, and they carry stake limits and the full delivery timestamp chain. Exchanges & prediction markets — realtime prices with orderbook depth: meta.back / meta.lay ladders of { price, size }, uniform across venues (e.g. Betfair, Polymarket). Non-sports prediction topics are covered as futures; see Coverage by sport. European, US, and crypto sportsbooks — broad retail coverage across regions (e.g. DraftKings, Stake, BC.Game). Asian lines are first-class: Asian handicap market types, quarter-line settlement (HALFWIN / HALFLOSS), and fiat + crypto rates on the currencies channel for stake and limit conversion.

​
What a book can carry

Not every capability exists at every book — what a book publishes determines what we can pass through. Check the per-book fields rather than assuming:

​
Per-book metadata

GET /bookmakers returns the catalog with the operational fields you need to plan an integration: The maxDelay* fields state the maximum expected refresh delay per mode — measured from observed vs. bookmaker change times (currently the rolling p50) where the book publishes usable timestamps, estimated otherwise. Representative p50s per book are published in Latency and freshness.

​
Status signals

Coverage is not only “is this book in the list” but “is it current right now”. The bookmakers channel reports per book, per fixture:
  • hasOdds — the book currently offers odds on this fixture
  • staleOdds — connection degraded, freshness no longer guaranteed (treat as a kill switch)
  • suspended — the book’s odds are suspended
  • participantsRotated — the book’s home/away assignment differs from the OddsPapi baseline
Wire staleOdds, suspended, marketActive, and active into a single “is this price tradeable” decision. See Reliability & Operations.

​
Discovering your catalog

Bookmaker access is granted per key, and odds, bookmakers, oddsFutures, and bookmakersFutures are bookmaker-gated channels — you receive what your key allows, intersected with any bookmakers filter you send at login. See Auth & Filters.