# TheRundown API

## Docs

- [Get event deltas (V1 format)](https://docs.therundown.io/api-reference/generated/v1-delta/get-event-deltas-v1-format.md)
- [Get event deltas (V2 format via V1 path)](https://docs.therundown.io/api-reference/generated/v1-delta/get-event-deltas-v2-format-via-v1-path.md)
- [Get a single event with lines](https://docs.therundown.io/api-reference/generated/v1-events/get-a-single-event-with-lines.md)
- [Get closing lines for a sport and date](https://docs.therundown.io/api-reference/generated/v1-events/get-closing-lines-for-a-sport-and-date.md)
- [Get event by line ID](https://docs.therundown.io/api-reference/generated/v1-events/get-event-by-line-id.md)
- [Get events with lines for a sport and date](https://docs.therundown.io/api-reference/generated/v1-events/get-events-with-lines-for-a-sport-and-date.md)
- [Get opening lines for a sport and date](https://docs.therundown.io/api-reference/generated/v1-events/get-opening-lines-for-a-sport-and-date.md)
- [Get best lines for multiple events](https://docs.therundown.io/api-reference/generated/v1-lines/get-best-lines-for-multiple-events.md)
- [Get moneylines for an event](https://docs.therundown.io/api-reference/generated/v1-lines/get-moneylines-for-an-event.md)
- [Get spreads for an event](https://docs.therundown.io/api-reference/generated/v1-lines/get-spreads-for-an-event.md)
- [Get team totals for an event](https://docs.therundown.io/api-reference/generated/v1-lines/get-team-totals-for-an-event.md)
- [Get totals (over/under) for an event](https://docs.therundown.io/api-reference/generated/v1-lines/get-totals-overunder-for-an-event.md)
- [List all sportsbooks (alias)](https://docs.therundown.io/api-reference/generated/v1-reference/list-all-sportsbooks-alias.md)
- [List all sportsbooks/affiliates](https://docs.therundown.io/api-reference/generated/v1-reference/list-all-sportsbooksaffiliates.md)
- [List season types per sport](https://docs.therundown.io/api-reference/generated/v1-reference/list-season-types-per-sport.md)
- [Get available dates for a sport](https://docs.therundown.io/api-reference/generated/v1-sports/get-available-dates-for-a-sport.md)
- [Get conferences for a sport](https://docs.therundown.io/api-reference/generated/v1-sports/get-conferences-for-a-sport.md)
- [Get divisions for a sport](https://docs.therundown.io/api-reference/generated/v1-sports/get-divisions-for-a-sport.md)
- [Get event schedule for a sport](https://docs.therundown.io/api-reference/generated/v1-sports/get-event-schedule-for-a-sport.md)
- [Get teams for a sport](https://docs.therundown.io/api-reference/generated/v1-sports/get-teams-for-a-sport.md)
- [List all sports](https://docs.therundown.io/api-reference/generated/v1-sports/list-all-sports.md)
- [V1 WebSocket — stream real-time event and market updates](https://docs.therundown.io/api-reference/generated/v1-websocket/v1-websocket-—-stream-real-time-event-and-market-updates.md): Establishes a WebSocket connection for streaming V1 event updates and V2 market price deltas.
- [Get a single event with markets](https://docs.therundown.io/api-reference/generated/v2-events/get-a-single-event-with-markets.md)
- [Get best available line for an event](https://docs.therundown.io/api-reference/generated/v2-events/get-best-available-line-for-an-event.md): Returns the best moneyline, spread, and total across all sportsbooks.
- [Get event changes since a delta ID](https://docs.therundown.io/api-reference/generated/v2-events/get-event-changes-since-a-delta-id.md): Returns raw JSON delta payloads for events that changed since `last_id`. Each delta entry is a raw JSON string containing the full event update — the `data` field is a serialized JSON string, not a parsed object.
- [Get events with markets for a sport and date](https://docs.therundown.io/api-reference/generated/v2-events/get-events-with-markets-for-a-sport-and-date.md): Returns events with full market/odds data for the specified sport and date. This is the primary endpoint for building odds screens.
- [Get opening lines for a sport and date](https://docs.therundown.io/api-reference/generated/v2-events/get-opening-lines-for-a-sport-and-date.md): Returns events with the earliest recorded market prices (opening lines).
- [Get opening prices for an event](https://docs.therundown.io/api-reference/generated/v2-events/get-opening-prices-for-an-event.md)
- [Get available markets for a sport and date](https://docs.therundown.io/api-reference/generated/v2-markets/get-available-markets-for-a-sport-and-date.md)
- [Get available markets for an event](https://docs.therundown.io/api-reference/generated/v2-markets/get-available-markets-for-an-event.md): Returns the list of market definitions available for this event (not prices — use the event endpoint with market_ids for prices).
- [Get line price chart data for a specific market](https://docs.therundown.io/api-reference/generated/v2-markets/get-line-price-chart-data-for-a-specific-market.md): Returns time-series price data suitable for charting line movement.
- [Get market participants](https://docs.therundown.io/api-reference/generated/v2-markets/get-market-participants.md): Returns participants (teams, players, or results) for specified markets and events.
- [Get market price changes since a given ID](https://docs.therundown.io/api-reference/generated/v2-markets/get-market-price-changes-since-a-given-id.md): Returns market line price changes (new, updated, closed) since the specified `last_id`. Use for efficient polling.
- [Get market price history for an event](https://docs.therundown.io/api-reference/generated/v2-markets/get-market-price-history-for-an-event.md)
- [Get opening prices for an event's markets](https://docs.therundown.io/api-reference/generated/v2-markets/get-opening-prices-for-an-events-markets.md)
- [Get price history for specific market line prices](https://docs.therundown.io/api-reference/generated/v2-markets/get-price-history-for-specific-market-line-prices.md)
- [List all market definitions](https://docs.therundown.io/api-reference/generated/v2-markets/list-all-market-definitions.md): Returns all canonical market definitions with IDs, names, period info, and whether the line value represents a participant.
- [Get a player by ID](https://docs.therundown.io/api-reference/generated/v2-players/get-a-player-by-id.md)
- [List all sportsbooks (alias for /affiliates)](https://docs.therundown.io/api-reference/generated/v2-reference/list-all-sportsbooks-alias-for-affiliates.md)
- [List all sportsbooks/affiliates](https://docs.therundown.io/api-reference/generated/v2-reference/list-all-sportsbooksaffiliates.md): Returns all enabled sportsbooks with IDs, names, and URLs. No authentication required.
- [List season types per sport](https://docs.therundown.io/api-reference/generated/v2-reference/list-season-types-per-sport.md)
- [Get available dates for a sport](https://docs.therundown.io/api-reference/generated/v2-sports/get-available-dates-for-a-sport.md)
- [Get available dates for multiple sports](https://docs.therundown.io/api-reference/generated/v2-sports/get-available-dates-for-multiple-sports.md): Returns dates with events for the specified sport IDs.
- [Get available markets by date](https://docs.therundown.io/api-reference/generated/v2-sports/get-available-markets-by-date.md): Returns available market definitions for each sport on the given date.
- [Get conferences for a sport](https://docs.therundown.io/api-reference/generated/v2-sports/get-conferences-for-a-sport.md)
- [Get divisions for a sport](https://docs.therundown.io/api-reference/generated/v2-sports/get-divisions-for-a-sport.md)
- [Get events across sports for a date](https://docs.therundown.io/api-reference/generated/v2-sports/get-events-across-sports-for-a-date.md): Returns event IDs grouped by sport for the given date.
- [Get teams for a sport](https://docs.therundown.io/api-reference/generated/v2-sports/get-teams-for-a-sport.md)
- [List all sports](https://docs.therundown.io/api-reference/generated/v2-sports/list-all-sports.md): Returns all available sports with their IDs. No authentication required.
- [Get player game stats for an event](https://docs.therundown.io/api-reference/generated/v2-stats/get-player-game-stats-for-an-event.md)
- [Get team game stats for an event](https://docs.therundown.io/api-reference/generated/v2-stats/get-team-game-stats-for-an-event.md)
- [List all stat definitions](https://docs.therundown.io/api-reference/generated/v2-stats/list-all-stat-definitions.md)
- [Get a team by ID](https://docs.therundown.io/api-reference/generated/v2-teams/get-a-team-by-id.md)
- [Get player season stats for a team](https://docs.therundown.io/api-reference/generated/v2-teams/get-player-season-stats-for-a-team.md)
- [Get players for a team](https://docs.therundown.io/api-reference/generated/v2-teams/get-players-for-a-team.md)
- [Get season stats for a team](https://docs.therundown.io/api-reference/generated/v2-teams/get-season-stats-for-a-team.md)
- [Markets WebSocket — stream real-time market price updates](https://docs.therundown.io/api-reference/generated/v2-websocket/markets-websocket-—-stream-real-time-market-price-updates.md): Establishes a WebSocket connection for streaming V2 market price changes in real-time.
- [Authentication](https://docs.therundown.io/authentication.md): Learn how to authenticate your requests to TheRundown API using API keys.
- [Changelog](https://docs.therundown.io/changelog.md): Recent updates, new features, and improvements to TheRundown API.
- [Errors](https://docs.therundown.io/errors.md): HTTP status codes, error response formats, and troubleshooting guidance for TheRundown API.
- [FAQ](https://docs.therundown.io/faq.md): Frequently asked questions about TheRundown API — data model, common issues, and integration tips.
- [Building an Odds Screen](https://docs.therundown.io/guides/building-odds-screen.md): Step-by-step guide to building a real-time odds screen with moneyline, spread, and total columns using TheRundown API and WebSocket.
- [Efficient Polling](https://docs.therundown.io/guides/efficient-polling.md): Optimize data-point usage with delta endpoints, tight filters, smart polling intervals, and caching strategies.
- [Getting Live Odds](https://docs.therundown.io/guides/getting-live-odds.md): Fetch real-time moneylines, spreads, and totals from multiple sportsbooks using the V2 events endpoint.
- [Historical Odds & Line Movement](https://docs.therundown.io/guides/historical-odds.md): Retrieve opening lines, closing lines, and full price history to build line movement charts and analyze odds changes over time.
- [Player Props](https://docs.therundown.io/guides/player-props.md): Fetch player prop odds including points, rebounds, assists, three-pointers, and combo markets using the V2 markets system.
- [V1 to V2 Migration Guide](https://docs.therundown.io/guides/v1-to-v2-migration.md): Understand the differences between V1 and V2 data models and migrate your application from the legacy lines format to the new markets-based system.
- [WebSocket Streaming](https://docs.therundown.io/guides/websocket-streaming.md): Connect to TheRundown WebSocket feeds for real-time odds updates and live market data.
- [TheRundown Sports API](https://docs.therundown.io/introduction.md): Real-time sports betting data, odds, scores, stats, and schedules
- [MCP Server](https://docs.therundown.io/mcp.md): Connect TheRundown API docs to Claude, Cursor, and other AI assistants.
- [Quickstart](https://docs.therundown.io/quickstart.md): Get your first API response, understand your usage headers, and choose the right update path.
- [Rate Limits](https://docs.therundown.io/rate-limits.md): Understand data-point billing, per-second throttles, usage headers, and the different 429 responses you can receive.
- [Data Model](https://docs.therundown.io/reference/data-model.md): How events, markets, participants, lines, and prices relate to each other in the V2 API.
- [Event Status Codes](https://docs.therundown.io/reference/event-statuses.md)
- [Market IDs](https://docs.therundown.io/reference/markets.md)
- [Period IDs](https://docs.therundown.io/reference/periods.md)
- [Sentinel Values](https://docs.therundown.io/reference/sentinel-values.md)
- [Sports & Coverage](https://docs.therundown.io/reference/sports.md)
- [Sportsbook / Affiliate IDs](https://docs.therundown.io/reference/sportsbooks.md)
- [Go SDK](https://docs.therundown.io/sdks/go.md): Use TheRundown API from Go with net/http for REST calls and gorilla/websocket for real-time streaming.
- [JavaScript SDK](https://docs.therundown.io/sdks/javascript.md): Use TheRundown API from JavaScript and TypeScript with the Fetch API and WebSocket class.
- [Python SDK](https://docs.therundown.io/sdks/python.md): Use TheRundown API from Python with the requests library and websockets for real-time data.

## OpenAPI Specs

- [openapi](https://docs.therundown.io/openapi.yaml)

## Optional

- [API Status](https://therundown.instatus.com)
- [Community](https://join.slack.com/t/therundownspace/shared_invite/zt-3t2aa3py9-pdPol0D6GfJHooxlx_mQIw)