What is The Odds API?
Supported data includes moneyline, spreads, totals, selected futures, player props and alternate lines. Decimal or American odds are available alongside teams, start times, bookmaker-update timestamps and supported scores or results. Coverage and refresh intervals vary by sport, book and market.
Use REST for an application or Excel and Google Sheets add-ons for a spreadsheet workflow. Eligible plans offer past snapshots, whose availability differs from free current-odds access. A useful comparison still needs the same event and settlement definition, an explicit bookmaker-margin adjustment and a snapshot available before the historical decision time.
Who it is for
- For developers building sports-price comparisons and researchers studying historical bookmaker lines.
- For spreadsheet users maintaining a sports dashboard without writing their own API client.
Features and coverage
- Bookmaker and market selection
Choose supported regional books and moneyline, spread, total, selected futures, prop or alternate-line markets; request decimal or American odds.
- Metadata, scores and history
Read teams, starts and bookmaker-update times, retrieve supported results and query available historical snapshots on eligible plans.
- API or spreadsheet access
Integrate REST data in code or use the offered Excel and Google Sheets add-ons.
Workflows with The Odds API
Construct a reference probability
Match the event and settlement terms, retrieve both sides and remove bookmaker margin with a specified method before comparing a prediction contract.
Avoid a later snapshot
For a historical entry, use an available snapshot from before the entry time and inspect its bookmaker timestamps.
Budget polling credits
Estimate consumption across chosen markets and regions, then monitor remaining usage and the actual refresh cadence.
Pricing and total cost
Starter provides 500 monthly credits for free. The documented paid tiers increase quota; endpoint coverage and historical eligibility still need to match the selected plan.
Starter
Free
- 500 credits/month
- Sports, bookmakers and markets depend on the selected endpoints
20K
$30/month
- 20,000 credits/month
- Sports, bookmakers and markets depend on the selected endpoints
100K
$59/month
- 100,000 credits/month
- Sports, bookmakers and markets depend on the selected endpoints
5M
$119/month
- 5,000,000 credits/month
- Sports, bookmakers and markets depend on the selected endpoints
15M
$249/month
- 15,000,000 credits/month
- Sports, bookmakers and markets depend on the selected endpoints
Getting started
Before you start: Coverage and refresh intervals vary by sport, bookmaker and market. Historical access differs from the free current-odds offering.
- Choose API or spreadsheet access and request an API key.
- Set sport, region and market type, then inspect outcome definitions and update timestamps.
- Estimate credit costs and monitor quota and refresh cadence before broad polling.
A bookmaker quote is an external reference, not a Polymarket fill.
Useful links
What to check
- Coverage and refresh intervals vary by sport, bookmaker and market. Historical access differs from the free current-odds offering.
- Credit costs depend on the requested data; one HTTP call is not always one credit. The service supplies data rather than executing bets.
A closer look
Ratings & reviews
User reviews 0
The main score switches to user ratings after 5 published reviews.
A specific example helps the next person choose the right tool.
Related tools
Browse categoryFrequently asked questions about The Odds API
Which odds formats are offered?
Decimal and American odds are supported. Confirm that market and outcome definitions align before comparison.
Can I work in a spreadsheet?
Excel and Google Sheets add-ons are offered as alternatives to building an API client.


