Skip to contents

Get ESPN MCH / WCH Player Stats (web-v3)

Usage

espn_mch_player_stats(athlete_id, season = most_recent_nhl_season(), ...)

espn_wch_player_stats(athlete_id, season = most_recent_nhl_season(), ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric, e.g. "5136656"). Obtain via espn_mch_team_roster().

season

Season end-year (e.g. 2025). Defaults to most_recent_nhl_season(). When NULL the current season is used.

...

Reserved for forward compatibility.

Value

A fastRhockey_data tibble with one row per season entry plus a career-total row per stat category:

col_nametypesdescription
athlete_idcharacterESPN athlete identifier (echoed from arg).
seasonintegerRequested season year (echoed from arg).
season_yearintegerSeason end-year for this row.
categorycharacterStat category name (e.g. center).
category_displaycharacterStat category display name.
positioncharacterPosition for this season row.
team_idcharacterESPN team identifier.
team_slugcharacterTeam slug.
team_display_namecharacterTeam display name.
team_abbreviationcharacterTeam abbreviation.
gamescharacterGames played.
goalscharacterGoals.
assistscharacterAssists.
pointscharacterPoints.
plus_minuscharacterPlus/minus.
penalty_minutescharacterPenalty minutes.
shootout_goalscharacterShootout goals.
shooting_pctcharacterShooting percentage.
power_play_goalscharacterPower-play goals.
power_play_assistscharacterPower-play assists.
short_handed_goalscharacterShort-handed goals.
short_handed_assistscharacterShort-handed assists.
game_winning_goalscharacterGame-winning goals.
time_on_ice_per_gamecharacterAverage time on ice per game.
productioncharacterProduction metric.

Details

League slug mens-college-hockey; season is the END year (2026 = 2025-26). Same ESPN helper as espn_nhl_player_stats_v3() (columns inherited); a collection may be empty.

espn_wch_player_stats() is the same wrapper for women's college hockey (league slug womens-college-hockey): same arguments, same columns.

See also

family_espn_mch lists every function in this family.

Author

Saiem Gilani

Examples

# \donttest{
  try(espn_mch_player_stats(athlete_id = "5136656", season = 2025))
#> ✖ 2026-11-13 21:26:26.604381: Invalid arguments or no ESPN mens-college-hockey player stats data available!
#> ✖ Args: league = "mens-college-hockey", athlete_id = "5136656", season = 2025
#> ✖ Error: The API returned an error
#> data frame with 0 columns and 0 rows
# }
# \donttest{
  try(espn_wch_player_stats(athlete_id = "5263060", season = 2025))
#> ✖ 2026-11-13 21:26:26.641758: Invalid arguments or no ESPN womens-college-hockey player stats data available!
#> ✖ Args: league = "womens-college-hockey", athlete_id = "5263060", season = 2025
#> ✖ Error: The API returned an error
#> data frame with 0 columns and 0 rows
# }