BALLDONTLIE MCP Server
for AI Agents

Create a new account Creates a new user account and returns the API key immediately. No authentication required. Security: this tool is disabled unless ENABLE_SENSITIVE_ACCOUNT_TOOLS is exactly true. Its result may contain credentials or a sensitive billing-session URL.

Create or change subscription Subscribe to a sport, upgrade, or downgrade your plan. If no payment method is on file, returns `402` with a `payment_url` for hosted billing checkout (human must visit to enter card details). If a payment method exists, the subscription change is processed immediately and the response indicates `processing`. Poll `GET /account/v1/subscriptions` to check when the change is reflected. Security: this tool is disabled unless ENABLE_SENSITIVE_ACCOUNT_TOOLS is exactly true. Its result may contain credentials or a sensitive billing-session URL.

Retrieve the authenticated account's profile, including email, overall tier, and per-sport subscription status.

Get current user profile Returns the authenticated user's profile including email, API key, tier, and subscriptions. Security: the MCP response omits the api_key field.

List subscriptions Returns all subscriptions for the authenticated user, enriched with billing provider status when available.

List all available plans Returns all available subscription plans with pricing, rate limits, and links to per-sport OpenAPI specs. Includes paid-only StoryStats plans such as stories_wnba and stories_nfl. BALLDONTLIE all-access includes every sport, Lab, Webhooks, and StoryStats. No authentication required.

Get plan for a specific sport Returns plan details for a single sport. No authentication required.

Get billing portal URL Generates a hosted billing portal URL where a human can update payment methods, view invoices, and manage billing details. Security: this tool is disabled unless ENABLE_SENSITIVE_ACCOUNT_TOOLS is exactly true. Its result may contain credentials or a sensitive billing-session URL.

Get ATP players Retrieve ATP tennis players with optional filters. Men's singles only. Free tier.

Get specific ATP player Retrieve a single ATP player by ID. Free tier.

Get ATP tournaments Retrieve ATP tournaments with optional filters. Free tier.

Get specific ATP tournament Retrieve a single ATP tournament by ID. Free tier.

Get ATP rankings Retrieve current ATP rankings. Free tier.

Get ATP matches Retrieve ATP matches with optional filters. Requires ALL-STAR tier.

Get specific ATP match Retrieve a single ATP match by ID. Requires ALL-STAR tier.

Get ATP Race to Turin Retrieve ATP Race standings for season-ending ATP Finals qualification. Requires ALL-STAR tier.

Get ATP match statistics Retrieve detailed match statistics. Requires GOAT tier.

Get ATP player career statistics Retrieve career statistics for players. Requires GOAT tier.

Get ATP head-to-head record Retrieve head-to-head record between two players. Requires GOAT tier.

Get ATP betting odds Retrieve betting odds for ATP matches. Requires at least one filter. Requires GOAT tier.

Get ATP opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get Bundesliga teams Get all teams participating in the Bundesliga for a given season

Get Bundesliga team rosters Get player roster information for a specific team and season

Get Bundesliga players Get players with optional filtering by team or search term. Supports pagination.

Get Bundesliga player injuries Retrieve the current Bundesliga player injury snapshot. Supports filtering by player IDs, team IDs, or injury status. Requires GOAT tier access.

Get Bundesliga standings Get league standings for a specific season

Get Bundesliga matches Get matches with optional filtering by season, dates, or teams. Supports pagination.

Get Bundesliga match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Supports pagination.

Get Bundesliga match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Supports pagination.

Get Bundesliga player match statistics Get player match statistics with optional filtering by matches or players. Supports pagination.

Get Bundesliga team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagination.

Get Bundesliga betting odds Retrieve betting odds for Bundesliga matches. Supports filtering by match IDs or dates. Bundesliga odds include moneyline odds for home, away, and draw outcomes only (no spreads or totals). Supports pagination.

Get Bundesliga opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get Bundesliga player prop betting odds Retrieve live player prop betting data for Bundesliga matches. Player prop data is LIVE and updated in real-time. We do not store historical data. As matches near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified match in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, fanduel, caesars (more coming soon!)

Get Bundesliga opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get Bundesliga match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for matches in the current and future seasons only; older matches return empty results. Requires GOAT tier.

Get Bundesliga match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative values favor the away side. Available for matches in the current and future seasons only. Requires GOAT tier.

Get Bundesliga match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Available for matches in the current and future seasons only. Requires GOAT tier.

Get Bundesliga player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinates are normalized 0-100. Available for matches in the current and future seasons only. Requires GOAT tier.

Get Bundesliga player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concludes; in-progress matches return zero heatmap rows, with data landing within ~20 minutes of full-time. Requires GOAT tier.

Get Bundesliga pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league position entering the match, and a list of the team's most-recent results. Available for matches in the current and future seasons only. Requires GOAT tier.

Get CBB conferences

Get CBB teams

Get CBB players

Get CBB team standings

Get CBB games

Get CBB rankings

Get active CBB players

Get CBB play-by-play data

Get CBB player batting statistics

Get CBB player pitching statistics

Get CBB team batting statistics

Get CBB team pitching statistics

Get CBB team fielding statistics

Get CBB player season batting statistics

Get CBB player season pitching statistics

Get CBB team season statistics

Get CBB betting odds Retrieve betting odds for CBB games. Either dates or game_ids is required.

Get CBB opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get all CS2 teams Retrieve a list of all professional Counter-Strike 2 teams

Get specific CS2 team Retrieve details for a specific CS2 team

Get all CS2 players Retrieve a list of all professional Counter-Strike 2 players

Get specific CS2 player Retrieve details for a specific CS2 player

Get all CS2 tournaments Retrieve a list of all Counter-Strike 2 tournaments

Get specific CS2 tournament Retrieve details for a specific CS2 tournament

Get team map pool stats Retrieve map pool statistics for a specific CS2 team. Requires ALL-STAR tier or higher.

Get CS2 team rankings Retrieve current official CS2 team rankings based on the Valve World Rankings system. Requires ALL-STAR tier or higher.

Get all CS2 matches Retrieve a list of all CS2 matches with optional filtering. Requires GOAT tier.

Get specific CS2 match Retrieve details for a specific CS2 match. Requires GOAT tier.

Get match maps Retrieve all maps (games) for specified CS2 matches. Requires GOAT tier.

Get match map statistics Retrieve detailed round-by-round statistics for a specific map in a CS2 match. Requires GOAT tier.

Get player match statistics Retrieve player statistics aggregated across all maps in a CS2 match. Requires GOAT tier.

Get player accuracy statistics Retrieve accuracy statistics for a specific CS2 player, broken down by hit groups (body parts). Requires GOAT tier.

Get all Dota 2 teams Retrieve a list of all professional Dota 2 teams

Get all Dota 2 players Retrieve a list of all professional Dota 2 players

Get all Dota 2 heroes Retrieve a list of all Dota 2 heroes

Get all Dota 2 items Retrieve a list of all Dota 2 in-game items

Get all Dota 2 abilities Retrieve a list of all Dota 2 hero abilities

Get Dota 2 tournaments Retrieve a list of professional Dota 2 tournaments. Requires ALL-STAR tier or higher.

Get hero statistics Retrieve aggregate statistics for Dota 2 heroes across professional matches. Requires ALL-STAR tier or higher.

Get Dota 2 matches Retrieve professional Dota 2 matches. Requires GOAT tier.

Get EPL teams Get all teams participating in the English Premier League for a given season

Get EPL team rosters Get player roster information for a specific team and season

Get EPL players Get players with optional filtering by team or search term. Supports pagination.

Get EPL player injuries Retrieve the current EPL player injury snapshot. Supports filtering by player IDs, team IDs, or injury status. Requires GOAT tier access.

Get EPL standings Get league standings for a specific season

Get EPL matches Get matches with optional filtering by season, dates, or teams. Supports pagination.

Get EPL match events Get events (goals, cards, substitutions) for matches. Supports pagination.

Get EPL match lineups Get player lineups for matches. Supports pagination.

Get EPL player match statistics Get individual player statistics for matches. Supports pagination.

Get EPL team match statistics Get team-level statistics for matches. Supports pagination.

Get EPL betting odds Get betting odds for EPL matches. Filter by match IDs or dates. Supports pagination.

Get EPL opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get EPL player prop betting odds Retrieve live player prop betting data for EPL matches. Player prop data is LIVE and updated in real-time. We do not store historical data. As matches near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified match in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, fanduel, caesars (more coming soon!)

Get EPL opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get EPL match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for matches in the current and future seasons only; older matches return empty results. Requires GOAT tier.

Get EPL match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative values favor the away side. Available for matches in the current and future seasons only. Requires GOAT tier.

Get EPL match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Available for matches in the current and future seasons only. Requires GOAT tier.

Get EPL player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinates are normalized 0-100. Available for matches in the current and future seasons only. Requires GOAT tier.

Get EPL player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concludes; in-progress matches return zero heatmap rows, with data landing within ~20 minutes of full-time. Requires GOAT tier.

Get EPL pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league position entering the match, and a list of the team's most-recent results. Available for matches in the current and future seasons only. Requires GOAT tier.

Get F1 drivers Retrieve a list of Formula 1 drivers with optional filtering. FREE tier.

Get F1 teams Retrieve a list of Formula 1 teams with optional filtering. FREE tier.

Get F1 circuits Retrieve a list of Formula 1 circuits with optional filtering. FREE tier.

Get F1 seasons Retrieve a list of Formula 1 seasons. FREE tier.

Get F1 events Retrieve a list of Formula 1 race events (Grand Prix weekends) with optional filtering. FREE tier.

Get F1 sessions Retrieve a list of Formula 1 sessions (Practice, Qualifying, Sprint, Race) with optional filtering. Requires PAID tier or higher.

Get F1 session results Retrieve Formula 1 session results (finishing positions, laps completed, etc.) with optional filtering. Requires PAID tier or higher.

Get F1 driver standings Retrieve Formula 1 Driver Championship standings for a specific season. Requires PAID tier or higher.

Get F1 team standings Retrieve Formula 1 Constructors Championship standings for a specific season. Requires PAID tier or higher.

Get F1 lap times Retrieve detailed lap-by-lap timing data for Formula 1 sessions. Requires PAID+ tier.

Get F1 qualifying results Retrieve detailed qualifying session results including Q1, Q2, and Q3 times. Requires PAID+ tier.

Get F1 pit stops Retrieve pit stop data including duration and timing. Requires PAID+ tier.

Get F1 tire stints Retrieve tire compound and stint data for each driver. Requires PAID+ tier.

Get F1 session weather Retrieve weather conditions during Formula 1 sessions. Requires PAID+ tier.

Get F1 race control messages Retrieve race control messages including flags, safety car, and DRS notifications. Requires PAID+ tier.

Get F1 position history Retrieve lap-by-lap position changes for drivers during sessions. Requires PAID+ tier.

Get F1 session timing stats Retrieve detailed timing statistics including best laps, sector times, and speed trap data. Requires PAID+ tier.

Get F1 track status Retrieve track status changes during sessions (green flag, yellow flag, safety car, etc.). Requires PAID+ tier.

Get F1 futures odds Retrieve futures betting odds for Formula 1 championships (e.g., driver championship winner, constructor championship winner). Requires PAID+ tier.

Get FIFA World Cup teams Retrieve participating nations for the requested World Cup edition(s). Defaults to 2026 when seasons[] is omitted.

Get FIFA World Cup stadiums Retrieve host stadiums used by the requested World Cup edition(s). Defaults to 2026 when seasons[] is omitted.

Get FIFA World Cup group standings Retrieve group stage standings for the requested World Cup edition(s). Defaults to 2026 when seasons[] is omitted. Requires ALL-STAR tier or higher.

Get FIFA World Cup matches Retrieve matches for the requested World Cup edition(s). Cursor-paginated. Requires GOAT tier.

Get FIFA World Cup betting odds Retrieve moneyline, spread, total, and additional match betting markets for World Cup matches. Cursor-paginated. Requires GOAT tier.

Get FIFA opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get FIFA World Cup futures odds Retrieve futures betting odds for the FIFA World Cup. Defaults to 2026 when seasons[] is omitted. Requires GOAT tier.

Get FIFA World Cup player prop betting odds Retrieve live player prop betting data for FIFA World Cup matches. Player prop data is live and updated in real time. This endpoint returns all player props for the specified match in a single response. Cursor pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: betmgm, betrivers, caesars, draftkings, fanatics, fanduel

Get FIFA opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get FIFA World Cup players Retrieve biographical data for players who have appeared in any World Cup squad. When `seasons[]`, `team_ids[]`, and `player_ids[]` are omitted, returns all players across every ingested edition. Requires GOAT tier.

Get FIFA World Cup player injuries Retrieve the current FIFA World Cup player injury snapshot. Supports filtering by World Cup edition, player IDs, team IDs, or injury status. Defaults to the current edition when `seasons[]` is omitted. Requires GOAT tier.

Get FIFA World Cup tournament rosters Retrieve per-tournament squad entries with cumulative tournament stats. When `seasons[]` is omitted, returns rosters across every ingested edition. Requires GOAT tier.

Get FIFA World Cup match lineups Retrieve registered match-day squads (starters + substitutes). Requires GOAT tier.

Get FIFA World Cup match events Retrieve time-ordered match incidents (goals, cards, substitutions, period markers, shootout kicks). Requires GOAT tier.

Get FIFA World Cup player match stats Retrieve per-player per-match performance stats. Requires GOAT tier.

Get FIFA World Cup team match stats Retrieve per-team per-match aggregates. Requires GOAT tier.

Get FIFA World Cup match shots Retrieve shot-map entries with xG / xGoT and pitch coordinates. Requires GOAT tier.

Get FIFA World Cup match attack momentum Retrieve per-minute attack momentum values. Requires GOAT tier.

Get FIFA World Cup match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Requires GOAT tier.

Get FIFA World Cup player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Requires GOAT tier.

Get FIFA World Cup pre-match team form Retrieve a pre-match team form summary (recent average rating, position, and a five-character form string per side). Requires GOAT tier.

Get La Liga teams Get all teams participating in La Liga for a given season

Get La Liga team rosters Get player roster information for a specific team and season

Get La Liga players Get players with optional filtering by team or search term. Supports pagination.

Get La Liga player injuries Retrieve the current La Liga player injury snapshot. Supports filtering by player IDs, team IDs, or injury status. Requires GOAT tier access.

Get La Liga standings Get league standings for a specific season

Get La Liga matches Get matches with optional filtering by season, dates, or teams. Supports pagination.

Get La Liga match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Supports pagination.

Get La Liga match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Supports pagination.

Get La Liga player match statistics Get player match statistics with optional filtering by matches or players. Supports pagination.

Get La Liga team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagination.

Get La Liga betting odds Retrieve betting odds for La Liga matches. Supports filtering by match IDs or dates. La Liga odds include moneyline odds for home, away, and draw outcomes only (no spreads or totals). Supports pagination.

Get La Liga opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get La Liga player prop betting odds Retrieve live player prop betting data for La Liga matches. Player prop data is LIVE and updated in real-time. We do not store historical data. As matches near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified match in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, fanduel, caesars (more coming soon!)

Get La Liga opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get La Liga match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for matches in the current and future seasons only; older matches return empty results. Requires GOAT tier.

Get La Liga match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative values favor the away side. Available for matches in the current and future seasons only. Requires GOAT tier.

Get La Liga match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Available for matches in the current and future seasons only. Requires GOAT tier.

Get La Liga player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinates are normalized 0-100. Available for matches in the current and future seasons only. Requires GOAT tier.

Get La Liga player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concludes; in-progress matches return zero heatmap rows, with data landing within ~20 minutes of full-time. Requires GOAT tier.

Get La Liga pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league position entering the match, and a list of the team's most-recent results. Available for matches in the current and future seasons only. Requires GOAT tier.

Get Ligue 1 teams Get all teams participating in Ligue 1 for a given season

Get Ligue 1 team rosters Get player roster information for a specific team and season

Get Ligue 1 players Get players with optional filtering by team or search term. Supports pagination.

Get Ligue 1 player injuries Retrieve the current Ligue 1 player injury snapshot. Supports filtering by player IDs, team IDs, or injury status. Requires GOAT tier access.

Get Ligue 1 standings Get league standings for a specific season

Get Ligue 1 matches Get matches with optional filtering by season, dates, or teams. Supports pagination.

Get Ligue 1 match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Supports pagination.

Get Ligue 1 match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Supports pagination.

Get Ligue 1 player match statistics Get player match statistics with optional filtering by matches or players. Supports pagination.

Get Ligue 1 team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagination.

Get Ligue 1 betting odds Retrieve betting odds for Ligue 1 matches. Supports filtering by match IDs or dates. Ligue 1 odds include moneyline odds for home, away, and draw outcomes only (no spreads or totals). Supports pagination.

Get Ligue 1 opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get Ligue 1 player prop betting odds Retrieve live player prop betting data for Ligue 1 matches. Player prop data is LIVE and updated in real-time. We do not store historical data. As matches near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified match in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, fanduel, caesars (more coming soon!)

Get Ligue 1 opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get Ligue 1 match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for matches in the current and future seasons only; older matches return empty results. Requires GOAT tier.

Get Ligue 1 match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative values favor the away side. Available for matches in the current and future seasons only. Requires GOAT tier.

Get Ligue 1 match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Available for matches in the current and future seasons only. Requires GOAT tier.

Get Ligue 1 player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinates are normalized 0-100. Available for matches in the current and future seasons only. Requires GOAT tier.

Get Ligue 1 player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concludes; in-progress matches return zero heatmap rows, with data landing within ~20 minutes of full-time. Requires GOAT tier.

Get Ligue 1 pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league position entering the match, and a list of the team's most-recent results. Available for matches in the current and future seasons only. Requires GOAT tier.

Get all LOL teams Retrieve a list of all professional League of Legends teams

Get all LOL players Retrieve a list of all professional League of Legends players

Get all LOL champions Retrieve a list of all League of Legends champions

Get all LOL items Retrieve a list of all League of Legends in-game items

Get all LOL summoner spells Retrieve a list of all League of Legends summoner spells

Get all LOL rune paths Retrieve a list of all League of Legends rune paths (Domination, Inspiration, Precision, Resolve, Sorcery)

Get all LOL runes Retrieve a list of all League of Legends runes with their paths and types

Get LOL tournaments Retrieve a list of professional League of Legends tournaments. Requires ALL-STAR tier or higher.

Get champion statistics Retrieve aggregate statistics for LOL champions across professional matches. Requires ALL-STAR tier or higher.

Get LOL matches Retrieve professional League of Legends matches. Requires GOAT tier.

Get MLB teams

Get specific MLB team

Get MLB players

Get specific MLB player

Get MLB player injuries

Get active MLB players

Get MLB games

Get specific MLB game

Get MLB stats

Get MLB team standings

Get MLB season stats

Get MLB team season stats

Get MLB player splits Get player splits grouped by split_category (e.g., vs RHP/LHP, by month, by opponent, etc.)

Get MLB player vs player matchups Get head-to-head batting statistics for batter against pitchers for a specific team, or pitcher against batters from a specific team

Get MLB play-by-play data Returns play-by-play data for a specific game including game state, scoring plays, and batted ball details. Plays are ordered by `order` ascending by default. Set `sort_order=desc` to return the latest plays first. Keep the same `sort_order` when following pagination cursors.

Get MLB plate appearance data Returns plate appearance data for a specific game. Each plate appearance includes the outcome and all individual pitches with detailed advanced pitch metrics. All plate appearances for the game are returned in a single response (no pagination).

Get MLB pitcher pitch type game stats Returns per-game pitcher pitch-type usage, command, whiff/contact, and damage metrics.

Get MLB hitter pitch type game stats Returns per-game hitter pitch-type usage, command, whiff/contact, and damage metrics.

Get MLB pitcher pitch type season stats Returns season-level pitcher pitch-type usage, command, whiff/contact, and damage metrics.

Get MLB hitter pitch type season stats Returns season-level hitter pitch-type usage, command, whiff/contact, and damage metrics.

Get MLB betting odds Retrieve betting odds for MLB games. Either dates or game_ids is required.

Get all current MLB betting markets Retrieve the current market catalog for one MLB game. This open-ended endpoint includes game, team, inning, player, comparison, milestone, and other market structures without requiring market names or keys to come from a fixed list. Complete current catalogs are available for DraftKings and FanDuel. Sportsbooks supported by the simplified odds or player-props endpoints may not appear here until complete market catalogs are available. Markets are paginated as complete units. Outcomes may have null prices while their status is `locked` or `suspended`. Use `/mlb/v1/odds/player_props` when you only need the simplified single-player over/under and milestone projection.

Get MLB opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get MLB player prop betting odds Retrieve live player prop betting data for MLB games. Player prop data is LIVE and updated in real-time. We do not store historical data. As games near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified game in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Prop types are open-ended. Common examples include: - Batter props: hits, home_runs, total_bases, rbis, stolen_bases, singles, doubles, triples, walks, strikeouts, runs_scored, and hits_runs_rbis - Pitcher props: pitcher_strikeouts, pitcher_outs, pitcher_hits_allowed, pitcher_walks, pitcher_earned_runs, and pitcher_record_a_win Newly available compatible single-player markets can appear without a documentation enum update. Use `/mlb/v1/odds/markets` for the complete current market catalog, including structures that do not fit this simplified response. Available vendors: betmgm, betrivers, caesars, draftkings, fanatics, fanduel

Get MLB opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get MLB DFS slates Returns provider-neutral daily fantasy lineup pools and rules. A slate identifies its format, event window, salary cap, and whether it covers one or multiple games. Use the slate detail endpoint for included events and roster slots, then request draftables for selectable players or teams and their slate-specific salaries. Requires GOAT tier. Current slates are returned by default; use active=false for inactive historical snapshots.

Get a MLB DFS slate Returns one slate with its included real-game events and lineup roster slots. Event game_id values use BALLDONTLIE game IDs when a reference is available. The active flags preserve the state of historical slate members. Requires GOAT tier.

Get MLB DFS draftables Returns players or teams that can be selected for a slate roster slot, including position, salary, availability, and linked BALLDONTLIE entities when available. game_id, player_id, or team_id can be null when no reference is available. Current draftables are returned by default; use active=false for inactive history. Requires GOAT tier.

Get MLB game lineups Get pre-game batting lineups and probable pitchers for MLB games. Lineups typically appear 1-2 hours before first pitch. Lineup data is available starting from the 2026 season.

Get MLS teams Get all teams participating in MLS for a given season

Get MLS team rosters Get player roster information for a specific team and season

Get MLS players Get players with optional filtering by team or search term. Supports pagination.

Get MLS player injuries Retrieve the current MLS player injury snapshot. Supports filtering by player IDs, team IDs, or injury status. Requires GOAT tier access.

Get MLS standings Get league standings for a specific season. MLS uses conference-based standings (Eastern and Western Conference).

Get MLS matches Get matches with optional filtering by season, dates, or teams. Supports pagination.

Get MLS match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Supports pagination.

Get MLS match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Supports pagination.

Get MLS player match statistics Get player match statistics with optional filtering by matches or players. Supports pagination.

Get MLS team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagination.

Get MLS betting odds Retrieve betting odds for MLS matches. Supports filtering by match IDs or dates. MLS odds include moneyline odds for home, away, and draw outcomes only (no spreads or totals). Supports pagination.

Get MLS opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get MLS player prop betting odds Retrieve live player prop betting data for MLS matches. Player prop data is LIVE and updated in real-time. We do not store historical data. As matches near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified match in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, fanduel, caesars (more coming soon!)

Get MLS opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get MLS match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for matches in the current and future seasons only; older matches return empty results. Requires GOAT tier.

Get MLS match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative values favor the away side. Available for matches in the current and future seasons only. Requires GOAT tier.

Get MLS match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Available for matches in the current and future seasons only. Requires GOAT tier.

Get MLS player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinates are normalized 0-100. Available for matches in the current and future seasons only. Requires GOAT tier.

Get MLS player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concludes; in-progress matches return zero heatmap rows, with data landing within ~20 minutes of full-time. Requires GOAT tier.

Get MLS pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league position entering the match, and a list of the team's most-recent results. Available for matches in the current and future seasons only. Requires GOAT tier.

Get all MMA leagues Retrieve a list of all MMA leagues. Note: UFC is the only league with comprehensive coverage.

Get specific MMA league Retrieve details for a specific MMA league

Get MMA events Retrieve a list of MMA events with optional filtering

Get specific MMA event Retrieve metadata for a specific MMA event. Fights are not embedded; retrieve the paginated card with /mma/v1/fights?event_ids[]=159824.

Get MMA fighters Retrieve a list of MMA fighters with optional search and filtering

Get specific MMA fighter Retrieve details for a specific MMA fighter

Get MMA fights Retrieve a list of MMA fights with optional filtering

Get specific MMA fight Retrieve details for a specific MMA fight

Get MMA rankings Retrieve all current fighter rankings grouped by weight class and league. This endpoint does not support query filters or a rankings/{id} endpoint.

Get MMA fight statistics Retrieve detailed fight statistics for fighters

Get specific fight statistics Retrieve statistics for a specific fight performance

Get MMA betting odds Retrieve betting odds for MMA fights. Either event_id or fight_id is required.

Get MMA opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NBA teams

Get specific NBA team

Get NBA players

Get specific NBA player

Get NBA games

Get specific NBA game

Get NBA stats

Get NBA season averages

Get NBA season averages by type

Get NBA team season averages by category Retrieve team season averages for various statistical categories. Each category requires a specific type parameter that determines the exact stats returned. The hustle category does not require a type parameter. **Available category/type combinations:** - general: base, advanced, scoring, misc, opponent, defense, violations - clutch: base, advanced, misc, scoring - shooting: by_zone_base, by_zone_opponent, 5ft_range_base, 5ft_range_opponent - playtype: cut, handoff, isolation, offrebound, offscreen, postup, prballhandler, prrollman, spotup, transition, misc - tracking: painttouch, efficiency, speeddistance, defense, elbowtouch, posttouch, passing, drives, rebounding, catchshoot, pullupshot, possessions - hustle: (no type parameter required) - shotdashboard: overall, pullups, catch_and_shoot, less_than_10_ft

Get NBA team standings

Get active NBA players

Get NBA player injuries

Get live NBA box scores

Get NBA box scores for a specific date

Get NBA game lineups Retrieve starting lineups and bench players for NBA games. **Important Notes:** - Lineup data is only available starting from the 2025 NBA season - Lineup data is only available once the game begins

Get NBA stat leaders

Get NBA betting odds Retrieve betting odds for NBA games, including preseason games when odds are available. Either dates or game_ids is required.

Get NBA opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NBA player prop betting odds Retrieve live player prop betting data for NBA games. Player prop data is LIVE and updated in real-time. We do not store historical data. As games near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified game in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, betway, betrivers, ballybet, betparx, caesars, fanduel, rebet

Get NBA opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NBA advanced stats (V2) Retrieve comprehensive advanced statistics for NBA player performances. This V2 endpoint includes additional metrics from tracking data, hustle stats, defensive matchups, and usage analytics. Includes data from: - Box score advanced (PIE, ratings, efficiency metrics) - Box score misc (fast break points, second chance points) - Box score scoring (shot distribution percentages) - Four factors (effective FG%, turnover rate) - Hustle stats (deflections, contested shots, loose balls) - Defensive matchups (matchup FG%, points allowed) - Player tracking (speed, distance, touches) - Usage stats (percentage of team stats)

Get NBA player contracts by team Returns all player contracts for a specific team and season. Season defaults to current season if not specified.

Get NBA player contracts Returns contracts for a specific player, optionally filtered by seasons. Supports pagination.

Get aggregated NBA player contract data Returns multi-year contract aggregates for a specific player, including total value, guarantees, and contract metadata.

Get NBA DFS slates Returns provider-neutral daily fantasy lineup pools and rules. A slate identifies its format, event window, salary cap, and whether it covers one or multiple games. Use the slate detail endpoint for included events and roster slots, then request draftables for selectable players or teams and their slate-specific salaries. Requires GOAT tier. Current slates are returned by default; use active=false for inactive historical snapshots.

Get a NBA DFS slate Returns one slate with its included real-game events and lineup roster slots. Event game_id values use BALLDONTLIE game IDs when a reference is available. The active flags preserve the state of historical slate members. Requires GOAT tier.

Get NBA DFS draftables Returns players or teams that can be selected for a slate roster slot, including position, salary, availability, and linked BALLDONTLIE entities when available. game_id, player_id, or team_id can be null when no reference is available. Current draftables are returned by default; use active=false for inactive history. Requires GOAT tier.

Get NBA play-by-play data Retrieve play-by-play data for an NBA game. Returns all plays for a game in chronological order, including shot attempts, turnovers, fouls, and other game events. Each play includes the game clock, score, and team information.

Get NCAAB conferences

Get specific NCAAB conference

Get NCAAB teams

Get specific NCAAB team

Get NCAAB players

Get specific NCAAB player

Get active NCAAB players

Get NCAAB team standings Get team standings. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAB games Get games. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get specific NCAAB game

Get NCAAB rankings Get team rankings. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAB play-by-play data

Get NCAAB player game statistics Get player statistics. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAB team game statistics Get team statistics. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAB player season statistics Get player season averages. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAB team season statistics Get team season averages. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAB tournament bracket data Retrieve NCAA Men's Basketball tournament bracket data with optional filters (GOAT tier). Seasons are identified by their starting year (e.g. 2025 for the 2025-26 season). Round IDs: - 1: First Four/Play-in games - 2: Round of 64 (First Round) - 3: Round of 32 (Second Round) - 4: Sweet 16 (Regional Semifinals) - 5: Elite 8 (Regional Finals) - 6: Final Four (National Semifinals) - 7: Championship (National Championship)

Get NCAAB betting odds Retrieve betting odds for NCAAB games. Either dates or game_ids is required.

Get NCAAB opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NCAAF conferences

Get specific NCAAF conference

Get NCAAF teams

Get specific NCAAF team

Get NCAAF players

Get active NCAAF players

Get specific NCAAF player

Get NCAAF standings

Get NCAAF games

Get specific NCAAF game

Get NCAAF rankings

Get NCAAF play-by-play data

Get NCAAF player statistics

Get NCAAF team statistics

Get NCAAF player season statistics

Get NCAAF team season statistics

Get NCAAF betting odds Retrieve betting odds for NCAAF games. Either (season and week) or game_ids is required.

Get NCAAF opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get current NCAAF player prop odds Retrieve current pre-game and live player prop betting odds. Sportsbook availability varies by game and market, and markets may be removed as a game progresses. The response is not paginated. Requires GOAT tier. Supported prop types are `passing_yards`, `passing_tds`, `rushing_yards`, `receiving_yards`, and `anytime_td`. Retained opening prices are available separately from the opening player-props endpoint.

Get NCAAF opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NCAAW conferences

Get specific NCAAW conference

Get NCAAW teams

Get specific NCAAW team

Get NCAAW players

Get specific NCAAW player

Get active NCAAW players

Get NCAAW team standings Get team standings. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAW games Get games. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get specific NCAAW game

Get NCAAW rankings Get team rankings. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAW play-by-play data

Get NCAAW player game statistics Get player statistics. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAW team game statistics Get team statistics. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAW player season statistics Get player season averages. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAW team season statistics Get team season averages. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAW tournament bracket data Retrieve NCAA Women's Basketball tournament bracket data with optional filters (GOAT tier). Seasons are identified by their starting year (e.g. 2025 for the 2025-26 season). Round IDs: - 0: First Four/Play-in games - 1: Round of 64 (First Round) - 2: Round of 32 (Second Round) - 3: Sweet 16 (Regional Semifinals) - 4: Elite 8 (Regional Finals) - 5: Final Four (National Semifinals) - 6: Championship (National Championship)

Get NCAAW betting odds Retrieve betting odds for NCAAW games. Either dates or game_ids is required. Note that NCAAW odds data is sparse — coverage is limited compared to other sports, and not all games will have odds available. Data is only available from the 2025-2026 season onwards.

Get NCAAW opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NFL player designations Requires GOAT access. Returns one row per player and game in the selected week. Supply season and week together; season_types defaults to [2] for an explicit week. When all three are omitted, the next unfinished game determines the current season, phase, and week, excluding canceled and postponed games. season_types requires season and week. Teams on bye have no rows. Historical coverage varies by game and field.

Get NFL teams

Get specific NFL team

Get NFL team roster Retrieve the current roster and depth chart for a specific NFL team. Note: Roster data is only available starting with the 2025 season.

Get NFL players

Get specific NFL player

Get active NFL players

Get NFL games

Get specific NFL game

Get NFL stats

Get NFL team standings

Get NFL player injuries

Get NFL season stats Season totals are unavailable before the first kickoff of the requested season type, so the data array is empty. Rushing and receiving fumble counts cover those play types only. Use game stats for all-play fumble counts; null means unavailable, not zero.

Get NFL advanced rushing stats

Get NFL advanced passing stats

Get NFL advanced receiving stats

Get NFL betting odds Retrieve betting odds for NFL games, including preseason. Either (season and week) or game_ids is required. Week queries default to regular season and postseason; use season_types[]=1 for preseason. A preseason game_id can be queried directly without season_types.

Get NFL opening betting odds Retrieve historical opening betting odds, including preseason when available. Week queries default to regular season and postseason; use season_types[]=1 for preseason. Requires GOAT tier.

Get NFL player prop betting odds Retrieve live player prop betting data for NFL games. Player prop data is LIVE and updated in real-time. We do not store historical data. As games near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified game in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Sportsbook availability varies by game and market. Use the vendor values returned by the endpoint.

Get NFL opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NFL team season stats Retrieve comprehensive team season statistics including offense, defense, special teams, and opponent stats

Get NFL team game stats Retrieve team statistics for individual games

Get NFL fantasy scoring formats Returns season-specific scoring definitions referenced by available fantasy data. The flexible rules object supports standard, PPR, half-PPR, and future scoring structures without changing the response envelope. `scoring_format` filters the returned definitions directly. Requires NFL GOAT tier.

Get NFL fantasy projections Returns season projections when `week` is omitted and weekly lineup projections with game context when `week` is supplied. `scoring_format` selects the score used to filter and order records (PPR by default), while every returned entity includes all available scoring variants. Use `date` for an exact historical snapshot. Requires NFL GOAT tier.

Get NFL weekly fantasy stats Returns observed weekly player or team-defense statistics, game context, and fantasy-point totals for every available scoring variant. `scoring_format` selects the score used to filter and order records (PPR by default). A `week` is required. This endpoint covers regular-season weeks 1 through 18 only and does not accept a postseason filter. Updates are periodic rather than real time, and records can change during an in-progress game when newer results become available. `collected_at` is the collection time, not the game completion time; historical records loaded together can share the same value. There is no fixed post-final availability time. Requires NFL GOAT tier. ### Weekly stats and scoring contract Weekly stats are the latest available observations, not a finalized DFS settlement feed. The supplied Standard, Half PPR, and PPR formats are not DraftKings contest rules. **Identity and missing values.** There is at most one current D/ST record per season, week, and team, linked to its game; a row is not guaranteed for every team or game. `player` is null for D/ST. Corrections update the current record in place rather than creating a revision record. This endpoint does not expose dated revisions. `stats` is a sparse numeric map for both players and D/ST. An explicit zero is a reported numeric value. An absent key contributes zero to the published fantasy-points calculation, but is not a guarantee that the event did not occur or that collection is complete. There is no per-key availability flag to distinguish an omitted zero from an unavailable observation. The season-stat rule about nullable fields does not make weekly key omission equivalent to a reported null. This applies equally to two-point conversions, `fumbles_lost`, return touchdowns, and `offensive_fumble_recovery_touchdowns`. **D/ST counters.** D/ST values are team-level fantasy observations, not a sum that clients should reconstruct from player rows. The following names describe the reported categories; they do not guarantee complete coverage of every return role or event: | Stat keys | Reported category | | --- | --- | | `defensive_sacks`, `defensive_interceptions`, `defensive_safeties` | Sacks, interceptions, and safeties credited to the defense. | | `opponent_fumble_recoveries`, `kicks_blocked` | Opponent fumbles recovered and blocked kicks. | | `interception_return_touchdowns`, `fumble_return_touchdowns`, `blocked_kick_return_touchdowns` | Touchdowns classified by the indicated return type. | | `kick_return_touchdowns`, `punt_return_touchdowns` | Kickoff and punt return touchdowns. | | `two_point_returns`, `one_point_safeties` | Conversion returns worth two points and one-point safeties. | | `offensive_fumble_recovery_touchdowns` | Offensive fumble recoveries for touchdowns; not interchangeable with defensive fumble-return touchdowns. | The API does not provide event identifiers or a guarantee that all touchdown fields are mutually exclusive. A player's return can also be credited to the team's D/ST row; do not add player and team rows to produce a team total. An exhaustive return-role and event-overlap dictionary is not currently available. **Points and yards allowed.** `points_allowed` is the reported points-allowed counter; `dst_points_allowed` is a separate reported D/ST points-allowed counter. Their equality in a particular game does not make them aliases. Neither field has a guaranteed DraftKings points-allowed definition. In particular, this endpoint does not specify an inclusion/exclusion contract for offensive scores, interception/fumble return touchdowns against, kickoff/punt return touchdowns against, blocked-kick returns, safeties, extra points, or one- and two-point conversion returns. Do not infer these rules from the final scoreboard or from the `dst_` prefix. To reproduce a supplied format, use the stat keys in that format's rules; those may use `points_allowed_*` rather than `dst_points_allowed_*`. Bucket values are supplied observations, not recomputed by this endpoint from the raw counters. For observed weekly stats they represent range indicators: `X_to_Y` names inclusive endpoints, `under_100` means less than 100, and `550_plus` means at least 550. The same naming applies to `points_allowed_*`, `dst_points_allowed_*`, and `yards_allowed_*`. Do not assume a scoring-rule list enumerates every available bucket. For example, `points_allowed_18_to_21`, `points_allowed_22_to_27`, and `yards_allowed_300_to_349` can be present even when the format has no rule for them. Such ranges contribute no bucket points under that format; this does not imply all buckets in `stats` are zero. **Calculating totals.** For each rule item, multiply `stats[item.stat]` (zero if absent) by `position_points[position]` when that override exists, otherwise by `points`, then sum the contributions. An override replaces the base value; it does not add to it. For example, `points=6` and `position_points.DST=6` awards six points per event, not twelve. `is_reverse` is descriptive rule metadata and does not apply another sign change in this calculation. Negative scoring is expressed by the effective points value. Each `fantasy_points` entry embeds its season-specific scoring format. `derived=true` indicates a format calculated from another definition; derived Half PPR retains Standard's other rules and scores receptions at 0.5. `rules.schema_version` versions the rule structure, not the stats dictionary. Totals are calculated from the numeric stats using the associated rules and are stored values, not recalculated when you request the endpoint. There is no atomic revision token covering stats, totals, and rules during an update; compare them again on a subsequent fetch if they temporarily differ. For example, Buffalo's 2025 week 1 D/ST row for game 423959 has 2 sacks, 1 opponent fumble recovery, the 35–45 points-allowed bucket, and the 400–449 yards-allowed bucket. The supplied formats score these as `2 + 2 - 3 - 3 = -2`. **Freshness and completeness.** `collected_at` is collection time, not a strictly monotonic sequence or a content revision identifier. Equal timestamps are not a guarantee of identical values. Corrections can appear after the game ends. `game.status_state=final` describes the game, not completion of the stat population; there is no separate completeness or correction-finality signal. A versioned, exhaustive stats-map data dictionary is not currently exposed.

Get NFL fantasy rankings Returns fantasy ranking variants, position ranks, and auction values. The `ranking_type` parameter selects the rank used to filter and order records (PPR by default), while every returned entity includes all available ranking variants. Use `date` for an exact historical snapshot. Requires NFL GOAT tier.

Get NFL fantasy ADP and ownership data Returns average draft position, auction value, rostered and started percentages, and their available changes. Results are ordered by average draft position. Use `date` for an exact historical snapshot. Requires NFL GOAT tier.

Get NFL DFS slates Returns provider-neutral daily fantasy lineup pools and rules. A slate identifies its format, event window, salary cap, and whether it covers one or multiple games. Use the slate detail endpoint for included events and roster slots, then request draftables for selectable players or teams and their slate-specific salaries. Requires GOAT tier. Current slates are returned by default; use active=false for inactive historical snapshots.

Get a NFL DFS slate Returns one slate with its included real-game events and lineup roster slots. Event game_id values use BALLDONTLIE game IDs when a reference is available. The active flags preserve the state of historical slate members. Requires GOAT tier.

Get NFL DFS draftables Returns players or teams that can be selected for a slate roster slot, including position, salary, availability, and linked BALLDONTLIE entities when available. game_id, player_id, or team_id can be null when no reference is available. Current draftables are returned by default; use active=false for inactive history. Requires GOAT tier.

Get NFL play-by-play data Retrieve play-by-play data for NFL games, ordered chronologically by wallclock time

Get NHL teams

Get specific NHL team

Get NHL team season statistics

Get NHL players

Get NHL player season statistics

Get NHL games

Get NHL standings

Get NHL box scores

Get NHL play-by-play data Returns play-by-play data for a specific game. Plays are returned in chronological order with a sequential order field starting from 1.

Get all currently injured NHL players Returns all players currently on the injury report. The data is updated regularly to reflect the latest injury reports.

Get NHL player statistical leaders

Get NHL team statistical leaders

Get NHL betting odds Retrieve betting odds for NHL games. Either dates or game_ids is required.

Get NHL opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NHL player prop betting odds Retrieve live player prop betting data for NHL games. Player prop data is LIVE and updated in real-time. We do not store historical data. As games near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified game in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: fanduel, draftkings, betmgm, caesars, betrivers (more coming soon!)

Get NHL opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get PGA Tour players Retrieve PGA Tour players with optional filters. Free tier.

Get PGA Tour tournaments (v1) Deprecated for new integrations. Use `/pga/v2/tournaments`, which provides normalized dates and optional format information. This v1 route remains operational for existing integrations. Free tier.

Get PGA Tour tournaments Retrieve tournaments with normalized date fields. Set include_format=true to add format_type without changing the default response shape. Free tier.

Get tournament competitors Retrieve players, teams, cup teams, and pairings for one tournament. Requires GOAT tier.

Get format-aware tournament results Retrieve the primary result population for one tournament. PLAYER rows are returned for stroke and match play, TEAM rows for team stroke, and CUP_TEAM rows for team cup. Requires ALL-STAR tier.

Get tournament rounds Retrieve every known round and its round-specific format for one tournament. Free tier. This endpoint is not paginated.

Get format-aware tee groups Retrieve tee groups with complete participant arrays. Pairings and match relationships are preserved when available. Requires GOAT tier.

Get tournament matches Retrieve match-play or team-cup matches with complete side arrays. Returns an empty data array when matches do not apply or are not available. Requires ALL-STAR tier.

Get match hole scores Retrieve hole-by-hole side and player scoring for one match. Requires GOAT tier. This endpoint is not paginated.

Get PGA Tour courses Retrieve golf courses with optional filters. Free tier.

Get PGA tournament results Deprecated for new integrations. Use `/pga/v2/tournament_results` for format-aware player, team, and cup-team results. This v1 route remains operational for existing integrations. Requires ALL-STAR tier.

Get PGA tournament field Deprecated for new integrations. Use `/pga/v2/tournament_competitors` for players, teams, pairings, and cup rosters. This v1 route remains operational for existing integrations. Requires GOAT tier.

Get PGA tee times Deprecated for new integrations. Use `/pga/v2/tee_times` for format-aware tee groups and complete participant arrays. This v1 route remains operational for existing integrations. Requires GOAT tier.

Get tournament course statistics Retrieve hole-by-hole tournament statistics. Requires ALL-STAR tier.

Get course holes Retrieve hole-by-hole course information. Requires ALL-STAR tier.

Get player round results Retrieve round-by-round player scores. Requires GOAT tier.

Get player round statistics Retrieve detailed player round statistics including strokes gained. Use round_number=-1 for tournament totals. Requires GOAT tier.

Get player season statistics Retrieve player season-level statistics. Requires GOAT tier.

Get player scorecards Retrieve hole-by-hole player scores. Requires GOAT tier.

Get PGA futures odds Retrieve futures betting odds for PGA tournaments (e.g., tournament winner). Requires GOAT tier.

Get PGA player props Retrieve player prop betting odds for a PGA tournament (e.g., round scores, hole scores, birdies). Requires GOAT tier.

Get PGA Tour opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get Serie A teams Get all teams participating in Serie A for a given season

Get Serie A team rosters Get player roster information for a specific team and season

Get Serie A players Get players with optional filtering by team or search term. Supports pagination.

Get Serie A player injuries Retrieve the current Serie A player injury snapshot. Supports filtering by player IDs, team IDs, or injury status. Requires GOAT tier access.

Get Serie A standings Get league standings for a specific season

Get Serie A matches Get matches with optional filtering by season, dates, or teams. Supports pagination.

Get Serie A match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Supports pagination.

Get Serie A match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Supports pagination.

Get Serie A player match statistics Get player match statistics with optional filtering by matches or players. Supports pagination.

Get Serie A team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagination.

Get Serie A betting odds Retrieve betting odds for Serie A matches. Supports filtering by match IDs or dates. Serie A odds include moneyline odds for home, away, and draw outcomes only (no spreads or totals). Supports pagination.

Get Serie A opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get Serie A player prop betting odds Retrieve live player prop betting data for Serie A matches. Player prop data is LIVE and updated in real-time. We do not store historical data. As matches near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified match in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, fanduel, caesars (more coming soon!)

Get Serie A opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get Serie A match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for matches in the current and future seasons only; older matches return empty results. Requires GOAT tier.

Get Serie A match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative values favor the away side. Available for matches in the current and future seasons only. Requires GOAT tier.

Get Serie A match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Available for matches in the current and future seasons only. Requires GOAT tier.

Get Serie A player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinates are normalized 0-100. Available for matches in the current and future seasons only. Requires GOAT tier.

Get Serie A player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concludes; in-progress matches return zero heatmap rows, with data landing within ~20 minutes of full-time. Requires GOAT tier.

Get Serie A pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league position entering the match, and a list of the team's most-recent results. Available for matches in the current and future seasons only. Requires GOAT tier.

Get UCL teams Get all teams participating in the Champions League for a given season

Get UCL team rosters Get player roster information for a specific team and season

Get UCL players Get players with optional filtering by team or search term. Supports pagination.

Get UCL player injuries Retrieve the current UCL player injury snapshot. Supports filtering by player IDs, team IDs, or injury status. Requires GOAT tier access.

Get UCL standings Get league standings for a specific season

Get UCL matches Get matches with optional filtering by season, dates, or teams. Supports pagination.

Get UCL match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Supports pagination.

Get UCL match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Supports pagination.

Get UCL player match statistics Get player match statistics with optional filtering by matches or players. Supports pagination.

Get UCL team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagination.

Get UCL betting odds Retrieve betting odds for UCL matches. Supports filtering by match IDs or dates. UCL odds include moneyline odds for home, away, and draw outcomes only (no spreads or totals). Supports pagination.

Get UCL opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get UCL player prop betting odds Retrieve live player prop betting data for UCL matches. Player prop data is LIVE and updated in real-time. We do not store historical data. As matches near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified match in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, fanduel, caesars (more coming soon!)

Get UCL opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get UCL futures odds Retrieve futures betting odds for UEFA Champions League (e.g., tournament winner). Only available for UCL.

Get UCL match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for matches in the current and future seasons only; older matches return empty results. Requires GOAT tier.

Get UCL match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative values favor the away side. Available for matches in the current and future seasons only. Requires GOAT tier.

Get UCL match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Available for matches in the current and future seasons only. Requires GOAT tier.

Get UCL player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinates are normalized 0-100. Available for matches in the current and future seasons only. Requires GOAT tier.

Get UCL player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concludes; in-progress matches return zero heatmap rows, with data landing within ~20 minutes of full-time. Requires GOAT tier.

Get UCL pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league position entering the match, and a list of the team's most-recent results. Available for matches in the current and future seasons only. Requires GOAT tier.

List Valorant regions Returns the available competitive regions. Requires Free tier or higher.

List countries Returns countries and their competitive regions. Requires Free tier or higher.

List tournament series Returns tournament series. Requires Free tier or higher.

List maps Returns Valorant maps and map-pool metadata. Requires Free tier or higher.

List agents Returns Valorant agents. Requires Free tier or higher.

List weapons Returns Valorant weapons. Requires Free tier or higher.

List teams Returns Valorant teams. Requires Free tier or higher.

List players Returns Valorant players. Requires Free tier or higher.

List player profiles Returns competitive profiles linked to players when known. Requires Free tier or higher.

List player crosshairs Returns published player crosshair codes. Requires Free tier or higher.

List aggregate agent statistics Returns aggregate performance statistics by agent. Requires ALL-STAR tier or higher.

List player transfers Returns player and coach transfer history. Requires ALL-STAR tier or higher.

List tournaments Returns Valorant tournaments. Requires ALL-STAR tier or higher.

List tournament stages Returns the stages for one tournament. Requires ALL-STAR tier or higher.

List tournament prizes Returns placements and prizes for one tournament. Requires ALL-STAR tier or higher.

List a tournament roster Returns players and coaches registered for one tournament. Requires ALL-STAR tier or higher.

List matches Returns scheduled, current, and completed Valorant matches. Requires GOAT tier or higher.

List maps for a match Returns the individual maps played in one match. Requires GOAT tier or higher.

List live match snapshots Returns the latest available live snapshot for current matches, including player state. The collection is empty when no matching live snapshot is available. Requires GOAT tier or higher. Live snapshots update while coverage is active. Use the completed-match endpoints for finalized statistics.

List aggregate player statistics Returns career aggregate statistics for competitive player profiles. Requires GOAT tier or higher.

List player statistics for a match Returns finalized aggregate player statistics for one completed match. Requires GOAT tier or higher. This endpoint is completion-only and can return an empty data array while a match is live.

List player statistics for a match map Returns player statistics for one match map. Live snapshots have is_final=false and snapshot_at populated; finalized rows have is_final=true. Requires GOAT tier or higher. During live coverage, completion-only fields can be null. Finalized statistics replace the provisional representation after completion.

List rounds for a match map Returns rounds for one match map. Live snapshots have is_final=false and snapshot_at populated; finalized rows have is_final=true. Requires GOAT tier or higher. Provisional round details are available during covered live maps and are replaced by finalized details after completion.

List player statistics for a round Returns finalized player statistics for one round. Requires GOAT tier or higher. This endpoint is completion-only and can return an empty data array while the map is live.

List team statistics for a round Returns finalized team statistics for one round. Requires GOAT tier or higher. This endpoint is completion-only and can return an empty data array while the map is live.

List player weapon statistics for a match Returns finalized player kill totals by weapon for one match. Requires GOAT tier or higher. This endpoint is completion-only and can return an empty data array while a match is live.

Get WNBA teams

Get specific WNBA team

Get WNBA players

Get active WNBA players

Get specific WNBA player

Get WNBA games

Get specific WNBA game

Get WNBA player statistics

Get WNBA team statistics

Get WNBA player season statistics

Get WNBA team season statistics

Get WNBA player game advanced statistics

Get WNBA team game advanced statistics

Get WNBA player season advanced statistics

Get WNBA team season advanced statistics

Get WNBA player shot location statistics

Get WNBA team shot location statistics

Get WNBA standings

Get WNBA player injuries

Get WNBA betting odds Retrieve betting odds for WNBA games. Either dates or game_ids is required.

Get WNBA opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get WNBA player prop betting odds Retrieve live player prop betting data for WNBA games. Player prop data is LIVE and updated in real-time. We do not store historical data. As games near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified game in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement

Get WNBA opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get WNBA play-by-play data

Get WTA players Retrieve WTA tennis players with optional filters. Women's singles only. Free tier.

Get specific WTA player Retrieve a single WTA player by ID. Free tier.

Get WTA tournaments Retrieve WTA tournaments with optional filters. Free tier.

Get specific WTA tournament Retrieve a single WTA tournament by ID. Free tier.

Get WTA rankings Retrieve current WTA rankings. Free tier.

Get WTA matches Retrieve WTA matches with optional filters. Requires ALL-STAR tier.

Get specific WTA match Retrieve a single WTA match by ID. Requires ALL-STAR tier.

Get WTA player career statistics Retrieve career statistics for WTA players. Requires GOAT tier.

Get WTA head-to-head record Retrieve head-to-head record between two players. Requires GOAT tier.

Get WTA betting odds Retrieve betting odds for WTA matches. Requires at least one filter. Requires GOAT tier.

Get WTA opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get WTA match statistics Retrieve detailed match statistics. Requires GOAT tier.

Retrieve every player contract on a single NBA team for a season.

Retrieve a single player's contracts, optionally narrowed to specific seasons.

Retrieve multi-year contract totals for a single player, including total value and guaranteed money.

Retrieve provider-neutral daily fantasy sports slates, with their format, event window, salary cap and single or multi-game scope.

Retrieve a single DFS slate with its included real-game events and lineup roster slots.

Retrieve the players or teams selectable for a DFS slate roster slot, with position, salary and availability.

Retrieve NBA games filtered by date, date range, season, season type or team.

Retrieve a single NBA game by its BALLDONTLIE game ID.

Retrieve complete box scores for every NBA game played on a specific date.

Retrieve live box scores for NBA games currently in progress.

Retrieve starting lineups and bench players for one or more NBA games.

Retrieve the full chronological play-by-play feed for a single NBA game.

Retrieve current game-level betting odds — moneyline, spread and over/under — for NBA games by date or game ID.

Retrieve the historical opening game-level betting odds for NBA games by date or game ID.

Retrieve live player prop betting lines for a single NBA game, optionally narrowed by player, prop type or sportsbook.

Retrieve the historical opening player prop betting lines for a single NBA game.

Retrieve NBA players with optional name search and team or player ID filters. Includes historical players.

Retrieve a single NBA player by their BALLDONTLIE player ID.

Retrieve only players currently on an NBA roster, with the same search and filter options as Get All Players.

Retrieve current NBA injury reports, optionally filtered by team or player.

Retrieve player season averages for a statistical category — general, clutch, defense or shooting — with a specific split selected by type.

Retrieve per-game player statistics filtered by player, game, date, date range or season.

Retrieve advanced per-game player statistics including efficiency ratings, tracking data, hustle stats, defensive matchups and usage.

Retrieve the NBA league leaders for a single statistic in a given season.

Retrieve all NBA teams, optionally narrowed to a single division or conference.

Retrieve a single NBA team by its BALLDONTLIE team ID.

Retrieve NBA team standings for a season, including conference and division records.

Retrieve team-level season averages for a statistical category, such as general, clutch, shooting, playtype, tracking, hustle or shot dashboard splits.

Rotate API key Generates a new API key and invalidates the old one immediately. The response includes the new key. All subsequent requests must use the new key. Security: this tool is disabled unless ENABLE_SENSITIVE_ACCOUNT_TOOLS is exactly true. Its result may contain credentials or a sensitive billing-session URL.

Cancel subscription Cancel a subscription for a specific sport. Active subscriptions are scheduled for cancellation at the end of the billing period (access continues until then). Incomplete/unpaid subscriptions are canceled immediately. Security: this tool is disabled unless ENABLE_SENSITIVE_ACCOUNT_TOOLS is exactly true. Its result may contain credentials or a sensitive billing-session URL.

Generate checkout URL Creates a hosted billing checkout session for a specific plan and returns the URL. A human must visit this URL to enter payment details. Use this when you want to proactively generate a payment link (e.g., for an onboarding flow). Unlike POST /subscriptions, this endpoint always generates a checkout URL regardless of whether a payment method exists. Security: this tool is disabled unless ENABLE_SENSITIVE_ACCOUNT_TOOLS is exactly true. Its result may contain credentials or a sensitive billing-session URL.

Retrieve a single player's per-game season averages for one season.