Heritage Sports odds API · affiliate 34

Heritage Sports odds API.
Lines and alternate rungs, one schema.

Get Heritage Sports prices through TheRundown, beside DraftKings, FanDuel, and the rest of the 25+ books. Filter one source or compare books without changing your response parser.

Free key · 20,000 data points a day · No credit card · Every book and live odds from $69/mo

GET/api/v2/sports/{sport_id}/events/{date}

Request Python 3 · requests

import os
from datetime import datetime, timezone
import requests

key = os.environ["THERUNDOWN_API_KEY"]
api = "https://therundown.io/api/v2"
headers = {"X-TheRundown-Key": key}

# Next game date across the NFL (2), NBA (4), and NHL (6)
dates = requests.get(
    f"{api}/sports/dates",
    params={
        "sport_ids": "2,4,6",
        "format": "epoch",
        "exclude_canceled": "true",
    },
    headers=headers,
    timeout=30,
).json()

now = datetime.now(timezone.utc).timestamp()
upcoming = [
    (sport_id, stamp)
    for sport_id, body in dates.items()
    for stamp in body.get("dates") or []
    if stamp > now
]
sport_id, stamp = min(upcoming, key=lambda row: row[1], default=("2", now))
date = datetime.fromtimestamp(stamp, timezone.utc).date().isoformat()

# Heritage Sports next to DraftKings and FanDuel: moneyline, spread, and total
odds = requests.get(
    f"{api}/sports/{sport_id}/events/{date}",
    params={"market_ids": "1,2,3", "affiliate_ids": "34,19,23", "main_line": "true"},
    headers=headers,
    timeout=30,
)
print(odds.text)

Response 200 · trimmed

{
  "events": [
    {
      "event_id": "4f618c654c9a14dcc9bacaad5a50214a",
      "sport_id": 2,
      "event_date": "2026-11-22T18:00:00Z",
      "markets": [
        {
          "market_id": 1,
          "name": "moneyline",
          "participants": [
            {
              "id": 81,
              "type": "TYPE_TEAM",
              "name": "Chicago Bears",
              "lines": [
                {
                  "prices": {
                    "34": {
                      "price": -664,
                      "is_main_line": true,
                      "updated_at": "2026-11-16T19:06:22Z"
                    }
                  }
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

New Orleans Saints at Chicago Bears, November 22, 2026. Captured November 20 and trimmed to the Chicago moneyline from Heritage Sports (34). Prices are an example, not a live quote.

Starter keyHeritage Sports requires Starter or above. A Free key returns the eligible DraftKings and FanDuel game lines from this request, without Heritage Sports.

New to the API? Make your first odds API request with the quickstart.

Markets

The Heritage Sports markets we verified.

Game lines and alternate rungs across US leagues, soccer, and WTA tennis, plus in-play lines on sampled events. Availability varies by sport, game, and market.

34
Heritage Sports affiliate ID
13
Leagues sampled Nov 20
REST
From Starter
WebSocket
Real-time on Ultra
Market typePlan
  • Game linesNFL, college football, NBA, college basketball, and NHL moneylines, spreads, and totals; MLS, Premier League, Bundesliga, La Liga, Serie A, Ligue 1, and Champions League 3-way moneylines, spreads, and totals; WTA tennis moneylines, spreads, and totals
    1 · 2 · 3Starter
  • Alternate linesAdditional spread and total rungs in each league listed under game lines
    omit main_lineStarter
  • In-gameIn-play lines seen on sampled college basketball, Bundesliga, La Liga, Ligue 1, and WTA tennis events
    41 · 42 · 43Starter

Verified November 20, 2026 using Heritage Sports prices on November 20 to 24 slates in the NFL, college football, NBA, college basketball, NHL, MLS, Premier League, Bundesliga, La Liga, Serie A, Ligue 1, Champions League, and WTA tennis. This is a sampled market list, not a guarantee that every game has every market.

For in-game delays by plan and how pulled lines are marked closed, see the live odds API.

Books

25+ books. One schema.

Compare Heritage Sports with other sources in the same event and market structure. Pass affiliate_ids=34 for Heritage Sports alone, or 34,19,23 for Heritage Sports, DraftKings, and FanDuel.

Books in the API25

Sportsbooks · 20

  • DraftKingsFree19
  • FanDuelFree23
  • BetMGMFree22
  • Caesars Sportsbook35
  • Pinnacle3
  • Circa Sports32
  • BookMaker7
  • BetCRIS9
  • Bovada2
  • theScore Bet24
  • Unibet21
  • HardRock28
  • Bet10533
  • Heritage Sports34
  • BetOnline6
  • SportsBetting4
  • LowVig11
  • Everygame14
  • Matchbook16
  • YouWager18

Prediction markets · 3

  • Kalshi25
  • Polymarket26
  • Polymarket US31

Exchanges · 2

  • ProphetX29
  • Novig30

Live from GET /api/v2/affiliates. The affiliates endpoint lists the current sources. Each book posts its own prices and market selection. Coverage varies by league, game, and market.

Free vs paid

Test the schema free. Add Heritage Sports on Starter.

Choose TheRundown for odds and scores joined under one event ID, with participant and signed-line identities and explicit price closure signals. Request the books and markets your application uses, then measure X-Datapoints. Paid subscriptions have a fixed fee and included volume; unrequested price rows conserve that volume without reducing the base fee. Odds API quickstart · Sports data API · Metering rules

Free · $0

Free covers DraftKings, FanDuel, and BetMGM pre-match game lines, five minutes delayed. Heritage Sports is not included.

Paid · from $69/mo

Heritage Sports starts on Starter ($69 a month) with a 60-second delay for internal or personal use. Pro ($249 a month) adds commercial end-user display and a 30-second delay. Ultra ($599 a month) adds real-time REST and WebSocket streaming.

Free$0/mo5-minute delay · 20,000/day · 200,000/monthPre-match game lines from DraftKings, FanDuel, and BetMGM.
Starter$69/mo60-second delay · 25,000,000/moEligible sources, alternates, periods, props, and 60-second-delayed in-play odds. Internal or personal use.
Pro$249/mo30-second delay · 125,000,000/mo30-second-delayed odds and commercial end-user display.
Ultra$599/moReal-time · 500,000,000/moReal-time REST, WebSocket streaming, and futures.

Compare every plan →

Questions

Before you build.

Plans, markets, books, and IDs for the Heritage Sports odds API.

Does Heritage Sports have an odds API?
TheRundown provides Heritage Sports odds through its sports data API, using affiliate ID 34. This page describes TheRundown's API, not an official Heritage Sports developer program.
How do I get Heritage Sports odds with an API key?
Create a TheRundown account, choose Starter or above, and send your API key in the X-TheRundown-Key header. Set affiliate_ids=34 on an events request. The example above finds an upcoming slate and requests Heritage Sports beside DraftKings and FanDuel.
Is Heritage Sports included on the free API plan?
No. Free keys cover DraftKings, FanDuel, and BetMGM pre-match game lines with a five-minute delay. Heritage Sports requires Starter or above. You can test the response shape on Free before choosing a paid plan.
Which Heritage Sports markets can I request?
We verified moneylines, spreads, and totals, plus additional spread and total rungs, across the NFL, college football, NBA, college basketball, NHL, MLS, Premier League, Bundesliga, La Liga, Serie A, Ligue 1, Champions League, and WTA tennis, and in-play lines on sampled college basketball, Bundesliga, La Liga, Ligue 1, and WTA tennis events. Coverage varies by sport, game, and market. The market rows above give the verified market IDs and sampling dates.
Can I stream real-time Heritage Sports odds over WebSocket?
Yes. Ultra includes real-time REST and WebSocket streaming for available Heritage Sports markets. Starter delivers REST prices with a 60-second delay; Pro has a 30-second delay. Stream availability follows the markets the source posts.
How do I get Heritage Sports alternate lines?
Omit main_line=true to request all posted rungs rather than the main line alone. Keep the affiliate ID, market ID, participant, and signed line value when comparing prices so different sides and alternate rungs stay distinct.