Skip to contents

Returns the full futures-betting board for a men's college basketball season, in long format: one row per (market x team). Markets typically cover the NCAA tournament champion and conference winners. Backed by sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/seasons/{season}/futures.

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_mbb_futures(season = most_recent_mbb_season(), ...)

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

Arguments

season

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

...

Additional arguments; currently unused.

Value

A long-format tibble.

col_nametypesdescription
seasonintegerSeason year.
leaguecharacterLeague slug.
market_idcharacterESPN futures-market identifier.
market_namecharacterInternal market name.
market_typecharacterMarket type code.
market_displaycharacterHuman-readable market name.
provider_idcharacterSportsbook provider identifier.
provider_namecharacterSportsbook provider name.
team_idcharacterESPN team id.
odds_valuecharacterAmerican odds for the team.
team_refcharacter$ref to the per-season team resource.

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 MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_game_all(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_team_linescores(), espn_mbb_game_team_roster_entry(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_player_awards(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog_v2(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_stats(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_schedule(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Other ESPN NBA Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_game_all(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_team_linescores(), espn_mbb_game_team_roster_entry(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_player_awards(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog_v2(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_stats(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_schedule(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp(), espn_nba_draft_pick(), espn_nba_freeagents(), espn_nba_player_contracts(), espn_nba_team_depthchart(), espn_nba_transactions()

Author

Saiem Gilani

Examples

# \donttest{
  espn_mbb_futures(season = 2025)
#> ── ESPN MENS-COLLEGE-BASKETBALL Season Futures ────────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-08-27 17:46:52 UTC
#> # A tibble: 1,793 × 11
#>    season league    market_id market_name market_type market_display provider_id
#>     <int> <chr>         <int> <chr>       <chr>       <chr>          <chr>      
#>  1   2025 mens-col…      6099 NCAA(B) - … NA          NCAA(B) - Wes… 58         
#>  2   2025 mens-col…      6099 NCAA(B) - … NA          NCAA(B) - Wes… 58         
#>  3   2025 mens-col…      6099 NCAA(B) - … NA          NCAA(B) - Wes… 58         
#>  4   2025 mens-col…      6099 NCAA(B) - … NA          NCAA(B) - Wes… 58         
#>  5   2025 mens-col…      6099 NCAA(B) - … NA          NCAA(B) - Wes… 58         
#>  6   2025 mens-col…      6099 NCAA(B) - … NA          NCAA(B) - Wes… 58         
#>  7   2025 mens-col…      6099 NCAA(B) - … NA          NCAA(B) - Wes… 58         
#>  8   2025 mens-col…      6099 NCAA(B) - … NA          NCAA(B) - Wes… 58         
#>  9   2025 mens-col…      6099 NCAA(B) - … NA          NCAA(B) - Wes… 58         
#> 10   2025 mens-col…      6099 NCAA(B) - … NA          NCAA(B) - Wes… 58         
#> # ℹ 1,783 more rows
#> # ℹ 4 more variables: provider_name <chr>, team_id <chr>, odds_value <chr>,
#> #   team_ref <chr>
# }
# \donttest{
  espn_nba_futures(season = 2025)
#> ── ESPN NBA Season Futures ────────────────────────────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-08-27 17:46:52 UTC
#> # A tibble: 570 × 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         
#> # ℹ 560 more rows
#> # ℹ 4 more variables: provider_name <chr>, team_id <chr>, odds_value <chr>,
#> #   team_ref <chr>
# }