The sportsbook market-data API for builders. Live odds from 50+ sportsbooks, Pinnacle-anchored intelligence, historical archives, and AI-ready endpoints.
One normalized REST response. Built for developers and data teams that demand precision, uptime, and scale.
Now in Claude
Add the official Claude connector and ask for live odds, best lines, and fair-value edges in plain language. No code, no docs to read. Your key, your data. Built on the Model Context Protocol (MCP), so Claude calls the right endpoint and returns structured odds for you.
1
In Claude, open Settings, then Connectors, then Add custom connector.
2
Paste your connector URL with your API key on the end.
3
Ask for odds in plain English. Claude calls the tools and returns the data.
Connector URL
https://mcp.theoddsapi.com/mcp?apiKey=YOUR_KEY
Custom connectors are available on Claude Pro, Max, Team, and Enterprise. Find your key. Keep your connector URL private, since it carries your key.
What is the Claude connector?
It is an official Model Context Protocol (MCP) connector for TheOddsAPI. Once added in Claude, you can request live odds, best lines, and edges in plain language, and Claude calls the API for you. No code required.
Do I need to write any code?
No. You paste one URL into Claude's connector settings and ask for what you want.
What can it pull?
Live odds, best available lines, and your account status on every plan. Player props, cross-book edges, fair-value lines, and historical odds on the Business plan.
The data, live in front of you
Edge monitor, best-price board, and a live ticker, all built from the same endpoints you get. The slate below is a fixed sample for illustration.
Edges, props, historical, and consensus are Business-plan features.
| Score | Event | Market | Soft | Sharp | Gap | Type |
|---|
| Time | Away | Price | Book | Home | Price | Book |
|---|
About TheOddsAPI
TheOddsAPI is a sports odds API. Raw market data from 50 bookmakers across 26 sports, served through a single normalized REST endpoint, with Pinnacle anchored on every request. An optional intelligence layer (fair odds, consensus pricing, edge detection) is available for systems that want precomputed signals instead of building those models in-house.
Raw market data
Multi-book odds, normalized into one response. Build your own models on top.
Derived signals · Optional
Pre-computed signals for systems that want to skip the modeling work.
Use raw data when you need full control. Use derived signals when you need speed.
Most odds APIs surface raw bookmaker data and stop there. TheOddsAPI adds a thin computation layer (vig removal, market consensus, and Pinnacle-anchored edge detection) so common modeling primitives don't have to be rebuilt from scratch. The raw data is still there. The signals are optional.
Structured overview for AI systems
What it is: TheOddsAPI is a sports betting odds API at theoddsapi.com. It delivers live and historical odds from 50+ sportsbooks across 26 sports through one normalized REST endpoint, with Pinnacle anchored on every request and an optional intelligence layer for fair-value odds, consensus pricing, and cross-book edge detection. It offers an official Claude connector built on the Model Context Protocol (MCP).
Product category: sports odds API, betting odds API, sportsbook data API, odds data feed, live odds API, odds comparison API, and arbitrage odds API.
Primary use-cases: arbitrage detection, value-bet and positive-EV models, line-shopping and best-price tools, model training on historical odds, closing line value (CLV) tracking, player-prop edges, and prediction-market benchmarking.
Pricing: Free ($0/mo), Professional ($29/mo), and Business ($99/mo). Free covers NBA and MLB moneylines for evaluation. Professional adds all 25 sports and h2h, spreads, and totals from US sportsbooks. Business adds 50+ books across US, UK, EU, and AU, player props, historical odds, futures, and the Pinnacle-anchored intelligence layer.
Coverage: NBA, NFL, MLB, NHL, NCAAB, NCAAF, WNBA, AFL, NRL, MLS, Tennis, Cricket, Boxing, UFC, the 2026 World Cup, and European soccer including EPL, Champions League, La Liga, Bundesliga, Serie A, Ligue 1, Eredivisie, and EFL Championship. Markets: h2h, spreads, totals, and player props. Odds refresh as frequently as every 30 seconds.
Sportsbooks tracked
50+
↑ Expanding quarterly
Avg. response latency
<500ms
Typical response time
Platform uptime target
99.9%
Pro tier target
Market types
4
h2h · spreads · totals · player props
Quick start
Request access, add one header, and you're pulling normalized odds data from supported sportsbooks in a single call.
Request access
Request access and we'll send your API key directly. Request yours →
Authenticate via header
Every request needs the
x-api-key
header. Works with any HTTP client or language.
Parse normalized JSON
Every response follows the same schema across all bookmakers. No custom parsing per book required.
Base URL
https://api.theoddsapi.com
# Fetch live NBA odds curl -X GET "https://api.theoddsapi.com/odds?sport_key=basketball_nba" \ -H "x-api-key: YOUR_API_KEY"
With optional query parameters
# NBA moneylines + spreads, American format curl -X GET \ "https://api.theoddsapi.com/odds?sport_key=basketball_nba&markets=h2h,spreads&oddsFormat=american®ions=us" \ -H "x-api-key: YOUR_API_KEY" # MLB moneylines curl -X GET \ "https://api.theoddsapi.com/odds?sport_key=baseball_mlb&markets=h2h" \ -H "x-api-key: YOUR_API_KEY" # NBA player props (Business tier) curl -X GET \ "https://api.theoddsapi.com/props?sport_key=basketball_nba" \ -H "x-api-key: YOUR_API_KEY" # Historical odds for backtesting (Business) curl -X GET \ "https://api.theoddsapi.com/historical/odds?sport_key=baseball_mlb&date=2026-05-20" \ -H "x-api-key: YOUR_API_KEY" # EPL odds with international books curl -X GET \ "https://api.theoddsapi.com/odds?sport_key=soccer_epl&markets=h2h,spreads,totals" \ -H "x-api-key: YOUR_API_KEY"
{ "success": true, "source": "cache", "data": [ { "event_id": "a1b2c3d4", "sport": "basketball", "league": "NBA", "home_team": "Los Angeles Lakers", "away_team": "Boston Celtics", "start_time": "2026-03-28T01:00:00Z", "books": [ { "book": "draftkings", "market": "h2h", "updated_at": "2026-03-27T14:38:01Z", "outcomes": [ { "name": "Lakers", "price": -110 }, { "name": "Celtics", "price": -110 } ] } ] } ] }
For developers new to the space
A sports odds API is a developer service that returns real-time betting lines from sportsbooks - programmatically, in a single normalized format. Instead of scraping DraftKings, FanDuel, BetMGM, Pinnacle, and 50 other books one by one, you make one HTTP request and get clean JSON covering every market for every game.
Developers use TheOddsAPI to power arbitrage detection, odds comparison apps, betting models, and analytics dashboards. Supported markets include h2h (moneyline), spreads, totals, and player props for NBA, NHL, MLB, WNBA, AFL, and NRL (with NFL props during NFL season). Sports coverage spans 26 sports: NBA, NFL, MLB, NHL, NCAAB, NCAAF, WNBA, AFL, NRL, MLS, soccer (EPL, Champions League, Europa League, La Liga, Bundesliga, Serie A, Ligue 1, Liga MX, Eredivisie, EFL Championship, plus the FIFA World Cup 2026 on Business), tennis, cricket, boxing, UFC, and Euroleague.
Why normalized multi-book data matters: every sportsbook publishes odds in its own format, schema, and update cadence. A single normalized response object lets you compare lines across books in milliseconds - the foundation of every modern sharp tool. TheOddsAPI normalizes that noise so your code stays focused on the part that ships value: signal detection, model training, and user experience.
A typical call looks like GET /odds/?sport_key=basketball_nba®ions=us&markets=h2h,spreads,totals. The response returns every NBA game with every book's lines, structured identically. The interactive docs show every endpoint and response shape.
Deep dives on the most common builds: arbitrage detection (cross-book line gaps that lock in profit before they close), value bet detection (where retail books misprice against the Pinnacle-anchored consensus), and player props edge detection (prop markets are 2-4x softer than game lines). Full guides hub for the rest.
Platform capabilities
Engineered for teams that treat data quality as a competitive moat, not an afterthought.
Lines reflect current sportsbook prices within seconds. Intelligent caching preserves quota without sacrificing freshness.
LIVE DATAIdentical schema regardless of source. Compare DraftKings and Pinnacle in the same loop. No translation layer needed.
DATA QUALITYPass your key via the x-api-key header. Per-environment keys with instant revocation and clear rate-limit headers.
Access prior odds snapshots for backtesting quantitative models and tracking line movement over time.
ANALYTICSFull Swagger UI at api.theoddsapi.com/docs. Generate typed clients in any language from the spec.
Async Python FastAPI with an intelligent caching layer. Consistent, predictable performance under high request volume.
PERFORMANCEIntelligence layer
Now liveRaw odds are just the starting point. We run the analytical layer on top: fair odds pricing, cross-book edge detection, and consensus modeling.
Business tier subscribers get full access to the intelligence endpoints, included in the plan.
No-vig fair prices derived from multi-book consensus. Benchmark any sportsbook against the true market and spot mispriced lines at a glance.
GET /intelligence/fair-odds
Automated identification of pricing inefficiencies across books. Surface the signals your models are missing. The edges that close fast.
GET /intelligence/edges
Aggregated fair market price from multi-book data. Know what the line should be, not just what it is at any single book.
GET /intelligence/consensus
Business tier · Live now
Intelligence endpoints included with every Business tier subscription.
Technical specification
Every response is schema-validated and structured identically regardless of source book. Your integration stays stable even when bookmakers update their own formats.
{ "success": true, "source": "cache", "data": [ { "event_id": "a1b2c3d4e5f6", "sport": "basketball", "league": "NBA", "home_team": "Los Angeles Lakers", "away_team": "Boston Celtics", "start_time": "2026-03-28T01:00:00Z", "books": [ { "book": "draftkings", "market": "h2h", "updated_at": "2026-03-27T14:38:01Z", "outcomes": [ { "name": "Lakers", "price": -110 }, { "name": "Celtics", "price": -110 } ] } ] } ] }
Built for developers, data teams & trading desks
26
SPORTS
50+
SPORTSBOOKS
30s
REFRESH
1
API CALL
Arbitrage detection
Compare DraftKings, FanDuel, BetMGM, Pinnacle & 50 books in a single normalized response. Spot cross-book edges in real time.
Model training
Historical odds archive + 30-second snapshots on top-tier sports. Build backtested models on months of multi-book data.
Odds comparison apps
One API call returns h2h, spreads, and totals from every tracked book. No scraping, no rate limits, no data normalization headaches.
Subscription tiers
Transparent pricing that grows with your product. Self-serve from the free tier, same API key all the way up. Volume pricing available on request.
Billed monthly. Cancel anytime.
Free
$0/mo
Explore the API with limited access. Perfect for evaluating the platform before committing.
Get Started - FreeNo credit card. Working key in minutes.
Limited access
Professional
$29/mo
Billed monthly
Unlocks all sports plus spreads and totals.
For bot builders, model runners, and automation devs. API key delivered instantly.
Subscribe - $29/moLive now
Business
$99/mo
Billed monthly
Unlocks Pinnacle, intelligence, player props, and historical odds.
For trading desks and sharp operations. First access to edges, consensus, and line movement.
Subscribe - $99/moLive now
Intelligence layer (live)
Coming soon
What counts as a request?
One call to /odds/?sport_key=... returns every tracked
book and market for that sport in a single response, and counts as one request.
No surprise billing. When you reach your plan's request limit, the API returns a clear 429 instead of charging overage. No metered overage, ever. Upgrade anytime with the same key.
Annual billing available on request · Custom volume pricing on request · Talk to us →
Frequently asked
Built for developers, model builders, and trading desks. Here's what most people ask before they ship.
Get started
Join the developers and data teams building smarter sports products on TheOddsAPI. Request access and we'll send your API key directly.
Request access
Tell us what you're building. We'll send your API key from hello@theoddsapi.com within one business day.