18+Data Sources

600+Markets

Sub-secondPush updates

99.99%Uptime

30+Leagues

1M+Daily Requests

Every endpoint. Zero guesswork.

RESTful design. Predictable URLs. JSON everywhere. WebSocket when you need speed.

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

All events for a sport on a date with real-time odds from every book. The most-used endpoint.

Avg latencysub-second

Request

curl "https://therundown.io/api/v2/sports/4/events/2026-02-12?key=YOUR_KEY&market_ids=1,2,3&offset=300"

Response preview

{
  "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, stats, and markets across major sports, sportsbooks, and supported prediction markets.

Coverage

18+ Data Sources

Published sportsbooks and prediction markets normalized into a single schema.

PinnacleDraftKingsFanDuelBetMGMBet365BovadaKalshiPolymarketUnibetMatchbookBodogBetOnlineLowVig

Depth

600+ Markets

Moneyline18+ sources

Spread18+ sources

Totals18+ sources

Player Props200+ types

Team Totals12 books

Futures8 books

Live In-Playreal-time

Alternate Lines100+ per game

Real-Time WebSocket

Sub-second odds deltas.
No polling. Ever.

Sub-secondupdates

Global

30+ Leagues

•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 & Stats

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

$ curl -s "https://therundown.io/api/v2/sports/4/events/2026-02-12\
  ?key=YOUR_KEY&market_ids=1,2,3&offset=300" | jq .

{
  "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": [...] }
    ]
  }]
}

API plans & pricing

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

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
then $0.002/pt
- All 18+ bookmakers
- 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
then $0.001/pt
- 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
Zero-latency WebSocket delivery
100,000,000/modata points
then $0.0005/pt
- Everything in Pro
- WebSocket real-time push
- Zero data delay
- 90-day odds history
- Priority support
10 req/sec rate limit·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
- 6-month odds history
- Priority support
250,000,000/mo data points · then $0.0004/pt
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 · then $0.0003/pt
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 · then $0.0001/pt
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

$ curl therundown.io/api/v2/sports?key=YOUR_KEY

Get your API key in 30 seconds

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

Start Free Read the Docs

Frequently Asked API Questions

General API Questions

How do I get started?: 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 books and live data, or Pro ($149/mo) for near real-time updates with 30-second delay. See all plans.
Where are the API docs?: Full documentation is at docs.therundown.io. Covers every endpoint, query parameter, response schema, and WebSocket protocol. Code examples in cURL, Python, Node, and Go.
What happens if I exceed my data point limit?: 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.

On paid plans (Starter through Max), you can enable pay-as-you-go overage so you never miss a line movement — or set a hard limit to prevent any overage entirely. Enterprise plans have custom limits. Contact us for details.
Which sportsbooks and prediction markets do you cover?: 18+ data sources across the full operator landscape:

Major US regulated: DraftKings, FanDuel, BetMGM, Hard Rock Bet, theScore Bet
Sharp / reduced-juice: Pinnacle, LowVig
Betting exchange: Matchbook
Offshore (US-accessible): Bovada, Bodog, BetOnline, Sportsbetting.ag, Intertops, YouWager
International: Unibet (Kindred Group)
Prediction markets: Kalshi (CFTC-regulated event contracts), Polymarket

Every operator is normalized into a single schema — same event/markets/lines/prices hierarchy whether you're querying Pinnacle's sharp lines or Polymarket's event contracts. Live in-play odds available for Pinnacle, DraftKings, FanDuel, BetMGM, Bovada, Bodog, Matchbook, and Unibet.
What sports and leagues are supported?: 30+ leagues across every major sport:

US Pro: NFL, NBA, MLB, NHL, WNBA, MLS, UFC/MMA
College: NCAAF, NCAAB
Soccer: EPL, Champions League, La Liga, Bundesliga, Serie A, Ligue 1, MLS, World Cup
Tennis: ATP, WTA
Other: Cricket and more

Each league has sport-specific markets, periods, and prop types.

Technical API Questions

How should I architect my integration?: The recommended pattern:

1. Bootstrap with a full snapshot
Call GET /api/v2/sports/{sport_id}/events/{date}?market_ids=1,2,3 to load all events for the day with moneyline, spread, and total odds. Add more market_ids for player props (29, 35, 39, etc.).

2. Poll with /delta for changes
Store the delta_last_id from each response. Pass it on the next call: GET /api/v2/delta?last_id=…&sport_id=4. You only get what changed — typically 1-5 events per call.

3. Or skip polling entirely
Connect via WebSocket at wss://therundown.io/api/v2/ws/markets?key=YOUR_KEY and receive sub-second pushes. Filter by affiliate_ids to limit to specific books.

Use market_ids to control which odds markets are returned and affiliate_ids to filter to specific sportsbooks.
How does the WebSocket stream work?: 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. Updates are sub-second. Available on Ultra plans and above.
What counts as a "data point"?: Each market × sportsbook combination in a response counts as one data point. Use market_ids and affiliate_ids to control cost. Examples:

• GET /v2/sports/4/events/2026-02-12?market_ids=1,2,3 — 15 games × 3 markets × 8 books = ~360 data points
• GET /v2/events/{id}?market_ids=1,2,3 — 1 event × 3 markets × 16 books = ~48 data points
• GET /v2/events/{id}?market_ids=1&affiliate_ids=3 — 1 event × 1 market × 1 book = 1 data point

WebSocket push messages count as 1 data point each. Reference data (/sports, /affiliates, /markets) is always free.
How does the /delta endpoint work?: The /delta endpoint returns only events that changed since your last request. Here's the flow:

1. Make an initial snapshot call: GET /api/v2/sports/4/events/2026-02-12
2. Store the delta_last_id from the meta object in the response
3. On subsequent calls: GET /api/v2/delta?last_id=…&sport_id=4
4. You'll only receive events where odds, scores, or status changed

If too many events changed (400 response), re-bootstrap with a full snapshot and start the delta cycle again. Filter by sport_id to reduce payload size.
What does 0.0001 mean in the response?: 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. The /delta endpoint will notify you when a line is taken down, so you can react in real time.
What are V2 markets?: V2 is our normalized market schema that provides a unified structure across all sportsbooks. Instead of the legacy per-book V1 format, V2 gives you:

• 600+ 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
• Full period support — prematch, halves, quarters, and live in-play markets

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.

Sports data APIfor builders whoship fast.