> ## Documentation Index
> Fetch the complete documentation index at: https://docs.therundown.io/llms.txt
> Use this file to discover all available pages before exploring further.

# TheRundown Sports API

> Sports betting data from sportsbooks and exchanges — real-time odds, futures, play-by-play, scores, stats, and schedules

## Overview

TheRundown API provides comprehensive sports data through a broad sportsbook-and-exchange roster. Current published coverage includes Bovada, Pinnacle, SportsBetting, BetOnline, BookMaker, BetCRIS, LowVig, Bodog, Intertops, Matchbook, YouWager, DraftKings, Unibet, BetMGM, FanDuel, theScore Bet, Kalshi, Polymarket, Polymarket US, HardRock, ProphetX, Novig, Circa Sports, Bet105, and Heritage Sports. Every published source uses one schema. Coverage spans 550+ market types, futures and outrights, live scores, play-by-play with live game state, game schedules, supported team and player statistics, and historical line data across major North American and international sports leagues. Availability varies by source, sport, market, and effective stats access.

### What you can build

* **Live odds screens**: Real-time moneylines, spreads, and totals from every book we carry, over REST or WebSocket
* **Cross-venue comparison**: Sportsbook and exchange prices on the same events, in the same format
* **Futures boards**: Championship, division, and award futures priced across sportsbooks and exchanges. See the [Futures guide](/guides/futures)
* **Live game trackers**: Play-by-play with running scores and live game state (count and base runners, down and distance, possession), streaming per play over WebSocket
* **Line movement trackers**: Historical price data with charting support, opening and closing lines
* **Player prop tools**: Props, alternates, and combo markets across 550+ market types
* **Team and player stats**: Stat definitions, completed-game and season statistics, with live box-score deltas over WebSocket for Ultra and higher; access and coverage are described in [Stats Access](/guides/stats-access)
* **Sports data apps**: Complete sports data platform with scores, odds, stats, and schedules

### Real-time delivery

Every plan can poll efficiently with [delta endpoints](/guides/efficient-polling). Free includes five-minute delayed pre-match data. Real-time tiers add WebSocket streaming for `markets`, `scores`, `plays`, `stats`, `futures`, and `live` channels over a single connection; WebSocket access requires Ultra or above. Real-time odds updates are sub-second across every book. See the [WebSocket reference](/api-reference/v2/websocket) for protocol details and per-plan connection and subscription limits.

### Supported sports

| Sport | ID | Data Available |
| - | - | - |
| NFL | 2 | Odds, Scores, Schedules, Team Stats, Player Stats, Player Props, Play-by-Play, Futures |
| NBA | 4 | Odds, Scores, Schedules, Team Stats, Player Stats, Player Props, Play-by-Play, Futures |
| MLB | 3 | Odds, Scores, Schedules, Team Stats, Player Stats, Player Props, Play-by-Play, Futures, Pitcher Data |
| NHL | 6 | Odds, Scores, Schedules, Team Stats, Player Stats, Player Props, Play-by-Play, Futures |
| NCAAF | 1 | Odds, Scores, Schedules, Team Stats, Player Stats, Player Props, Play-by-Play, Futures |
| NCAAB | 5 | Odds, Scores, Schedules, Team Stats, Player Stats, Player Props, Play-by-Play, Futures |
| WNBA | 8 | Odds, Scores, Schedules, Team Stats, Player Stats, Player Props, Play-by-Play, Futures |
| UFC/MMA | 7 | Odds, Scores, Schedules, Team Stats, Player Stats |
| CFL | 9 | Odds, Scores, Schedules, Team Stats, Player Stats |
| Soccer | 10-19, 33 | Odds, Scores, Schedules, Team Stats, Player Stats, Player Props, Play-by-Play, Futures |
| ATP Tennis | 38 | Odds, Scores, Schedules, Team Stats, Player Stats |
| WTA Tennis | 39 | Odds, Scores, Schedules, Team Stats, Player Stats |
| Golf | 40 | Futures (Tournament Winner, Top 5/10/20 Finish, Make The Cut, First Round Leader) |
| Formula 1 | 41 | Futures (Drivers' and Constructors' Championship) |

Stats labels in this table identify supported data types, not a guarantee that every stat is published for every sport or that it is available to every API key. See [Stats Access](/guides/stats-access) for account access and coverage limits.

<Info>
  Soccer coverage includes MLS, EPL, Ligue 1, Bundesliga, La Liga, Serie A, UEFA Champions League, UEFA Euro, FIFA, J-League, and UEFA Europa League. Play-by-play coverage spans MLB, NBA, WNBA, NCAAB, NFL, NCAAF, NHL, and soccer, with per-play player attribution rolling out progressively. See [Sport IDs](/reference/sports) for the full list and per-sport feature matrix.
</Info>

### V1 vs V2

**V2 (recommended)** uses a market-based data model where each odds type is a "market" with participants, lines, and prices. This is more flexible and supports player props, alternates, and new market types.

**V1 (legacy)** uses a flat line-based model with separate moneyline, spread, and total objects. V1 is still supported but new features are V2-only.

<CardGroup cols={3}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get your first API response in 2 minutes
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    API key setup and auth methods
  </Card>

  <Card title="Futures & Outrights" icon="trophy" href="/guides/futures">
    Championship, division, and award futures across books and exchanges
  </Card>

  <Card title="WebSocket Streaming" icon="bolt" href="/guides/multiplexed-websocket">
    Markets, plays, stats, futures, and live channels over one connection
  </Card>

  <Card title="Documentation MCP" icon="plug" href="/documentation-mcp">
    Search API documentation from Claude and other AI agents
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/generated/v2-sports/list-all-sports">
    Complete endpoint documentation with interactive playground
  </Card>

  <Card title="Data Model" icon="diagram-project" href="/reference/data-model">
    How events, markets, lines, and prices relate to each other
  </Card>

  <Card title="Reference Tables" icon="table" href="/reference/sports">
    Sport IDs, market IDs, sportsbook IDs
  </Card>

  <Card title="FAQ" icon="circle-question" href="/faq">
    Common questions about the API
  </Card>

  <Card title="OpenAPI Spec" icon="file-code" href="https://docs.therundown.io/openapi.yaml">
    Download the OpenAPI 3.1 spec for client generation and tooling
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.