Skip to contents

Returns current or historical NHL standings. Uses the new NHL API (api-web.nhle.com).

Usage

nhl_standings(date = NULL)

Arguments

date

Character date in "YYYY-MM-DD" format. If NULL, returns current standings.

Value

A data frame (fastRhockey_data) with the following columns:

col_nametypesdescription
team_abbrcharacterTeam abbreviation.
team_namecharacterTeam name.
team_common_namecharacterTeam common name.
team_logocharacterURL to the team logo image.
conference_namecharacterConference name.
division_abbrevcharacterDivision abbreviation.
division_namecharacterDivision name.
place_namecharacterPlace (city) name.
conference_sequenceintegerRank within the conference.
division_sequenceintegerRank within the division.
league_sequenceintegerRank within the league.
wildcard_sequenceintegerWildcard standing rank.
games_playedintegerGames played.
winsintegerWins.
lossesintegerLosses.
ot_lossesintegerOvertime losses.
pointsintegerStandings points.
point_pctgnumericPoints percentage.
regulation_winsintegerRegulation wins.
regulation_plus_ot_winsintegerRegulation plus overtime wins.
goals_forintegerGoals scored for.
goals_againstintegerGoals allowed against.
goal_differentialintegerGoal differential.
home_winsintegerHome wins.
home_lossesintegerHome losses.
home_ot_lossesintegerHome overtime losses.
road_winsintegerRoad wins.
road_lossesintegerRoad losses.
road_ot_lossesintegerRoad overtime losses.
l10_winsintegerWins in last 10 games.
l10_lossesintegerLosses in last 10 games.
l10_ot_lossesintegerOvertime losses in last 10 games.
streak_codecharacterCurrent streak code (W/L/OT).
streak_countintegerLength of current streak.
shootout_winsintegerShootout wins.
shootout_lossesintegerShootout losses.

Examples

# \donttest{
  try(nhl_standings())
#> ── NHL Standings ────────────────────────────────────────── fastRhockey 1.0.0 ──
#>  Data updated: 2026-06-09 20:29:37 UTC
#> # A tibble: 32 × 36
#>    team_abbr team_name           team_common_name team_logo      conference_name
#>    <chr>     <chr>               <chr>            <chr>          <chr>          
#>  1 COL       Colorado Avalanche  Avalanche        https://asset… Western        
#>  2 CAR       Carolina Hurricanes Hurricanes       https://asset… Eastern        
#>  3 DAL       Dallas Stars        Stars            https://asset… Western        
#>  4 BUF       Buffalo Sabres      Sabres           https://asset… Eastern        
#>  5 TBL       Tampa Bay Lightning Lightning        https://asset… Eastern        
#>  6 MTL       Montréal Canadiens  Canadiens        https://asset… Eastern        
#>  7 MIN       Minnesota Wild      Wild             https://asset… Western        
#>  8 BOS       Boston Bruins       Bruins           https://asset… Eastern        
#>  9 OTT       Ottawa Senators     Senators         https://asset… Eastern        
#> 10 PIT       Pittsburgh Penguins Penguins         https://asset… Eastern        
#> # ℹ 22 more rows
#> # ℹ 31 more variables: division_abbrev <chr>, division_name <chr>,
#> #   place_name <chr>, conference_sequence <int>, division_sequence <int>,
#> #   league_sequence <int>, wildcard_sequence <int>, games_played <int>,
#> #   wins <int>, losses <int>, ot_losses <int>, points <int>, point_pctg <dbl>,
#> #   regulation_wins <int>, regulation_plus_ot_wins <int>, goals_for <int>,
#> #   goals_against <int>, goal_differential <int>, home_wins <int>, …
  try(nhl_standings(date = "2024-03-01"))
#> ── NHL Standings ────────────────────────────────────────── fastRhockey 1.0.0 ──
#>  Data updated: 2026-06-09 20:29:37 UTC
#> # A tibble: 32 × 36
#>    team_abbr team_name            team_common_name team_logo     conference_name
#>    <chr>     <chr>                <chr>            <chr>         <chr>          
#>  1 FLA       Florida Panthers     Panthers         https://asse… Eastern        
#>  2 BOS       Boston Bruins        Bruins           https://asse… Eastern        
#>  3 NYR       New York Rangers     Rangers          https://asse… Eastern        
#>  4 VAN       Vancouver Canucks    Canucks          https://asse… Western        
#>  5 DAL       Dallas Stars         Stars            https://asse… Western        
#>  6 WPG       Winnipeg Jets        Jets             https://asse… Western        
#>  7 COL       Colorado Avalanche   Avalanche        https://asse… Western        
#>  8 CAR       Carolina Hurricanes  Hurricanes       https://asse… Eastern        
#>  9 TOR       Toronto Maple Leafs  Maple Leafs      https://asse… Eastern        
#> 10 VGK       Vegas Golden Knights Golden Knights   https://asse… Western        
#> # ℹ 22 more rows
#> # ℹ 31 more variables: division_abbrev <chr>, division_name <chr>,
#> #   place_name <chr>, conference_sequence <int>, division_sequence <int>,
#> #   league_sequence <int>, wildcard_sequence <int>, games_played <int>,
#> #   wins <int>, losses <int>, ot_losses <int>, points <int>, point_pctg <dbl>,
#> #   regulation_wins <int>, regulation_plus_ot_wins <int>, goals_for <int>,
#> #   goals_against <int>, goal_differential <int>, home_wins <int>, …
# }