Skip to contents

Returns the long-format odds-records breakdown for a team in one season. Each row is one (category × stat) — typical categories include Money Line Overall, Money Line Home, Money Line Road, Against The Spread Overall, Over/Under, etc. ESPN's coverage of this endpoint is sparse; many (team × season-type) combinations return 404, in which case the wrapper returns an empty tibble.

Usage

espn_nba_team_odds_records(
  team_id,
  season = most_recent_nba_season(),
  season_type = 0L,
  ...
)

Arguments

team_id

ESPN team identifier.

season

Season year. Defaults to most recent NBA season.

season_type

Season-type id. ESPN populates odds-records mostly under season_type = 0 (all-types aggregate), so that is the default.

...

Additional arguments; currently unused.

Value

A long tibble with one row per (category × stat).

col_nametypesdescription
leaguecharacterLeague slug.
team_idcharacterESPN team identifier.
seasonintegerSeason year.
season_typeintegerSeason-type id.
category_typecharacterCategory type code (e.g. "moneyLineOverall").
category_abbrevcharacterCategory abbreviation (e.g. "ML").
category_shortcharacterShort display.
category_displaycharacterFull category name.
stat_typecharacterStat type code (e.g. "win", "loss").
stat_abbrevcharacterStat abbreviation (e.g. "W", "L").
stat_displaycharacterStat display name.
valuenumericNumeric stat value.
display_valuecharacterDisplay-formatted value.

See also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), 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_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), 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_team_odds_records(team_id = 13, season = 2026)
#> ── ESPN NBA Team Odds-Records ─────────────────────────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-06-04 12:21:11 UTC
#> # A tibble: 60 × 13
#>    league team_id season season_type category_type    category_abbrev
#>    <chr>  <chr>    <int>       <int> <chr>            <chr>          
#>  1 nba    13        2026           0 moneyLineOverall ML             
#>  2 nba    13        2026           0 moneyLineOverall ML             
#>  3 nba    13        2026           0 moneyLineOverall ML             
#>  4 nba    13        2026           0 moneyLineOverall ML             
#>  5 nba    13        2026           0 moneyLineOverall ML             
#>  6 nba    13        2026           0 moneyLineOverall ML             
#>  7 nba    13        2026           0 moneyLineHome    ML HOME        
#>  8 nba    13        2026           0 moneyLineHome    ML HOME        
#>  9 nba    13        2026           0 moneyLineHome    ML HOME        
#> 10 nba    13        2026           0 moneyLineHome    ML HOME        
#> # ℹ 50 more rows
#> # ℹ 7 more variables: category_short <chr>, category_display <chr>,
#> #   stat_type <chr>, stat_abbrev <chr>, stat_display <chr>, value <dbl>,
#> #   display_value <chr>
# }