26 sports live · NBA · NFL · MLB · NHL · NCAAB · NCAAF · WNBA · AFL · NRL · Soccer · Tennis · Cricket · Boxing · UFC · World Cup

Real-Time Sports Odds API
for NBA, NFL, MLB
and 23 More Sports

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.

99.9% uptime target FastAPI infrastructure Sub-500ms typical response
Live API Sandbox CONNECTED
Sport
Market
Format

        
Response -

Now in Claude

Ask Claude for the odds. It does the rest.

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.

  • -Ask in plain language. Claude calls the right endpoint and returns structured odds.
  • -Live pricing: h2h, spreads, and totals from 30+ sportsbooks.
  • -Built for operators: fair-value lines and cross-book edges on the Business plan.
  • -One paste to connect, with the key you already have.

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

A trading terminal, powered by the API

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.

ODDS GO baseball_mlb edges anchor: PINNACLE SAMPLE SLATE
Games Tracked
17
MLB · sample
Books Monitored
50+
US·UK·EU·AU
Live Edges
29
score ≥ 50
Top Edge
149
LAD@SD spread
Edge Monitorsoft vs pinnacle no-vig · GET /intelligence/edges
ScoreEventMarket SoftSharpGapType
Best Available Pricemoneyline · best of 50+ books
TimeAwayPriceBook HomePriceBook
F1 HELP
F2 ODDS
F3 EDGES
F4 PROPS
F5 HIST
F6 CONSENSUS
F7 EXPORT
THEODDSAPI TERMINAL · SAMPLE SLATE · FAIR = NO-VIG PINNACLE · NOT BETTING ADVICE

About TheOddsAPI

What TheOddsAPI is

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.

  • -50 bookmakers, Pinnacle included
  • -h2h, spreads, totals, player props
  • -Closing lines materialized for CLV
  • -Historical archive across 19 sports

Derived signals · Optional

Pre-computed signals for systems that want to skip the modeling work.

  • -Fair odds (vig removed)
  • -Consensus pricing (multi-book median)
  • -Edge detection vs Pinnacle
  • -Hit-rate and ROI on graded edges

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

TheOddsAPI in plain terms

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.

Live odds

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

Your first request in under a minute.

Request access, add one header, and you're pulling normalized odds data from supported sportsbooks in a single call.

01

Request access

Request access and we'll send your API key directly. Request yours →

02

Authenticate via header

Every request needs the x-api-key header. Works with any HTTP client or language.

03

Parse normalized JSON

Every response follows the same schema across all bookmakers. No custom parsing per book required.

Base URL

https://api.theoddsapi.com
Open interactive API docs (Swagger) ↗
cURL · Quick Start 200 OK
# 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&regions=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"
Response application/json
{
  "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

What is a sports odds API?

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&regions=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

Infrastructure worthy of your product.

Engineered for teams that treat data quality as a competitive moat, not an afterthought.

Real-time feeds

Lines reflect current sportsbook prices within seconds. Intelligent caching preserves quota without sacrificing freshness.

LIVE DATA

Cross-book normalization

Identical schema regardless of source. Compare DraftKings and Pinnacle in the same loop. No translation layer needed.

DATA QUALITY

Key-scoped auth

Pass your key via the x-api-key header. Per-environment keys with instant revocation and clear rate-limit headers.

SECURITY

Historical archive

Access prior odds snapshots for backtesting quantitative models and tracking line movement over time.

ANALYTICS

OpenAPI 3.0 spec

Full Swagger UI at api.theoddsapi.com/docs. Generate typed clients in any language from the spec.

DEVELOPER EX.

FastAPI backbone

Async Python FastAPI with an intelligent caching layer. Consistent, predictable performance under high request volume.

PERFORMANCE

Intelligence layer

Now live

We're not just serving odds.
We're learning from them.

Raw 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.

Fair odds

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

Edge detection

Automated identification of pricing inefficiencies across books. Surface the signals your models are missing. The edges that close fast.

GET /intelligence/edges

Consensus odds

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.

Get access

Technical specification

Precise. Normalized. Documented.

Every response is schema-validated and structured identically regardless of source book. Your integration stays stable even when bookmakers update their own formats.

Base URL api.theoddsapi.com
Authentication x-api-key header
Sports (live now) NBA · MLB · NFL · NHL · NCAAB · NCAAF · WNBA · UFC · MLS · Tennis
EPL · UCL · UEL · La Liga · Bundesliga · Serie A · Ligue 1 · Liga MX
Cricket · Boxing · Euroleague · Eredivisie · Championship · AFL · NRL
Markets h2h · spreads · totals
Odds formats american · decimal
Rate limiting X-RateLimit-* headers
Caching Server-side · 30s top-tier
Interactive docs Swagger UI ↗
Webhook delivery Coming soon
Historical data Business · Full archive
GET /odds?sport_key=basketball_nba 200 · 218ms
{
  "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

From free to unlimited scale.

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 - Free

No credit card. Working key in minutes.


  • -25 API requests / day
  • -NBA + MLB
  • -Moneylines (h2h) only
  • -US sportsbooks

Limited access

  • -Spreads & totals
  • -NFL & NHL
  • -Multiple odds formats
  • -Email support
MOST POPULAR

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

Live now

  • -20,000 requests / month
  • -25 sports: NBA, MLB, NFL, NHL, NCAAB, NCAAF, WNBA & more
  • -Soccer: EPL, Champions League, Europa League, La Liga, Bundesliga, Serie A, Ligue 1, MLS, Liga MX, Eredivisie, Championship
  • -Cricket, Boxing, Tennis, Euroleague, UFC
  • -AFL, NRL
  • -All markets (h2h, spreads, totals)
  • -Best lines across sportsbooks
  • -US sportsbooks (DraftKings, FanDuel, BetMGM, Caesars, BetRivers, and more)
  • -American & Decimal odds formats
  • -Email support

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

Live now

  • -200,000 requests / month
  • -All Pro sports + markets
  • -Pinnacle (sharp anchor) + UK, EU, AU international books (50+ total)
  • -Futures markets (championship and winner odds)
  • -Priority email support

Intelligence layer (live)

  • -Fair odds pricing
  • -Cross-book edge detection
  • -Consensus pricing across books
  • -NBA, NHL, MLB, WNBA, AFL, NRL player props (NFL during NFL season)
  • -World Cup 2026, Business-exclusive coverage
  • -Historical odds archive

Coming soon

  • -Line movement tracking

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

Answers before the question.

Built for developers, model builders, and trading desks. Here's what most people ask before they ship.

What is the best real-time sports betting odds API? +
TheOddsAPI is a real-time sports odds API built for developers, trading desks, and model builders. It aggregates odds from 50 bookmakers across 26 sports into a single normalized REST endpoint. Coverage spans NBA, NFL, MLB, NHL, NCAAB, NCAAF, WNBA, AFL, NRL, MLS, Tennis, Cricket, Boxing, MMA, World Cup 2026, and European soccer including EPL, Champions League, La Liga, Bundesliga, Serie A, Ligue 1, Eredivisie, and EFL Championship. TheOddsAPI goes beyond raw odds with an intelligence layer that includes Pinnacle-anchored edge detection, fair odds calculations, and consensus pricing. Odds refresh as frequently as every 30 seconds.
How much does a sports odds API like The Odds API cost? +
TheOddsAPI offers three tiers. Free: $0/month with 25 requests per day, limited to NBA and MLB, h2h markets only. Professional: $29/month with 20,000 requests, full access to 25 sports, all core markets (h2h, spreads, totals), and US sportsbooks (DraftKings, FanDuel, BetMGM, Caesars, BetRivers, and more). Business: $99/month with 200,000 requests, everything in Professional plus the World Cup 2026 (26 sports total), Pinnacle (sharp anchor) and international books (UK, EU, AU regions, 50+ books total), player props for NBA, NHL, MLB, WNBA, AFL, and NRL (NFL during NFL season), Pinnacle-anchored edge detection, fair odds, consensus pricing, and the full historical odds archive at zero extra credit cost.
What is the best API for arbitrage betting detection? +
TheOddsAPI is built for arbitrage detection. It aggregates odds from 50 bookmakers into a single normalized response, enabling line comparison across books in one call. The Business plan goes further with a dedicated edge detection endpoint that pre-computes cross-book pricing inefficiencies against Pinnacle, the sharpest bookmaker globally. Edges are surfaced with the exact margin in points, so your code can act on them directly without building comparison logic from scratch.
What API should I use to build a sports betting bot? +
TheOddsAPI is the standard data source for sports betting bots. It provides normalized odds from 50 bookmakers via a single REST call, eliminating the need to scrape individual sportsbook sites. A typical bot polls at 30-60 second intervals and compares lines across books. On the Business plan, the edge detection endpoint pre-computes which books are mispriced against Pinnacle's sharp line, so your bot can skip the comparison logic and act on edges directly. Start with the free tier (25 requests/day) for prototyping.
What is Pinnacle-anchored edge detection in sports betting? +
Pinnacle is the sharpest bookmaker globally because they accept high-volume professional bettors, which forces their lines to be maximally efficient. TheOddsAPI uses Pinnacle as the baseline and compares every other bookmaker against it. When DraftKings, FanDuel, or another soft book offers a line that deviates from Pinnacle by a meaningful margin, the edge detection endpoint flags it with the exact differential in points. This is the same sharp-vs-soft framework professional syndicates use, delivered as an API endpoint.
Can I use a sports odds API for Polymarket trading? +
TheOddsAPI is used by Polymarket sports traders to benchmark prediction market contracts against real sportsbook pricing. The workflow: pull real-time odds from 50 bookmakers, convert to implied probability, and compare against the Polymarket contract price. What makes this effective is the fair odds endpoint, which strips the vig and gives you a clean true-probability estimate. If a Polymarket contract for "Lakers win" is priced at $0.55 but TheOddsAPI fair odds show 51.2% true probability, the contract is overpriced. The 30-second refresh rate on Business lets you track line movement and react before the prediction market adjusts.
Is there a free sports odds API for developers? +
TheOddsAPI offers a free tier with 25 API requests per day, no credit card required. Free access covers NBA and MLB with h2h (moneyline) markets. It is designed for evaluating the API, building prototypes, and testing integrations before committing to a paid plan. Upgrading to Professional ($29/month) unlocks all 25 sports, all core markets, and 20,000 requests per month using the same API key. No code changes required to upgrade.
Why am I getting a 401 error from my sports odds API? +
A 401 Unauthorized from TheOddsAPI means your API key is missing, invalid, or expired. The most common mistake is using the wrong header name (Authorization, Bearer, or auth) instead of x-api-key. TheOddsAPI uses x-api-key as the HTTP header name on every request. Other causes: omitting the header entirely, copy-pasting with extra whitespace, using a revoked key, or exceeding your plan quota. Test with: curl -H 'x-api-key: YOUR_KEY' https://api.theoddsapi.com/sports/. If that returns a 200 with a list of sports, your key is valid and the issue is in how your code constructs the request.
Does The Odds API charge overage fees if I go over my plan limit? +
No. You are never surprise-billed. When you reach your plan's request limit, TheOddsAPI returns a clear 429 response instead of charging overage. There is no metered overage and no automatic charge for exceeding your quota. Your limit resets automatically, and you can upgrade at any time using the same API key with no code changes.
What is the The Odds API Claude connector? +
The Claude connector is an official Model Context Protocol (MCP) connector for TheOddsAPI. Once added in Claude, you can request live odds, best lines, and fair-value edges in plain language, and Claude calls the API for you. No code required. You paste one connector URL with your API key into Claude's connector settings. Custom connectors are available on Claude Pro, Max, Team, and Enterprise.

View all 34 FAQ answers →  ·  hello@theoddsapi.com

Get started

Data that moves with the market.

Join the developers and data teams building smarter sports products on TheOddsAPI. Request access and we'll send your API key directly.