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
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.
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.
- 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.
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 covers DraftKings, FanDuel, and BetMGM pre-match game lines, five minutes delayed. Heritage Sports is not included.
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.
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.