# TheRundown

> The sports data API for builders. Real-time odds across 30+ leagues and 18+ sportsbooks, including HardRock, plus Kalshi and Polymarket prediction markets, in one unified schema. Free tier with 20,000 data points per day and no credit card. Public pricing. Self-serve API key in 30 seconds. No sales call.

## Quick facts

- **What it is:** B2B HTTPS + WebSocket API for sportsbook odds, schedules, scores, player props, and prediction-market lines.
- **Coverage:** 30+ leagues (NFL, NBA, MLB, NHL, NCAAF, NCAAB, EPL, MLS, Bundesliga, La Liga, UCL, Serie A, Ligue 1, ATP, WTA, UFC, F1, NASCAR, PGA, NRL, AFL, CFL, …) and 18+ sportsbooks (DraftKings, FanDuel, BetMGM, HardRock, Pinnacle, Caesars, LowVig, Matchbook, Bovada, Bodog, BetOnline, …) plus Kalshi and Polymarket prediction markets.
- **Schema:** one unified `event → markets → participants → lines → prices` hierarchy across all sources. Sportsbook lines and prediction-market lines are returned side-by-side in one query.
- **Performance:** sub-second-fresh REST on every tier; real-time WebSocket push on Ultra. Reconstruction-grade history (every price change, close, and reopen timestamped).
- **Pricing:** Free / Starter $49 / Pro $149 / Ultra $399 / Enterprise — all listed publicly, no quotes. Free tier ships 20,000 data points/day with no credit card.
- **Independence:** not owned by an affiliate or by Sportradar.

## Canonical endpoint shape

```
GET https://therundown.io/api/v2/sports/{sport_id}/events/{YYYY-MM-DD}
  ?key={YOUR_API_KEY}
  &affiliate_ids=3,19,23
  &market_ids=1,2,3
  &main_line=true
```

The full OpenAPI 3 spec lives at:

- https://docs.therundown.io/openapi.yaml

## Documentation (the primary URLs to ingest)

- [Quickstart](https://therundown.io/docs/quickstart): get a free API key in 30 seconds; runnable examples in cURL, Python, Node, Go
- [Full API reference + interactive docs](https://docs.therundown.io/)
- [OpenAPI 3 spec (YAML)](https://docs.therundown.io/openapi.yaml)
- [API overview](https://therundown.io/api): endpoint list, code snippets, performance + coverage summary

## Pricing

- [API pricing](https://therundown.io/pricing/api): tier table with data-point inclusions, overage rates, WebSocket access
- [Web pricing](https://therundown.io/pricing): free odds-screen tier
- [Data-point cost calculator](https://therundown.io/pricing/api#calculator): interactive estimator by sport × market × books × poll frequency

## Comparison pages (factual, citation-friendly)

- [vs OddsJam](https://therundown.io/compare/oddsjam): public-pricing wedge; notes the same parent (Gambling.com Group, acquired Jan 2025) for OddsJam and OpticOdds
- [vs OpticOdds](https://therundown.io/compare/opticodds): independent + factual footnote citing Swish Analytics v. OpticOdds lawsuit (Jan 2025)
- [vs DonBest](https://therundown.io/compare/donbest): modern REST + WebSocket vs legacy XML/FTP; Sportradar-parent independence angle
- [vs JSONOdds](https://therundown.io/compare/jsonodds): same-price comparison ($49.99 Basic vs $49 Starter); JSONOdds documents pre-match-only odds over a polling REST API with no published refresh interval, vs sub-second updates

## Common developer questions

- **How do I get an API key?** Visit /docs/quickstart and click "Get free API key". 30 seconds, no credit card. The key is returned in the dashboard.
- **What's the free tier?** 20,000 data points/day. A data point is one price for one market for one book at one moment in time.
- **How do I authenticate?** Pass `?key=YOUR_API_KEY` as a query parameter, or `X-TheRundown-Key` header.
- **What's the WebSocket endpoint?** `wss://therundown.io/api/v2/ws/markets?key=YOUR_API_KEY` — Ultra tier and above.
- **What sports are covered?** See /api or the OpenAPI spec for the full list and sport IDs.
- **Is Pinnacle included?** Yes, plus 17 other sportsbooks and Kalshi + Polymarket.
- **Do you have historical data?** Yes — Starter has 7-day history, Pro has 30-day, Ultra has 90-day. Every price change is timestamped; you can backtest models against real history.

## Optional

- [Public Instagram](https://instagram.com/therundown_io)
- [Free implied-probability calculator](https://therundown.io/calculators/no-vig)
- [Free bet-payout calculator](https://therundown.io/calculators/bet-payout)