Every endpoint. Real examples.

Return the list of supported sports.

No API key required to browse the catalog - each sport carries a

min_tier field (Free / Pro / Business) so you can see availability

before signing up. With a valid key, the list is filtered to the sports

your tier can access (unchanged behavior).

Free tier: NFL + NBA + MLB only · Pro/Business: 25+ sports including NBA, MLB, NFL, NHL, NCAAB, NCAAF, WNBA, UFC, MLS, EPL, Champions League, La Liga, Bundesliga, Serie A, Ligue 1, Liga MX, Eredivisie, Championship, Cricket, Boxing, Tennis, Euroleague, Europa League, AFL, NRL

Return details for a specific sport.

Returns 404 if the sport doesn't exist or isn't available for this tier.

404 (not 403) is intentional - don't confirm a sport exists to a tier

that can't access it.

Return cached event summaries for the given sport.

Return normalized odds from multiple sportsbooks for the given sport.

Live feed: returns upcoming and in-play games only; finished games

roll off the feed. Each game's start time is the start_time field

(ISO 8601 UTC). To pull a specific day's full slate regardless of when

you poll, use commenceTimeFrom / commenceTimeTo (they filter on

start_time). For games that have already concluded, use

/historical/odds (Business tier).

Markets: h2h (moneyline), spreads, totals. All three are returned

by default. Use ?markets=h2h or ?markets=spreads,totals to filter.

Note: MMA/UFC returns h2h + totals only (no spreads - fighter spreads

are not a standard US market).

Free tier: NFL + NBA + MLB, h2h only · Pro: 25+ sports, main markets (h2h, spreads, totals) · Business: all sports and markets

Return best available line per outcome from cached normalized odds.

Cross-book arbitrage opportunities (precomputed, refreshed with odds).

Each arb is flagged with likely_stale when profit_pct exceeds

STALE_ARB_PROFIT_PCT_THRESHOLD (5%). Real cross-book arbs are typically

0.5-3% - larger numbers usually indicate a stale line, limit-restricted

book, or a pricing error that will void.

Value bets vs vig-removed soft-market consensus (precomputed).

"Value" is a book's offered price against the vig-removed, EQUAL-WEIGHTED

consensus of the books that actually priced that event. Pinnacle is not

required; whether it was present is reported per row and in the top-level

sharp_anchor block.

Per-event market health: hold %, efficiency, tightest/widest book (precomputed).

Cross-book raw price deviations from market average (precomputed).

Raw price delta WITHOUT vig removal. Included for customers who want the

unprocessed delta for their own pipelines. For rigorous +EV signals use

/intelligence/value instead.

Vig-removed fair prices per outcome (precomputed). H2h moneyline only today.

Fair probability is the vig-removed, EQUAL-WEIGHTED average across the

books that actually priced each event. Pinnacle is not required; whether it

was present is reported per event and in the top-level sharp_anchor block.

Median/mean market center per outcome (precomputed). H2h moneyline only today.

Cross-book edges vs Pinnacle (sharp anchor), precomputed.

Tier: Business plan or higher. Pro keys receive a 403 with an

upgrade pointer.

Edge types:

• line_gap - soft book has a different point/spread than Pinnacle.
• price_gap - same line, soft book paying more than 10 cents over

Pinnacle.

• dream_combo - line gap AND soft book paying more (rarest).

Sign convention: line_gap = sharp_line - soft_line; positive

when the soft book's line is lower than Pinnacle's. Whether a lower

line is favorable depends on the bet direction - Over wants lower,

Under wants higher, spreads want higher numerically for the side

being bet. The direction field is provided so callers can interpret

the sign correctly.

Coverage: every sport refreshed by the scheduler. For

basketball_nba, icehockey_nhl, and baseball_mlb, player-prop

edges are merged into the same response (distinguished by market).

Grading: sports where settlement results are not available

(currently tennis and cricket) return "grading": "unavailable". Their edges are still

served as line-comparison signals for line shopping, but are not graded

picks with a verified hit rate.

Dashboard payload - everything the /me.html usage dashboard renders.

Auth-only, zero quota cost (same policy as /me: a customer over their

limit must still be able to see WHY). Read-only aggregates; no raw keys

or query params are ever returned.

Response data:

tier, requests_today, daily_limit, remaining (live counters)

monthly_quota (as sold; null for tiers without monthly framing)

stats (30-day aggregates from your request history,

cached 5 minutes;

null if stats backend is unavailable - render

the basic meters and hide the charts)

.daily[] {day, total, ok, err}

.month_total requests this calendar month

.endpoints[] {endpoint, total, err, avg_ms} top 10

.error_rate_30d percent

.avg_latency_ms_30d

.recent_errors[] {status_code, endpoint, n, last_seen} top 5, 7d

Historical odds snapshots from TheOddsAPI archive.

Returns timestamped price snapshots for completed and in-progress events.

Data collected since 2026-05-13, capturing price changes across 20+ sports

and 50+ sportsbooks including Pinnacle, Betfair Exchange, William Hill,

DraftKings, FanDuel, BetMGM, and Marathonbet.

Use cases: Backtesting, model training, line movement analysis.

Coverage: NBA, MLB, NHL, WNBA, NCAAF, NCAAB, Tennis, Cricket, MLS,

EPL, La Liga, Bundesliga, Serie A, Ligue 1, Eredivisie, EFL Championship,

Champions League, Europa League, Liga MX, Euroleague, Boxing, MMA.

More sports added regularly.

Markets: Standard markets (h2h, spreads, totals) for all sports.

Player props for NBA (player_points, player_rebounds, player_assists,

player_points_rebounds_assists), NHL (player_goals, player_shots_on_goal,

player_power_play_points), MLB (batter_hits, batter_total_bases,

pitcher_strikeouts, batter_home_runs, batter_rbis, batter_runs_scored,

batter_hits_runs_rbis, pitcher_outs, pitcher_strikeouts_alternate), and

WNBA alternate ladders (player_points_alternate, player_rebounds_alternate,

player_assists_alternate - collected from 2026-07-21). Pass ?market= to

filter to a single market, or omit to receive all available markets for the

sport.

Business plan required. Free and Pro tiers return 403.

Pagination: page with cursor (meta.next_cursor) and stop on an

empty page. meta.has_more says whether rows exist beyond this page.

When meta.total_rows_exact is true, meta.total_rows is the exact

count. When it is false, meta.total_rows equals

meta.total_rows_lower_bound: a lower bound, never an estimate.

One market per request: use market=. markets= is not supported

and returns 400.

Row timestamps: captured_at is when TheOddsAPI recorded the price

change. last_update is the bookmaker's own quote time when available

(null on older rows).

Bookmakers: public aliases are accepted (e.g. caesars), but rows are

returned under the canonical key (e.g. williamhill_us).

Coverage: pre-match price-change history. Rows record changes, not

removals: a line that left the board has no closing row.

Settlement results for graded edge snapshots - each graded edge paired

with the final score for its event.

Each row shows the original edge (soft book/price/point + sharp reference),

the grading result (hit/miss/push/void), the realized payout (American

odds, 1.0 = +100), and the final score for the event.

Use cases: Strategy backtesting, P&L attribution, edge calibration.

Coverage: Graded edges available from 2026-04-25. Settlements are

published once final scores are confirmed, typically within a few hours

of game end. Stale ungraded edges are voided after 7 days past

commence_time.

Business plan required. Free and Pro tiers return 403.

Player props for the requested sport.

Tier: Business plan or higher. Pro keys receive a 403 with an

upgrade pointer.

Coverage:

• NBA - 8 markets (points, rebounds, assists, PRA, threes, blocks, steals, double_double).
• NHL - 5 markets (points, goals, assists, shots on goal, power-play points).
• MLB - 9 markets (batter hits, batter total bases, pitcher strikeouts, batter home runs, batter RBIs, batter runs scored, batter hits+runs+RBIs, pitcher outs, alternate pitcher strikeout lines).
• WNBA - 11 markets (same set as NBA Tier 1 plus alternate points/rebounds/assists lines; US books only).
• AFL - 4 Tier 1 markets (disposals_over, goals_scored_over, marks_over, tackles_over); AU books only.
• NRL - 4 markets (try scorer first/last/anytime, tries scored); AU books only - try-related markets are the full available inventory.

Books include both US (DraftKings, FanDuel, BetMGM, ...) and EU sharps

(Pinnacle for NBA/NHL/MLB), refreshed every few minutes for events starting within 24h.

The regions= filter (us, uk, eu, au) is honored at the route layer and

narrows each market's book list to the requested regions.

Outcome shape:

{ "name": "Over", "description": "LeBron James",
  "price": -115, "point": 25.5 }

name is "Over" or "Under"; description is the player.

Period markets - game-segment markets scoped to a portion of a game.

v1 coverage: MLB first-5-innings (h2h_1st_5_innings,

spreads_1st_5_innings, totals_1st_5_innings,

alternate_totals_1st_5_innings).

Tier: Business plan or higher. Pro keys receive a 403 with an

upgrade pointer.

Refresh cadence: 5 minutes during the active window

(T-2h pregame through ~end of the 5th, T+1.5h). Outside that window

the cache is intentionally empty - active_window metadata makes the

"no games right now" vs "outage" distinction explicit.

Books: US sportsbooks plus Pinnacle (via us+eu region pull) as the

sharp anchor for line comparison.

Response shape:

{
  "success": true,
  "source": "cache",
  "data": [
    {
      "event_id":   "...",
      "home_team":  "...",
      "away_team":  "...",
      "start_time": "...",
      "markets": [
        { "market": "totals_1st_5_innings",
          "books": [ { "book": "pinnacle", "outcomes": [...] }, ... ] }
      ]
    }
  ],
  "active_window": {
    "start": "<ISO>",
    "end":   "<ISO>",
    "events_in_window": 0,
    "next_event_at":    "<ISO|null>"
  }
}

Additional markets - soccer match-level markets beyond the standard

h2h / spreads / totals trio.

v1 coverage: World Cup 2026 (soccer_fifa_world_cup) with

btts (both teams to score), double_chance (1X / X2 / 12), and

draw_no_bet (match winner, draw refunds stake).

Tier: Business plan or higher. Pro keys receive a 403 with an

upgrade pointer.

Refresh cadence: 60 seconds during the active window

(T-12h pregame through ~T+2h in-play). Outside that window the cache

is intentionally empty - active_window metadata makes the

"no games right now" vs "outage" distinction explicit.

Books: US + UK + EU sportsbooks. Coverage varies by market -

btts has the widest book coverage (~16 books on a typical event),

draw_no_bet and double_chance are thinner (~10-11 books each).

Response shape:

{
  "success": true,
  "source": "cache",
  "data": [
    {
      "event_id":   "...",
      "home_team":  "...",
      "away_team":  "...",
      "start_time": "...",
      "markets": [
        { "market": "btts",
          "books": [ { "book": "pinnacle", "outcomes": [...] }, ... ] }
      ]
    }
  ],
  "active_window": {
    "start": "<ISO>",
    "end":   "<ISO>",
    "events_in_window": 0,
    "next_event_at":    "<ISO|null>"
  }
}