Bet Grading API: Settle Bets as Won, Lost or Void in Python
Grade sports bets in code: send the event, market, line and side to one endpoint and get won, lost, void or half won. Python example on real games.
Pre-match and live odds, player props, scores and history in one JSON format, over REST, WebSocket or MCP.
Plans from £49/month, cancel anytime. Trusted by 20,000+ developers.
Lowest odds latency in the market: pre-match refreshed in seconds, live odds pushed in milliseconds.
One response. Your next product.
Every bookmaker in the odds API, the sports it covers and the markets you can pull. Click a row for the per-sport breakdown, or browse the full directory.
| Bookmaker | Sports | Pre-match | Live | Props | Markets | Details |
|---|---|---|---|---|---|---|
| Football +15 more | ✓ | ✓ | ✓ | 174Player propsCornersCardsHalves | Details | |
| Football +14 more | ✓ | ✓ | – | 24CornersCardsHalves | Details | |
| Football +7 more | ✓ | ✓ | – | 17CornersCardsHalves | Details | |
| Basketball +8 more | ✓ | ✓ | ✓ | 27Player propsHalves | Details | |
| Football +12 more | ✓ | ✓ | – | 17Corners | Details | |
| Football +1 more | ✓ | ✓ | – | 45CornersCardsHalves | Details | |
| Football +8 more | ✓ | ✓ | ✓ | 61Player propsCornersCardsHalves | Details | |
| Esports +12 more | ✓ | ✓ | – | 64CornersCardsHalves | Details | |
| Basketball +9 more | ✓ | ✓ | ✓ | 65Player propsHalves | Details | |
| Baseball +5 more | ✓ | ✓ | ✓ | 19Player propsCardsHalves | Details |
Coverage updated 18 Oct 2026, 21:30 UTC · Download as JSON
Pull one event from up to 30 bookmakers in a single odds API call and you have an odds comparison page. Add props, corners and cards for the markets your users actually bet.
Build odds comparison pages, value bet finders, arbitrage scanners, props screeners, live scores and trading models.
| Market | |||||
|---|---|---|---|---|---|
| Man City to win | 2.05 | 2.10 | 2.08 | 2.00 | 2.05 |
| Over goals2.5 | 1.80 | 1.83 | 1.85 | 1.80 | 1.78 |
| Haaland shots over2.5 | 1.83 | 1.80 | 1.88 | 1.75 | 1.80 |
| Saka shots over1.5 | 1.72 | 1.70 | 1.75 | 1.67 | 1.73 |
| Corners over10.5 | 1.95 | 1.91 | 2.00 | 1.90 | 1.92 |
| Cards over4.5 | 2.10 | 2.05 | 2.08 | 2.00 | 2.15 |
Every plan of the odds API includes these, and WebSocket streaming is an add-on for any plan. You pick the bookmakers, we handle the scraping, mapping and uptime.
Events, teams and markets are matched across books, so Bet365 and Betano DE return the same event id and the same market names. No per-book parsers.
The recommended way to get odds. Every change is pushed within milliseconds, pre-match and live, for the lowest latency and far less bandwidth than polling. Scores, clock and status come on the same stream. Add it to any plan.
Shots, shots on target, assists, goalscorers and NBA player lines from the books that offer them.
Ready-made /value-bets, /arbitrage-bets and /dropping-odds endpoints, so you can ship a tool before you build a model.
Line movements per market, historical odds and closing lines for backtesting and CLV tracking.
Each event comes with deep links to the bookmaker's own page, ready for affiliate traffic.
CS2, Valorant, League of Legends, Dota 2 and more, with kills and map markets where books price them. Esports odds API
Official Python and TypeScript clients, plus an MCP server so AI assistants can query odds directly. SDK guide
pip install odds-api-ionpm i odds-api-ioAuthenticate to the odds API with one key, call any endpoint, get JSON back. Rate limit headers and standard HTTP errors on every response.
/v3/oddsOdds for one event from up to 30 bookmakers/v3/odds/multiSeveral events in one call, billed as one request/v3/odds/movementsLine history per market and bookmaker/v3/odds/updatedOdds that changed since a timestamp/v3/eventsUpcoming and live events by sport and league/v3/events/liveLive events with score and clock/v3/events/searchFind an event by team name/v3/participantsTeams and players with logos/v3/value-betsPrices above the fair line, with expected value/v3/arbitrage-betsArbitrage opportunities across your books/v3/dropping-oddsMarkets where the price is falling fast/v3/historical/eventsFinished events and results/v3/historical/oddsOdds snapshots for past events/v3/historical/closing-linesClosing lines for CLV trackingwss://api.odds-api.io/v3/wsOdds, score and status messages pushed in real timeConnect your assistant to live odds with our official MCP server. Twenty-five tools, one JSON schema for every bookmaker and AI-ready docs, so the code it writes works on the first run.
claude mcp add odds-api \
--env ODDS_API_KEY="your-api-key" \
-- npx -y odds-api-mcp-servercodex mcp add odds-api \
--env ODDS_API_KEY="your-api-key" \
-- npx -y odds-api-mcp-server{
"mcpServers": {
"odds-api": {
"command": "npx",
"args": [
"-y",
"odds-api-mcp-server"
],
"env": {
"ODDS_API_KEY": "your-api-key"
}
}
}
}{
"mcpServers": {
"odds-api": {
"command": "npx",
"args": [
"-y",
"odds-api-mcp-server"
],
"env": {
"ODDS_API_KEY": "your-api-key"
}
}
}
}Your assistant can query sports, bookmakers, leagues, markets, events, live events, search, odds, multi-odds, updated odds, odds movements, dropping odds, value bets, arbitrage, historical odds, settlements, bet grading, participants and docs.
Using the Odds-API.io API, build a React page that lists upcoming Premier League matches with Bet365, Unibet and Betano odds side by side and highlights the best price for each outcome.
Every plan gets 5,000 requests/hour, every sport and every market. Pay monthly, or yearly and get 2 months free. Cancel any month.
The recommended way to get odds. Every change is pushed within milliseconds, for the lowest latency and far less bandwidth than polling. It costs the plan price again, so 2× the plan price in total, for example an extra £49/mo on Solo.
Raise the hourly limit on any plan to a new total.
Pay by card or crypto: Visa, Mastercard, Amex, Apple Pay, Google Pay or PayPal. Prices are shown in your local currency.
415+ bookmakers across 34 sports, from Bet365, Betfair Exchange, Betano and 1xBet to local books in Europe, Australia, the US and Latin America. Search the coverage table for any book and see its sports, markets, and whether it has live odds and player props. View the full bookmaker list. By region: UK odds API, US sportsbook API, Italy odds API, Brazil odds API, Asia odds feed and Australia odds API.
Yes, depending on the bookmaker. Player shots, assists, goalscorers, corners, bookings, Asian handicap, half-time lines and team totals are all available. Turn on “Player props only” in the coverage table to see which books carry them.
New free keys are paused. Solo at £49/month is the cheapest way to start: 2 bookmakers of your choice, every sport and market, live and pre-match. It runs month to month and you can cancel any time. See all plans.
Plans differ only by how many bookmakers you pick: Solo 2, Starter 5, Growth 10, Pro 15. All of them include 5,000 requests/hour, every sport and every market. We recommend adding WebSocket for the lowest latency and less bandwidth. See all plans.
Both. Most bookmakers are covered live as well as pre-match, with scores, match clock and status alongside the odds. The coverage table shows live support per book and sport.
Yes, you can display the data in your own website, app or tool, including paid products. Reselling or redistributing the raw feed to third parties needs an enterprise agreement, so talk to us first. Contact us.
34 sports, including football, basketball, tennis, American football, ice hockey, baseball, cricket and esports (CS2, League of Legends, Dota 2, Valorant and more, with map and kill markets where books price them).
We recommend WebSocket for most apps. Every price change, pre-match and live, is pushed the moment it happens, so you get the lowest latency and use far less bandwidth than polling. REST is included in every plan and suits scripts, quick lookups and backfills.
You pick your bookmakers in the dashboard after you subscribe, and you can swap them later. Your API key stays the same.
Yes. Live scores and match clock come with live events, and finished events include final results, so you can settle bets and show results next to the odds.
Yes. Historical events and results, historical odds, closing lines and per-market line movements are available through the API.
Yes. Bet365 pre-match and live odds, player props, corners and cards. Bet365 has no public API, so this is the reliable way to get its lines programmatically.
Yes. The official MCP server (odds-api-mcp-server on npm) gives Claude, Codex, Cursor and other MCP clients 25 tools for sports, bookmakers, leagues, markets, events, live events, search, odds, multi-odds, updated odds, odds movements, dropping odds, value bets, arbitrage, historical odds, settlements, bet grading, participants and docs. The docs are also published as llms.txt, and the AI setup guide at docs.odds-api.io/ai-vibe-coding shows the setup for each tool. Open the AI setup guide.
Every plan includes 5,000 requests/hour with no monthly cap. You can raise it to 10,000, 20,000 or 30,000 requests per hour.
Yes. Pick Crypto at checkout and pay with BTC, ETH, USDC, TRX, SOL, LTC and more (10+ coins). Renewals arrive as an invoice with a payment link, and your access continues while it is open.
Get a key in under a minute, or ask us anything about coverage, custom feeds or volume pricing.
Or email hello@odds-api.io
Insights, tutorials and industry updates from the Odds-API.io team.
Grade sports bets in code: send the event, market, line and side to one endpoint and get won, lost, void or half won. Python example on real games.
A Python tutorial for DraftKings odds: NFL lines, player props, live prices and closing lines through the Odds-API.io v3 API, with real responses.
Betfair's own API is built for placing bets. How to read Betfair Exchange back, lay and depth prices, Sportsbook odds, in-play and closing lines through the Odds-API.io v3 API, with a Python example.
OddsNotifier and OddsHub run on the same real-time feed you get with the API.
See what's built with Odds API →