20+Data Sources

550+Market Types

Sub-second across all books.Data freshness

20K/day · 200K/moFree quota

22 + 9Leagues · variants

1M+Daily Requests

Every endpoint. Zero guesswork.

Query over REST. Request snapshots and stream updates over WebSocket.

GET/sports/{id}/events/{date}

Filtered events and odds for a sport on a date. Market deltas require a known zero-delay entitlement, an explicit X-Data-Delay-Seconds: 0 header returned by the bootstrap response, and a positive integer or numeric string in body meta.delta_last_id. Delayed or unknown plans repeat narrow snapshots.

Read the Efficient Polling guide.

Data freshnesssub-second across all books.

Request

curl -i "https://therundown.io/api/v2/sports/4/events/$(date -u +%F)?market_ids=1,2,3&affiliate_ids=3,19,23&main_line=true&hide_closed=true" -H "X-TheRundown-Key: $THERUNDOWN_API_KEY"

Response preview

{
  "meta": { "delta_last_id": "11929034100012" },
  "events": [{
    "teams": [
      { "name": "Celtics" },
      { "name": "Lakers" }
    ],
    "markets": [{
      "market_id": 1,
      "name": "moneyline",
      "participants": 
    }]
  }]
}

Everything you need. Nothing you don't.

One API for odds, scores, markets, and supported stats across major sports, sportsbooks, and supported prediction markets.

Coverage

20+ Data Sources

Published sportsbooks and prediction markets normalized into a single schema.

PinnacleBookMakerBetCRISCirca SportsBet105Heritage SportsHardRocktheScore BetFanDuelBetMGMDraftKingsUnibetBodogBovadaMatchbookBetOnlineLowVigSportsBettingIntertopsYouWagerKalshiPolymarketPolymarket USNovigProphetX

Depth

550+ Market Types

Moneylinecore market

Spreadcore market

Totalscore market

Player Propsparticipant markets

Team Totalsteam markets

Futuresoutrights

Live In-Playsupported books

Alternate Linesexpanded lines

Real-Time WebSocket

Sub-second across all books.
No polling. Ever.

Sub-second across all books.Data freshness

Global

22 Leagues + 9 Variants

•NFL

•NBA

•MLB

•NHL

•NCAAF

•NCAAB

•UFC

•EPL

•Champions League

•La Liga

•WNBA

•Cricket

Odds History

Up to unlimited line movement history for every event, every book.

BOS28312627112

LAL25292826108

Live Scores & Game Data

Period-by-period scores, venue, broadcast, game clock.

$ if [ -z "${THERUNDOWN_API_KEY:-}" ]; then
>   echo "Set THERUNDOWN_API_KEY before running this example." >&2
>   exit 1
> fi
$ DATE=$(date -u +%F)
$ URL="https://therundown.io/api/v2/sports/4/events/$DATE?market_ids=1,2,3&affiliate_ids=3,19,23&main_line=true&hide_closed=true"
$ curl --fail-with-body -sS --connect-timeout 5 --max-time 20 \
>   -D response-headers.txt -o snapshot.json "$URL" \
>   -H "X-TheRundown-Key: $THERUNDOWN_API_KEY"
$ curl_exit_status=$?
$ if [ "$curl_exit_status" -ne 0 ]; then exit "$curl_exit_status"; fi
$ awk 'tolower($1)=="x-datapoints:" {print "Billed data points: " $2}' response-headers.txt
Billed data points: 21
$ jq . snapshot.json

{
  "meta": { "delta_last_id": "11929034100012" },
  "events": [{
    "event_id": "a1b2c3d4e5f6",
    "teams": [
      { "name": "Boston Celtics", "is_away": true },
      { "name": "Los Angeles Lakers", "is_away": false }
    ],
    "score": { "score_away": 112, "score_home": 108 },
    "markets": [
      { "market_id": 1, "name": "moneyline", "participants": [...] },
      { "market_id": 2, "name": "spread", "participants": [...] },
      { "market_id": 3, "name": "total", "participants": [...] }
    ]
  }]
}

For odds, one datapoint is one returned participant/outcome × line/value × affiliate price row. V2 event snapshot responses also add event, score, and live-state rows. X-Datapoints is authoritative for the billed total on billed responses. X-Datapoints-Breakdown is optional, is not currently emitted by /api/v2/markets/delta. Starter and other delayed plans should request narrow snapshots at an appropriate cadence; every successful snapshot bills its returned rows. Do not seed deltas from delayed-plan body metadata. For /api/v2/markets/delta, use the delta cursor only when the account has a known zero-delay entitlement, the bootstrap response explicitly returns X-Data-Delay-Seconds: 0, and meta.delta_last_id is a valid positive integer (as a number or numeric string). If any condition is missing or invalid, repeat narrow snapshots; see the Efficient Polling guide.

API plans & pricing

Start free. Scale when you're ready. No credit card required.

Free
$0/month
No credit card required
20,000/day · 200,000/monthdata points
- REST API access
- 3 sportsbooks (BetMGM, DK, FD)
- Pre-match odds
- Schedules & reference data
- Stats access for new accounts: Catalog + fixed sample; no-card 7-day current-season stats evaluation
- 200,000 data points per calendar month
- No player props or alt markets
- No live in-game odds
- No historical data
- 5-minute data delay
- No WebSocket streaming
1 req/sec rate limit·5 minutes delay
Start Building
Starter
$49/month
Expanded odds data access
25,000,000/modata points
Hard-capped by default · optional overage $12.25/1M
- Currently published data sources
- Supported periods & markets
- Live odds access
- Best lines
- 7-day odds history
- Stats access for new accounts: Current-season completed-game boxes and season aggregates
- 60-second data delay
- No WebSocket streaming
- No +EV calculations
- Internal or personal use only
2 req/sec rate limit·60 seconds delay
Get Started
Pro
$149/month
+EV tools & faster data
125,000,000/modata points
Hard-capped by default · optional overage $7.45/1M
- Everything in Starter
- Value / +EV calculations
- Opening & closing lines
- Commercial end-user display
- 30-day odds history
- Stats access for new accounts: Starter access plus available prior-season game and season archives
- 30-second data delay
- No WebSocket streaming
5 req/sec rate limit·30 seconds delay
Upgrade to Pro
Most Popular
Ultra
$399/month
Real-time WebSocket delivery
500,000,000/modata points
Hard-capped by default · optional overage $4.99/1M
- Everything in Pro
- 1 concurrent WebSocket connection per account
- 3 multiplexed subscriptions per connection
- Real-time data
- 90-day odds history
- Priority support
- Stats access for new accounts: Pro access plus live REST event boxes and live stats over WebSocket
10 req/sec rate limit·Real-time
Go Real-Time

Need higher volume? See Super, Mega, Max & Enterprise plans

Higher-volume plans

Super, Mega, Max, and Enterprise plans for production-scale traders, modelers, and sportsbook-grade workloads.

Super
$649/month
Scaling production workloads
- Everything in Ultra
- 3 concurrent WebSocket connections per account
- 5 multiplexed subscriptions per connection
- Run production and a shadow consumer side by side
- 6-month odds history
- Priority support
- Same new-account stats access as Ultra
1,250,000,000/mo data points · hard cap default; optional $3.25/1M
15 req/sec rate limit·Real-time
Scale Up
Mega
$999/month
Sportsbook-grade volume
- Everything in Super
- 5 concurrent WebSocket connections per account
- 10 multiplexed subscriptions per connection
- Separate capacity for independent consumers
- 1-year odds history
- Same new-account stats access as Ultra
2,500,000,000/mo data points · hard cap default; optional $2.50/1M
20 req/sec rate limit·Real-time
Scale Up
Max
$2499/month
Maximum throughput
- Everything in Mega
- 10 concurrent WebSocket connections per account
- 25 multiplexed subscriptions per connection
- More room for independent consumer services
- Unlimited odds history
- Dedicated support
- Same new-account stats access as Ultra
12,500,000,000/mo data points · hard cap default; optional $1.25/1M
50 req/sec rate limit·Real-time
Scale Up
Enterprise
Contact us
Unlimited scale & dedicated support
- Everything in Max
- 50 concurrent WebSocket connections per account
- 50 multiplexed subscriptions per connection
- Custom data points & rate limits
- Dedicated support & SLA
- Stats entitlements are scoped by contract
Custom data points
Custom rate limit·Real-time
Talk to Sales

$ curl https://therundown.io/api/v2/sports -H "X-TheRundown-Key: $THERUNDOWN_API_KEY"

Get your API key in 30 seconds

Free tier. No credit card. 20,000 data points/day, up to 200,000/month. Start building now.

Start Free Read the Docs

Frequently Asked API Questions

General API Questions

Sign up for the Free plan — no credit card required. You get 20,000 data points per UTC day, up to 200,000 per UTC calendar month, access to 3 sportsbooks, and pre-match odds immediately. When you need more, upgrade to Starter ($49/mo) for currently published paid-tier data sources and live data, or Pro ($149/mo) for a 30-second data delay. See all plans.

Every plan includes adjustable soft and hard limits so you stay in control. Set a soft limit to get a warning notification and a hard limit to cap usage automatically.

On the Free plan, you have a 20,000-point UTC daily cap and a 200,000-point UTC calendar-month cap. Requests return a 429 status when either is reached. No surprise charges.

Monthly and annual self-serve plans (Starter through Max) start hard-capped: automatic overage is off unless you explicitly enable it in Spend Controls. Enabling it without a saved dollar limit creates an initial cap equal to one subscription-period price; you can edit it in Spend Controls. New weekly subscriptions start with automatic metered overage enabled at the listed plan rate; without a saved limit, their editable fallback is 3× the weekly price. In block mode, requests return 429 at the hard cap. Monthly/annual rates per million data points are Starter $12.25, Pro $7.45, Ultra $4.99, Super $3.25, Mega $2.50, and Max $1.25; weekly rates retain the plan's 20% flexibility premium. Paid plans can also buy one current-plan refill at their cadence's bundled unit rate; prepaid data points are used before overage, survive allowance resets, and expire after 12 months. Enterprise plans have custom limits. Contact us for details.

Currently published sources include:

Sportsbooks: Pinnacle, HardRock, theScore Bet, FanDuel, BetMGM, DraftKings, Unibet, Bodog, Bovada, Matchbook, BetOnline, LowVig, SportsBetting, Intertops, YouWager, BookMaker, BetCRIS, Circa Sports, Heritage Sports, and Bet105
Exchange-model sources: Kalshi, Polymarket, Polymarket US, Novig, and ProphetX

Availability varies by source, sport, and market. Check the /api/v2/affiliates endpoint for the currently published roster and IDs. Published operators use the same event/markets/lines/prices hierarchy for sportsbook and prediction-market prices.

Technical API Questions

The recommended pattern:

1. Bootstrap once with a narrow snapshot
Call

GET /api/v2/sports/{sport_id}/events/{date}?market_ids=1,2,3,41,42,43&affiliate_ids=3,19,23&main_line=true&hide_closed=true

to load open main-line moneyline, spread, and total prices.

2. On delayed plans, poll narrow snapshots
Delayed or unknown plans should repeat the narrowest snapshot that fits the use case at an appropriate cadence. Every successful snapshot bills the rows it returns.

3. On zero-delay plans, poll market deltas
Use market deltas only when you have a known zero-delay entitlement, the bootstrap response explicitly returns X-Data-Delay-Seconds: 0, and body meta.delta_last_id is a valid positive integer (as a number or numeric string). Pass that cursor to GET /api/v2/markets/delta?last_id=…&sport_id=4&market_ids=1,2,3,41,42,43&affiliate_ids=3,19,23. Delta filters are literal, so include live market IDs 41, 42, and 43 with the same sport and book scope. Apply each row's is_main_line and closed_at values, and save the cursor from each successful delta page. If any requirement is absent or invalid, repeat narrow snapshots. Read the Efficient Polling guide.

4. Or use WebSocket on Ultra+
Ultra+ can use the multiplexed WebSocket stream for a server-side connection. Use a scoped WebSocket snapshot or a REST baseline, then apply live updates and refresh state after reconnecting.

Ultra+ plans can connect a server to wss://therundown.io/api/v2/ws. Authenticate with an X-TheRundown-Key header sourced from your environment.

Subscribe explicitly to markets, scores, plays, or live. Request snapshot: true in the subscription parameters, bounded by event_ids or sport_ids plus date; the plays channel requires event_ids.

The stream sends snapshot frames, then snapshot_complete, then deltas. An existing subscription can request a fresh snapshot with action: snapshot.

The dedicated /ws/markets endpoint is for odds updates only. Filter it by market_ids, affiliate_ids, and event_ids; each market_price frame carries one changed price row. Keep a REST baseline and use it for recovery. Read the multiplexed WebSocket guide.

One odds data point is one returned price row: participant or outcome × line or value × sportsbook. Missing prices are not charged. Additional participants, alternate lines, and sportsbooks each add returned rows. Examples:

• GET /api/v2/events/{id}?market_ids=1&affiliate_ids=3&main_line=true&hide_closed=true — a two-sided moneyline normally returns two participant price rows = 2 odds data points, plus the response's event/score/live-state rows
• GET /api/v2/events/{id}?market_ids=1,2,3&affiliate_ids=3,19,23&main_line=true&hide_closed=true — six main-line participant/outcome rows × three books = up to 18 odds data points when every price is available, plus event/score/live-state rows

Every successful 200 snapshot bills the price rows it returns, even when a price is unchanged. V2 event snapshot responses also add one event datapoint per event, one score datapoint when present, and one more score-category datapoint when live game state is present. Delayed plans should repeat narrow filtered snapshots at the cadence their use case needs. On a zero-delay plan, use /api/v2/markets/delta only when the account has a known zero-delay entitlement, the bootstrap response explicitly returns X-Data-Delay-Seconds: 0, and meta.delta_last_id is a valid positive integer (as a number or numeric string). Otherwise, repeat a narrow filtered snapshot. Each changed price row is one odds point. X-Datapoints is authoritative for the billed total on billed responses. X-Datapoints-Breakdown is optional, is not currently emitted by /api/v2/markets/delta. WebSocket price-row messages count as one point each. Reference data (/sports, /affiliates, and /markets) is always free.

The /api/v2/markets/delta endpoint returns only price rows that changed since your cursor and is the polling pattern for zero-delay plans only. Use it only with a known zero-delay entitlement and an explicit X-Data-Delay-Seconds: 0 response header. Starter and other delayed plans should use narrow snapshots instead; a body cursor from a delayed snapshot can skip rows. Zero-delay flow:

1. Bootstrap once with a filtered zero-delay snapshot. Include every literal market ID you need, including live IDs 41, 42, and 43: GET /api/v2/sports/4/events/{date}?market_ids=1,2,3,41,42,43&affiliate_ids=3,19,23&main_line=true&hide_closed=true
2. Confirm X-Data-Delay-Seconds: 0 and read a valid positive integer cursor (as a number or numeric string) from meta.delta_last_id. Otherwise, repeat filtered snapshots.
3. Poll with the same sport, market, and book filters: GET /api/v2/markets/delta?last_id=…&sport_id=4&market_ids=1,2,3,41,42,43&affiliate_ids=3,19,23
4. Save the next cursor and continue while meta.has_more is true

Each delta entry is one changed participant/line/book price row and one odds data point. Apply its is_main_line and closed_at fields client-side. If the cursor is stale and returns 400, re-bootstrap once and resume from the new cursor.

A value of 0.0001 is our sentinel for "off the board" — the sportsbook removed this line. It applies to:

• Moneylines, spreads, and totals
• Player and team props
• Both pre-match and in-play markets

How to handle it: In your code, treat 0.0001 as null/unavailable. Display "OFF" or hide the line. On zero-delay plans, /api/v2/markets/delta notifies you when a line is taken down. On delayed plans, refresh your filtered snapshot at the cadence your use case needs.

V2 is our normalized market schema that provides a unified structure across published sportsbook sources. Instead of the legacy per-book V1 format, V2 gives you:

• 550+ market types — moneylines, spreads, totals, player props, team totals, futures, and more
• Consistent structure — every market follows the same participant/line/price schema regardless of sportsbook
• Supported periods — prematch, halves, quarters, and live in-play markets where available

Access V2 data via the /api/v2/ endpoints. Use /api/v2/events/{eventID}/markets for event odds and /api/v2/markets for the full catalog of market definitions.

Sportsbook	BOS -3.5	Movement
PPinnacle	-108	-110↗ -108
DKDraftKings	-110	Unchanged
FDFanDuel	-112	-115↗ -112

Live sports data.One API.