# TheRundown

> The sports data API for builders. Real-time odds across 22 leagues + 9 season variants and 18 data sources (16 sportsbooks + Kalshi + Polymarket) 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:** 22 leagues + 9 season variants, 550+ market types, and 18 data sources: 16 sportsbooks plus Kalshi and Polymarket.
- **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 on sharp books. 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. Monthly and annual self-serve plans are hard-capped by default; per-point overage requires explicit opt-in. Opting in without a saved dollar limit creates an initial cap equal to one subscription-period price. New weekly subscriptions automatically meter and bill overage at the listed plan rate; without a saved limit, their fallback is 3× the weekly price. The applicable cap is editable in Spend Controls.
- **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
  &hide_closed=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): assumption-based safe-main-line vs expanded-returned-row snapshot estimates

## 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. TheRundown is sub-second on sharp books.

## 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. For odds, one point is one returned participant/outcome × line/value × affiliate price row. V2 event snapshot responses also bill event, score, and live-state rows. `X-Datapoints` is authoritative for the billed total on billed responses. `X-Datapoints-Breakdown` is optional and is not currently emitted by `/api/v2/markets/delta`.
- **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.
- **How should I poll?** Starter and other delayed plans should request narrow snapshots with `main_line=true&hide_closed=true` only at the cadence their use case needs; every successful snapshot bills its returned rows. Do not seed deltas from delayed body metadata. On zero-delay plans only, store `X-Delta-Last-ID` (using body `meta.delta_last_id` only as an older zero-delay fallback) and poll `/api/v2/markets/delta`.
- **Is Pinnacle included?** Yes on paid tiers, within the 16 sportsbooks; Kalshi and Polymarket complete the 18 data sources.
- **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)