TheOddsAPI — Real-Time Sports Betting Odds API

Quick start

Your first request in under a minute.

Request an API key, add one header, and you're pulling live odds from every major sportsbook in a single call.

01

Request an API key

Send us a quick message and we'll get your key to you 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"

Response application/json

[ {
  "id":             "a1b2c3d4",
  "sport_key":     "basketball_nba",
  "home_team":     "Los Angeles Lakers",
  "away_team":     "Boston Celtics",
  "commence_time": "2026-03-28T01:00:00Z",
  "bookmakers": [ {
    "key":        "draftkings",
    "title":     "DraftKings",
    "last_update": "2026-03-27T14:38:01Z",
    "markets": [ {
      "key": "h2h",
      "outcomes": [
        { "name": "Lakers",  "price": -110 },
        { "name": "Celtics", "price": -110 }
      ]
    } ]
  } ]
} ]

Request API Key Full API Reference ↗

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

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) basketball_nba · baseball_mlb

Markets h2h · spreads · totals

Odds formats american · decimal · fractional

Rate limiting X-RateLimit-* headers

Caching Server-side · ETag support

Interactive docs Swagger UI ↗

Webhook delivery Business tier

Historical data Pro: 7d · Business: 90d

GET /odds?sport_key=basketball_nba 200 · 218ms

[
  {
    "id":             "a1b2c3d4e5f6",
    "sport_key":     "basketball_nba",
    "home_team":     "Los Angeles Lakers",
    "away_team":     "Boston Celtics",
    "commence_time": "2026-03-28T01:00:00Z",
    "bookmakers": [
      {
        "key":         "draftkings",
        "title":       "DraftKings",
        "last_update": "2026-03-27T14:38:01Z",
        "markets": [
          {
            "key": "h2h",
            "outcomes": [
              { "name": "Lakers",  "price": -110 },
              { "name": "Celtics", "price": -110 }
            ]
          }
        ]
      }
    ]
  }
]

Trusted by developers building the next generation of sports data products

BetSync OddsRadar LineTracker SharpPick ArbitrageHQ

"The normalization layer alone saved us three weeks of engineering time. The data is clean, the latency is low, and it just works."

Alex R.

CTO · SharpPick Analytics

"Exceptional uptime. We're pulling 50,000 requests a month across NBA and MLB with zero incidents in six months of production use."

Jordan M.

Lead Engineer · LineTracker

"Comparing DraftKings, FanDuel, and BetMGM in a single response object is exactly what we needed for our arbitrage detection pipeline."

Sam K.

Founder · ArbitrageHQ

Subscription tiers

Tiered access. Transparent pricing.

Designed to grow with your product. All plans are provisioned directly — reach out and we'll get you set up. Volume and annual pricing available on request.

Starter

$0_/mo

Evaluate the platform. Get in touch and we'll set you up with a key to explore the API.

Get Started — Free

—500 API requests / month
—NBA + MLB markets
—Moneylines (h2h)
—US sportsbooks
—Spreads & totals
—Historical data
—SLA guarantee

Data that moves with the market.

Join the developers and data teams building smarter sports products on TheOddsAPI. Send us a message and we'll get you set up with access.

Get API Key View Documentation ↗

The odds intelligence platform for serious operators.