Skip to contents

Returns the full futures-betting board for an NBA season, in long format: one row per (market x team). Markets include championship winner, conference winner, division winner, MVP odds, etc. Backed by sports.core.api.espn.com/v2/sports/basketball/leagues/nba/seasons/{season}/futures.

Usage

espn_nba_futures(season = most_recent_nba_season(), ...)

Arguments

season

Season year (numeric). Defaults to the most recent NBA season.

...

Additional arguments; currently unused.

Value

A long-format tibble.

col_nametypesdescription
seasonintegerSeason year.
leaguecharacterLeague slug ("nba").
market_idcharacterESPN futures-market identifier.
market_namecharacterInternal market name (e.g. "NBA - Winner").
market_typecharacterMarket type code (winLeague, winConference, winDivision, ...).
market_displaycharacterHuman-readable name (e.g. "NBA Championship Winner").
provider_idcharacterSportsbook provider identifier.
provider_namecharacterSportsbook provider name (e.g. "ESPN BET").
team_idcharacterESPN team id (parsed from team_ref).
odds_valuecharacterAmerican odds for the team (e.g. "-250", "+800").
team_refcharacter$ref to the per-season team resource.

See also

Other ESPN NBA Functions: espn_nba_athlete_awards(), espn_nba_athlete_career_stats(), espn_nba_athlete_contract(), espn_nba_athlete_contracts(), espn_nba_athlete_eventlog(), espn_nba_athlete_eventlog_v2(), espn_nba_athlete_gamelog(), espn_nba_athlete_info(), espn_nba_athlete_overview(), espn_nba_athlete_seasons(), espn_nba_athlete_splits(), espn_nba_athlete_statisticslog(), espn_nba_athlete_stats(), espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_event_broadcasts(), espn_nba_event_odds(), espn_nba_event_officials(), espn_nba_event_powerindex(), espn_nba_event_predictor(), espn_nba_event_probabilities(), espn_nba_event_propbets(), espn_nba_event_situation(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_game_all(), espn_nba_game_rosters(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_box(), espn_nba_player_stats(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Author

Saiem Gilani

Examples

# \donttest{
  espn_nba_futures(season = 2025)
#> ── ESPN NBA Season Futures ────────────────────────────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-05-19 01:33:52 UTC
#> # A tibble: 586 × 11
#>    season league market_id market_name  market_type market_display   provider_id
#>     <int> <chr>      <int> <chr>        <chr>       <chr>            <chr>      
#>  1   2025 nba         2564 NBA - Winner winLeague   NBA Championshi… 58         
#>  2   2025 nba         2564 NBA - Winner winLeague   NBA Championshi… 58         
#>  3   2025 nba         2564 NBA - Winner winLeague   NBA Championshi… 58         
#>  4   2025 nba         2564 NBA - Winner winLeague   NBA Championshi… 58         
#>  5   2025 nba         2564 NBA - Winner winLeague   NBA Championshi… 58         
#>  6   2025 nba         2564 NBA - Winner winLeague   NBA Championshi… 58         
#>  7   2025 nba         2564 NBA - Winner winLeague   NBA Championshi… 58         
#>  8   2025 nba         2564 NBA - Winner winLeague   NBA Championshi… 58         
#>  9   2025 nba         2564 NBA - Winner winLeague   NBA Championshi… 58         
#> 10   2025 nba         2564 NBA - Winner winLeague   NBA Championshi… 58         
#> # ℹ 576 more rows
#> # ℹ 4 more variables: provider_name <chr>, team_id <chr>, odds_value <chr>,
#> #   team_ref <chr>
# }