TheRundown
# [Sign up directly on our platform for better rates and plans](https://therundown.io/pricing/api) ## Please see our documentation with guides and examples, including the changelog at http://docs.therundown.io/ We also offer custom plans, so if your daily usage is likely to exceed our MEGA plan, you would like to make use of websockets, or would like to take advantage of our discounts for…
TheRundown endpoints
| Method | Endpoint | Description |
|---|---|---|
| Affiliates (Sportsbooks) | ||
| GET |
Affiliates (Sportsbooks) /affiliates |
Get affiliates (aka sportsbooks). The `affiliate_id` value of each sportsbook is used as the key in the `lines` or `line_periods` events response. For example, `5Dimes` has an… |
| Sports | ||
| GET |
Sports /sports |
Get available sports. Sports may or may not have events depending on season and what is available on sportsbooks. |
| Events (Games) | ||
| GET |
Openers /sports/{sportID}/openers/{date} |
This endpoint provides the opening lines offered for the various sportsbooks (affiliates). The key of the associate array in the lines attribute maps to the affiliate_id of the… |
| GET |
Dates with Odds /sports/{sport-id}/dates |
Get the dates of the sport's events that contain odds that are on or after the current date. To get all the events regardless of whether or not they have odds use the events by… |
| GET |
Event /events/{eventID} |
The /events/{event-id} endpoint can be used to request information for a single event. The currently available odds from each sportsbook will be returned with the game… |
| GET |
Delta (Changed Events) /delta |
The `/delta` endpoint returns only events that have changed since the last request, specified by the delta last id value contained in any /events request. The delta last id… |
| GET |
Closing /sports/{sportID}/closing/{date} |
This endpoint provides the closing lines offered for the various sportsbooks (affiliates). The key of the associate array in the lines attribute maps to the affiliate_id of the… |
| GET |
Events (Games) /sports/{sportID}/events/{date} |
The /sports/{sport-id}/events/{date} endpoint to request events for a particular sport on a particular date. The current odds and markets will be returned when available. To get… |
| Lines (Historical Odds) | ||
| GET |
Totals /lines/{line-id}/total |
Gets the current and historical totals for the provided `line_id`. Each market from each sportsbook for each game has a unique `line_id`. This `line_id` can be used to get… |
| GET |
Moneyline /lines/{lineID}/moneyline |
Gets the current and historical moneyline for the provided `line_id`. Each market from each sportsbook for each game has a unique `line_id`. This `line_id` can be used to get… |
| GET |
Spread /lines/{lineID}/spread |
Gets the current and historical spread for the provided `line_id`. Each market from each sportsbook for each game has a unique `line_id`. This `line_id` can be used to get… |
| Teams | ||
| GET |
Teams /sports/{sportID}/teams |
Teams provides a list of teams that are included in the `normalized_teams` attribute of the events responses. |
| GET |
Divisions /sports/{sport_id}/divisions |
Get divisions for a sport |
| GET |
Conferences /sports/{sportID}/conferences |
Get conferences for a sport |
| V2 (Props & Player/Team Stats) | ||
| GET |
V2 Event Markets /v2/events/{event_id} |
Get markets for an event. Optionally provide participant_ids and participant_types and market_ids. If market_ids are not provided, they will default to 1,2,3. |
| GET |
V2 Markets /v2/events/{event_id}/markets |
Get available markets for an event. Optionally provide participant_type and participant_ids |
| GET |
V2 Players /v2/teams/{team_id}/players |
Players by team |
| GET |
V2 Market Participants /v2/markets/participants |
Get participants for the markets for an event. Optionally provide a list of market_ids |
| GET |
V2 Stats /v2/stats |
Get all available stats. Optionally filter by sport_id |
| GET |
V2 Team Game Stats /v2/events/{event_id}/stats |
Team stats for the event_id |
| GET |
V2 Player Game Stats /v2/events/{event_id}/players/stats |
Player stats for the event_id |
| GET |
V2 Player Season Stats /v2/teams/{team_id}/players/stats |
Player season stats for a taem |
| GET |
V2 Team Season Stats /v2/teams/{team_id}/stats |
Season stats for a team |
| GET |
V2 Markets by sport and date /v2/sports/{sport-id}/markets/{date} |
Get available markets by sport and date endpoint |
| Schedules | ||
| GET |
Schedules /sports/{sportID}/schedule |
Get the schedule for a sportID. Use the `from` parameter to change the starting date in the format of `yyyy-mm-dd` (ex: `2020-09-20`), which defaults to today. Use a `limit`… |
| Other endpoints | ||
| GET |
Stats /stats |
Get all available stats. Optionally filter by sport_id |
| GET |
V2 Event Markets /v2/events/{event_id} |
Get markets for an event. Optionally provide participant_ids and participant_types and market_ids. If market_ids are not provided, they will default to 1,2,3. |
| GET |
V2 Markets /v2/events/{event_id}/markets |
Get available markets for an event. Optionally provide participant_type and participant_ids |
| GET |
Divisions /sports/{sportID}/divisions |
Get divisions for a sport |
| GET |
Conferences /sports/{sportID}/conferences |
Get conferences for a sport |
| GET |
V2 Players /v2/teams/{team_id}/players |
Players by team |
| GET |
V2 Market Participants /v2/markets/participants |
Get participants for the markets for an event. Optionally provide a list of market_ids |
| GET |
Player Game Stats /events/{event_id}/players/stats |
Player stats for the event_id |
| GET |
Teams /sports/{sport_id}/teams |
Teams by sport |
| GET |
Players /teams/{team_id}/players |
Players by team |
| GET |
Team Season Stats /teams/{team_id}/stats |
Season stats for a team |
| GET |
Markets /events/{event_id}/markets |
Get available markets for an event. Optionally provide participant_type and participant_ids |
| GET |
Delta (Changed Events) /delta |
The /v2/delta endpoint returns only markets that have changed since the last request, specified by the delta_last_id value contained in any /events request. The delta last id… |
| GET |
Team Game Stats /events/{event_id}/stats |
Team stats for the event_id |
| GET |
Market Participants /markets/participants |
Get participants for the markets for an event. Optionally provide a list of market_ids |
| GET |
Player season stats /teams/{team_id}/players/stats |
Player season stats for a team |
| GET |
Event Markets /events/{event_id} |
Get markets for an event. Optionally provide participant_ids and participant_types and market_ids. If market_ids are not provided, they will default to 1,2,3. |
| GET |
V2 Markets by sport and date /sports/{sport-id}/markets/{date} |
Get available markets by sport and date |
| GET |
Openers /sports/{sportID}/openers/{date} |
This endpoint provides the opening lines offered for the various sportsbooks (affiliates). The key of the associate array in the lines attribute maps to the affiliate_id of the… |
| GET |
Teams /sports/{sportID}/teams |
Teams provides a list of teams that are included in the `normalized_teams` attribute of the events responses. |
| GET |
Dates with Odds /sports/{sport-id}/dates |
Get the dates of the sport's events that contain odds that are on or after the current date. To get all the events regardless of whether or not they have odds use the events by… |
| GET |
Sports /sports |
Get available sports. Sports may or may not have events depending on season and what is available on sportsbooks. |
| GET |
Totals /lines/{line-id}/total |
Gets the current and historical totals for the provided `line_id`. Each market from each sportsbook for each game has a unique `line_id`. This `line_id` can be used to get… |
| GET |
Schedules /sports/{sportID}/schedule |
Get the schedule for a sportID. Use the `from` parameter to change the starting date in the format of `yyyy-mm-dd` (ex: `2020-09-20`), which defaults to today. Use a `limit`… |
| GET |
Event /events/{eventID} |
The /events/{event-id} endpoint can be used to request information for a single event. The currently available odds from each sportsbook will be returned with the game… |
TheRundown pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $99.99 / month | 1 / second |
|
| ULTRA Recommended | $399.99 / month | 1 / second |
|
| MEGA | Free | 4 / second |
|