Name: TheRundown API
Brand: TheRundown
Availability: InStock

Choose your plan

Start free. Upgrade when you need more. Looking for dashboard features? See Web & Mobile plans

Free
$0/month
No credit card required
20,000/daydata points
- REST API access
- 3 sportsbooks (BetMGM, DK, FD)
- Pre-match odds
- Schedules & reference data
- No player props or alt markets
- No live in-game odds
- No historical data
- 5-minute data delay
1 req/sec rate limit·5 minutes delay
Starter
$49/month
Complete odds data access
5,000,000/modata points
Hard-capped by default · optional overage $0.002/pt ($2/1k)
- All 20+ data sources
- All periods & markets
- Live odds access
- Best lines
- 7-day odds history
- 60-second data delay
- No WebSocket streaming
- No +EV calculations
2 req/sec rate limit·60 seconds delay
Pro
$149/month
+EV tools & faster data
25,000,000/modata points
Hard-capped by default · optional overage $0.001/pt ($1/1k)
- Everything in Starter
- Value / +EV calculations
- Opening & closing lines
- 30-day odds history
- 30-second data delay
- No WebSocket streaming
5 req/sec rate limit·30 seconds delay
Most Popular
Ultra
$399/month
Real-time WebSocket delivery
100,000,000/modata points
Hard-capped by default · optional overage $0.0005/pt ($0.50/1k)
- Everything in Pro
- WebSocket real-time push
- Real-time data
- 90-day odds history
- Priority support
10 req/sec rate limit·Real-time

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

No hidden fees

Cancel anytime

No credit card for Free

Upgrade or downgrade instantly

What is a data point?

For odds, one data point is one returned price row: participant or outcome × line or value × affiliate/data source. V2 event snapshot responses also bill event, score, and live-state rows; the response headers are authoritative.

RequestReturned price rowsCost

GET /api/v2/events/{id}?market_ids=1&affiliate_ids=3&main_line=true&hide_closed=trueTwo-sided event: 2 returned moneyline participant prices × 1 data source2 odds points + event/score/live rows

GET /api/v2/events/{id}?market_ids=1,2,3&affiliate_ids=3,19,23&main_line=true&hide_closed=trueTwo-sided event: 6 returned participant/line rows × 3 data sourcesup to 18 odds points + event/score/live rows

Expanded props or alternate-line snapshot20 returned participant/line rows × 8 data sourcesup to 160 odds points + event/score/live rows

GET /api/v2/markets/delta?last_id=…&sport_id=4&market_ids=1,2,3Zero-delay plans: changed participant/line/book price rows1 point per row

wss://…/api/v2/ws/marketsEach changed price-row message1 data point

GET /api/v2/sports • GET /api/v2/affiliates • GET /api/v2/marketsReference and metadata endpointsFree

Estimate full-snapshot usage

Every successful snapshot bills its returned rows. Use this assumption-based comparison to size a narrow snapshot, choose a polling cadence, and avoid requesting rows your integration does not use.

Illustrative league mix7 events/day estimate

Returned events per full snapshotUse your actual response

Chip counts are illustrative assumptions, not league forecasts. Enter the event count from a representative filtered snapshot; schedules vary materially by date and season.

Data sources / books5

120

Full-snapshot frequencyEvery 5m

Expanded returned price rows per event and data source50

6500

This is not a market count. Set it from one representative response: when X-Datapoints-Breakdown is present, use its odds value ÷ returned events ÷ selected data sources. Otherwise count the returned price rows. This is an observed average; availability, props, alternate lines, and participant counts vary.

Non-odds rows per returned event2

1 · event2 · + score3 · + live state

V2 event snapshot responses add one event datapoint per event, one score datapoint when a score is present, and one more score-category datapoint when live game state is present. Choose the payload you expect.

Recommended bootstrap

Safe main-line snapshot

For a two-sided event, moneyline, spread, and total produce six returned odds rows per event/source when every selected source has every price. Three-way markets return more; availability varies.

market_ids=1,2,3&main_line=true&hide_closed=true

Odds / snapshot: 210
Event/score/live / snapshot: 14
Total / snapshot: 224
Per month: 1.9M
Quota fit*: Starter · $49/mo

Measure before polling

Expanded snapshot

50 observed participant/line price rows per event/source. Actual usage depends on the rows each selected data source returns.

Odds / snapshot: 1,750
Event/score/live / snapshot: 14
Total / snapshot: 1,764
Per month: 15.2M
Quota fit*: Pro · $149/mo

Production pattern: Starter and other delayed plans should poll narrow snapshots at the cadence their use case needs; do not seed a delta cursor from delayed body metadata. On zero-delay plans only, store X-Delta-Last-ID (with body metadata as an older zero-delay fallback), then poll /api/v2/markets/delta. Each changed price row costs one odds point. Confirm the billed total with X-Datapoints. X-Datapoints-Breakdown is optional and is not currently emitted by /api/v2/markets/delta.
*Quota fit is not feature eligibility: confirm that the tier also includes your selected data sources, live/prematch access, delay, history, and rate limit.

Real-time WebSocket

Real-time WebSocket odds delivery

Stop polling. Get odds pushed to your app, with updates that are sub-second on sharp books. Ultra plan subscribers get WebSocket streaming with real-time data across all currently published sources.

0sData delay

Sub-second on sharp books.Data freshness

20+Data Sources

WebSocket

00:00:01.234 odds_update book: "DraftKings" spread: -3.5 → -4.0 juice: -110 → -10500:00:01.891 odds_update book: "FanDuel"▊

Higher-volume plans

All Ultra features with higher data limits, rate limits, and deeper history.

Super
$649/month
Scaling production workloads
- Everything in Ultra
- 6-month odds history
- Priority support
250,000,000/mo data points · hard cap default; optional $0.0004/pt ($0.40/1k)
15 req/sec rate limit·Real-time
Mega
$999/month
Sportsbook-grade volume
- Everything in Super
- 1-year odds history
500,000,000/mo data points · hard cap default; optional $0.0003/pt ($0.30/1k)
20 req/sec rate limit·Real-time
Max
$2499/month
Maximum throughput
- Everything in Mega
- Unlimited odds history
- Dedicated support
2,500,000,000/mo data points · hard cap default; optional $0.0001/pt ($0.10/1k)
50 req/sec rate limit·Real-time
Enterprise
Contact us
Unlimited scale & dedicated support
- Everything in Max
- Custom data points & rate limits
- Dedicated support & SLA
Custom data points
Custom rate limit·Real-time
Talk to Sales

Compare every feature

See exactly what's included in each plan. No surprises.

	Free$0Start Building	Starter$49/moGet Started	Pro$149/moUpgrade to Pro	Ultra$399/moGo Real-Time
Data & Delivery
REST API access
Data delay	5 min	60 sec	30 sec	Real-time
Rate limit	1/sec	2/sec	5/sec	10/sec
Data points	20K/day	5M/mo	25M/mo	100M/mo
WebSocket real-time push
Odds Coverage
Bookmakers	3	All	All	All
Markets & periods	Full game	All	All	All
Live in-play odds
Pre-match odds
Best lines across books
Historical Data
Odds history		7 days	30 days	90 days
Opening lines
Closing lines
Analytics & Tools
Schedules & reference data
Scores & results
Player stats
Value / +EV calculations
Support
API documentation
Support level	Community	Email	Email	Priority

Super, Mega, Max & Enterprise include all Ultra features with higher volume limits. See volume plans

Free$0

REST API access

Data delay5 min

Rate limit1/sec

Data points20K/day

WebSocket real-time push

Bookmakers3

Markets & periodsFull game

Live in-play odds

Pre-match odds

Best lines across books

Odds history

Opening lines

Closing lines

Schedules & reference data

Scores & results

Player stats

Value / +EV calculations

API documentation

Support levelCommunity

Starter$49/mo

REST API access

Data delay60 sec

Rate limit2/sec

Data points5M/mo

WebSocket real-time push

BookmakersAll

Markets & periodsAll

Live in-play odds

Pre-match odds

Best lines across books

Odds history7 days

Opening lines

Closing lines

Schedules & reference data

Scores & results

Player stats

Value / +EV calculations

API documentation

Support levelEmail

Pro$149/mo

REST API access

Data delay30 sec

Rate limit5/sec

Data points25M/mo

WebSocket real-time push

BookmakersAll

Markets & periodsAll

Live in-play odds

Pre-match odds

Best lines across books

Odds history30 days

Opening lines

Closing lines

Schedules & reference data

Scores & results

Player stats

Value / +EV calculations

API documentation

Support levelEmail

Ultra$399/mo

REST API access

Data delayReal-time

Rate limit10/sec

Data points100M/mo

WebSocket real-time push

BookmakersAll

Markets & periodsAll

Live in-play odds

Pre-match odds

Best lines across books

Odds history90 days

Opening lines

Closing lines

Schedules & reference data

Scores & results

Player stats

Value / +EV calculations

API documentation

Support levelPriority

Built for developers and production teams

20+Data Sources

22 + 9Leagues · variants

Sub-second on sharp books.Data freshness

5M/moStarter quota

$ curl "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: $RUNDOWN_KEY"

Start building in minutes

Get your API key and make your first request today. Free tier included.

Explore the API

Frequently Asked API Questions

Common Questions

Sign up for the Free plan — no credit card required. You get 20,000 data points per day, access to 3 sportsbooks, and pre-match odds immediately. When you need more, upgrade to Starter ($49/mo) for all 20+ 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 daily hard cap — requests return a 429 status once 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. Rates are Starter $0.002/point ($2/1k), Pro $0.001/point ($1/1k), Ultra $0.0005/point ($0.50/1k), Super $0.0004/point ($0.40/1k), Mega $0.0003/point ($0.30/1k), and Max $0.0001/point ($0.10/1k). Enterprise plans have custom limits. Contact us for details.

20+ sportsbooks and exchanges:

Sportsbooks (16): Pinnacle, HardRock, Bet365, theScore Bet, FanDuel, BetMGM, DraftKings, Unibet, Bodog, Bovada, Matchbook, BetOnline, LowVig, SportsBetting, Intertops, YouWager
Exchange-model sources (5): Kalshi, Polymarket, Polymarket US, Novig, ProphetX

Every operator is normalized into a single schema — same event/markets/lines/prices hierarchy for sportsbook and prediction-market prices.

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 keep snapshots narrow and poll only at the cadence their use case needs. On a zero-delay plan, use the snapshot's X-Delta-Last-ID with /api/v2/markets/delta, where 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.

Connect to our V2 WebSocket for real-time odds deltas:

wss://therundown.io/api/v2/ws/markets?key=YOUR_KEY

Filtering:
• Single book: affiliate_ids=3 (Pinnacle)
• Multiple books: affiliate_ids=2,3,19 (Bovada + Pinnacle + DraftKings)
• Scores + book: affiliate_ids=0,3 (score updates + Pinnacle)

Each message contains the event ID, market, and only the fields that changed. Delivery is sub-second on sharp books. Available on Ultra plans and above.