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: 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: NBA + MLB · Pro/Business: All sports · All 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" here is offered price vs vig-removed consensus across 30-50 books

including Pinnacle and other sharp/EU books. Consensus includes sharp-book

anchors on major sports.

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 consensus across 30-50 books including

Pinnacle and EU/UK sharp books on major sports. US-only sports (MLS, UFC)

use US retail/offshore books only.

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 without a settling results feed (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, from Redis)

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

stats (30-day aggregates from usage_logs, 5-min cache;

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: meta.total_rows is an estimated count - exact for small

result sets and planner-estimated for very large windows. Paginate using

data alongside limit/offset rather than treating total_rows as a

precise total.

Settlement results for graded edge snapshots - joins edge outcomes with

final scores from the scores table.

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

written by the grading service after final scores arrive (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>"
  }
}

Futures markets - championship winners, season-long.

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

upgrade pointer.

Coverage (initial launch): NBA, NHL, MLB, World Cup - all currently in

active championship phase. Each response returns the active futures

markets for that sport: championship winners and (where books offer

them) conference / division winners.

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

(Pinnacle), refreshed every 30 minutes - futures lines move 1-3 times

per day, tighter cadence wastes credits with no signal gain.

Outcome shape: {"name": "Boston Celtics", "price": 250}. No

point/spread - outright winners are h2h-style team or player names

priced in American odds.