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_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_futures(), 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_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_team_odds_records(team_id = 1, season = 2026)
#> ── ESPN NBA Team Odds-Records ─────────────────────────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-05-19 01:34:15 UTC
#> # A tibble: 60 × 13
#>    league team_id season season_type category_type    category_abbrev
#>    <chr>  <chr>    <int>       <int> <chr>            <chr>          
#>  1 nba    1         2026           0 moneyLineOverall ML             
#>  2 nba    1         2026           0 moneyLineOverall ML             
#>  3 nba    1         2026           0 moneyLineOverall ML             
#>  4 nba    1         2026           0 moneyLineOverall ML             
#>  5 nba    1         2026           0 moneyLineOverall ML             
#>  6 nba    1         2026           0 moneyLineOverall ML             
#>  7 nba    1         2026           0 moneyLineHome    ML HOME        
#>  8 nba    1         2026           0 moneyLineHome    ML HOME        
#>  9 nba    1         2026           0 moneyLineHome    ML HOME        
#> 10 nba    1         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>
# }