Skip to main content
Version: 0.0.55

NHL — NHL EDGE API

sportsdataverse.nhl — 35 endpoints.

nhl_edge_skater_detail

Pull EDGE detail stats for a single skater.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/skater-detail/{player_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/skater-detail/8480801

API ParameterPythonPatternRequiredNullableDescription
player_idplayer_idYplayer_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

col_nametypedescription
seasons_with_edge_statscharacter
sog_summarycharacter
sog_detailscharacter
player_idintegerUnique player identifier.
player_first_name_defaultcharacter
player_last_name_defaultcharacter
player_birth_datecharacterParticipant birth date (YYYY-MM-DD).
player_shoots_catchescharacter
player_sweater_numberinteger
player_positioncharacter
player_slugcharacterURL-safe player identifier.
player_headshotcharacter
player_goalsinteger
player_assistsinteger
player_pointsintegerPlayer points.
player_games_playedinteger
player_team_common_name_defaultcharacter
player_team_place_name_with_preposition_defaultcharacter
player_team_place_name_with_preposition_frcharacter
player_team_abbrevcharacter
player_team_team_logo_lightcharacter
player_team_team_logo_darkcharacter
top_shot_speed_imperialdouble
top_shot_speed_metricdouble
top_shot_speed_percentiledouble
top_shot_speed_league_avg_imperialdouble
top_shot_speed_league_avg_metricdouble
top_shot_speed_overlay_player_first_name_defaultcharacter
top_shot_speed_overlay_player_last_name_defaultcharacter
top_shot_speed_overlay_game_datecharacter
top_shot_speed_overlay_away_team_abbrevcharacter
top_shot_speed_overlay_away_team_scoreinteger
top_shot_speed_overlay_home_team_abbrevcharacter
top_shot_speed_overlay_home_team_scoreinteger
top_shot_speed_overlay_game_outcome_last_period_typecharacter
top_shot_speed_overlay_period_descriptor_max_regulation_periodsinteger
top_shot_speed_overlay_period_descriptor_numberinteger
top_shot_speed_overlay_period_descriptor_period_typecharacter
top_shot_speed_overlay_time_in_periodcharacter
top_shot_speed_overlay_game_typeinteger
skating_speed_speed_max_imperialdouble
skating_speed_speed_max_metricdouble
skating_speed_speed_max_percentiledouble
skating_speed_speed_max_league_avg_imperialdouble
skating_speed_speed_max_league_avg_metricdouble
skating_speed_speed_max_overlay_player_first_name_defaultcharacter
skating_speed_speed_max_overlay_player_last_name_defaultcharacter
skating_speed_speed_max_overlay_game_datecharacter
skating_speed_speed_max_overlay_away_team_abbrevcharacter
skating_speed_speed_max_overlay_away_team_scoreinteger
skating_speed_speed_max_overlay_home_team_abbrevcharacter
skating_speed_speed_max_overlay_home_team_scoreinteger
skating_speed_speed_max_overlay_game_outcome_last_period_typecharacter
skating_speed_speed_max_overlay_period_descriptor_max_regulation_periodsinteger
skating_speed_speed_max_overlay_period_descriptor_numberinteger
skating_speed_speed_max_overlay_period_descriptor_period_typecharacter
skating_speed_speed_max_overlay_time_in_periodcharacter
skating_speed_speed_max_overlay_game_typeinteger
skating_speed_bursts_over20_valueinteger
skating_speed_bursts_over20_percentiledouble
skating_speed_bursts_over20_league_avg_valuedouble
total_distance_skated_imperialdouble
total_distance_skated_metricdouble
total_distance_skated_percentiledouble
total_distance_skated_league_avg_imperialdouble
total_distance_skated_league_avg_metricdouble
distance_max_game_imperialdouble
distance_max_game_metricdouble
distance_max_game_percentiledouble
distance_max_game_league_avg_imperialdouble
distance_max_game_league_avg_metricdouble
distance_max_game_overlay_player_first_name_defaultcharacter
distance_max_game_overlay_player_last_name_defaultcharacter
distance_max_game_overlay_game_datecharacter
distance_max_game_overlay_away_team_abbrevcharacter
distance_max_game_overlay_away_team_scoreinteger
distance_max_game_overlay_home_team_abbrevcharacter
distance_max_game_overlay_home_team_scoreinteger
distance_max_game_overlay_game_outcome_last_period_typecharacter
distance_max_game_overlay_game_outcome_ot_periodsinteger
distance_max_game_overlay_period_descriptor_max_regulation_periodsinteger
distance_max_game_overlay_period_descriptor_numberinteger
distance_max_game_overlay_period_descriptor_period_typecharacter
distance_max_game_overlay_game_typeinteger
zone_time_details_offensive_zone_pctgdouble
zone_time_details_offensive_zone_percentiledouble
zone_time_details_offensive_zone_league_avgdouble
zone_time_details_offensive_zone_ev_pctgdouble
zone_time_details_offensive_zone_ev_percentiledouble
zone_time_details_offensive_zone_ev_league_avgdouble
zone_time_details_neutral_zone_pctgdouble
zone_time_details_neutral_zone_percentiledouble
zone_time_details_neutral_zone_league_avgdouble
zone_time_details_defensive_zone_pctgdouble
zone_time_details_defensive_zone_percentiledouble
zone_time_details_defensive_zone_league_avgdouble

Example

nhl_edge_skater_detail(player_id=8480801)

Last validated n/a.

nhl_edge_skater_comparison

Pull EDGE comparison data for a single skater.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/skater-comparison/{player_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/skater-comparison/8480801

API ParameterPythonPatternRequiredNullableDescription
player_idplayer_idYplayer_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull EDGE comparison data for a single skater.

Example

nhl_edge_skater_comparison(player_id=8480801)

Last validated n/a.

nhl_edge_skater_shot_location_detail

Pull EDGE shot-location detail for a single skater.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/skater-shot-location-detail/{player_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/skater-shot-location-detail/8480801

API ParameterPythonPatternRequiredNullableDescription
player_idplayer_idYplayer_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull EDGE shot-location detail for a single skater.

Example

nhl_edge_skater_shot_location_detail(player_id=8480801)

Last validated n/a.

nhl_edge_skater_shot_location_top_10

Pull the EDGE top-10 skaters for a shot-location category.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/skater-shot-location-top-10/{position}/{category}/{sort_by}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/skater-shot-location-top-10/forwards/shots/points

API ParameterPythonPatternRequiredNullableDescription
positionpositionYposition path parameter.
categorycategoryYcategory path parameter.
sort_bysort_byYsort_by path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull the EDGE top-10 skaters for a shot-location category.

Example

nhl_edge_skater_shot_location_top_10(position='forwards', category='shots', sort_by='points')

Last validated n/a.

nhl_edge_skater_shot_speed_detail

Pull EDGE shot-speed detail for a single skater.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/skater-shot-speed-detail/{player_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/skater-shot-speed-detail/8480801

API ParameterPythonPatternRequiredNullableDescription
player_idplayer_idYplayer_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

col_nametypedescription
hardest_shotscharacter
shot_speed_details_top_shot_speed_imperialdouble
shot_speed_details_top_shot_speed_metricdouble
shot_speed_details_top_shot_speed_percentiledouble
shot_speed_details_top_shot_speed_league_avg_imperialdouble
shot_speed_details_top_shot_speed_league_avg_metricdouble
shot_speed_details_top_shot_speed_overlay_player_first_name_defaultcharacter
shot_speed_details_top_shot_speed_overlay_player_last_name_defaultcharacter
shot_speed_details_top_shot_speed_overlay_game_datecharacter
shot_speed_details_top_shot_speed_overlay_away_team_abbrevcharacter
shot_speed_details_top_shot_speed_overlay_away_team_scoreinteger
shot_speed_details_top_shot_speed_overlay_home_team_abbrevcharacter
shot_speed_details_top_shot_speed_overlay_home_team_scoreinteger
shot_speed_details_top_shot_speed_overlay_game_outcome_last_period_typecharacter
shot_speed_details_top_shot_speed_overlay_period_descriptor_max_regulation_periodsinteger
shot_speed_details_top_shot_speed_overlay_period_descriptor_numberinteger
shot_speed_details_top_shot_speed_overlay_period_descriptor_period_typecharacter
shot_speed_details_top_shot_speed_overlay_time_in_periodcharacter
shot_speed_details_top_shot_speed_overlay_game_typeinteger
shot_speed_details_avg_shot_speed_imperialdouble
shot_speed_details_avg_shot_speed_metricdouble
shot_speed_details_avg_shot_speed_percentiledouble
shot_speed_details_avg_shot_speed_league_avg_imperialdouble
shot_speed_details_avg_shot_speed_league_avg_metricdouble
shot_speed_details_shot_attempts_over100_valueinteger
shot_speed_details_shot_attempts_over100_percentiledouble
shot_speed_details_shot_attempts_over100_league_avgdouble
shot_speed_details_shot_attempts90_to100_valueinteger
shot_speed_details_shot_attempts90_to100_percentiledouble
shot_speed_details_shot_attempts90_to100_league_avgdouble
shot_speed_details_shot_attempts80_to90_valueinteger
shot_speed_details_shot_attempts80_to90_percentiledouble
shot_speed_details_shot_attempts80_to90_league_avgdouble
shot_speed_details_shot_attempts70_to80_valueinteger
shot_speed_details_shot_attempts70_to80_percentiledouble
shot_speed_details_shot_attempts70_to80_league_avgdouble

Example

nhl_edge_skater_shot_speed_detail(player_id=8480801)

Last validated n/a.

nhl_edge_skater_shot_speed_top_10

Pull the EDGE top-10 skaters by shot speed.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/skater-shot-speed-top-10/{positions}/{sort_by}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/skater-shot-speed-top-10/defense/points

API ParameterPythonPatternRequiredNullableDescription
positionspositionsYpositions path parameter.
sort_bysort_byYsort_by path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull the EDGE top-10 skaters by shot speed.

Example

nhl_edge_skater_shot_speed_top_10(positions='defense', sort_by='points')

Last validated n/a.

nhl_edge_skater_skating_distance_detail

Pull EDGE skating-distance detail for a single skater.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/skater-skating-distance-detail/{player_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/skater-skating-distance-detail/8480801

API ParameterPythonPatternRequiredNullableDescription
player_idplayer_idYplayer_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull EDGE skating-distance detail for a single skater.

Example

nhl_edge_skater_skating_distance_detail(player_id=8480801)

Last validated n/a.

nhl_edge_skater_skating_speed_detail

Pull EDGE skating-speed detail for a single skater.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/skater-skating-speed-detail/{player_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/skater-skating-speed-detail/8480801

API ParameterPythonPatternRequiredNullableDescription
player_idplayer_idYplayer_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull EDGE skating-speed detail for a single skater.

Example

nhl_edge_skater_skating_speed_detail(player_id=8480801)

Last validated n/a.

nhl_edge_skater_speed_top_10

Pull the EDGE top-10 skaters by skating speed.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/skater-speed-top-10/{positions}/{sort_by}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/skater-speed-top-10/defense/points

API ParameterPythonPatternRequiredNullableDescription
positionspositionsYpositions path parameter.
sort_bysort_byYsort_by path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull the EDGE top-10 skaters by skating speed.

Example

nhl_edge_skater_speed_top_10(positions='defense', sort_by='points')

Last validated n/a.

nhl_edge_skater_distance_top_10

Pull the EDGE top-10 skaters by skating distance.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/skater-distance-top-10/{positions}/{strength}/{sort_by}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/skater-distance-top-10/defense/ev/points

API ParameterPythonPatternRequiredNullableDescription
positionspositionsYpositions path parameter.
strengthstrengthYstrength path parameter.
sort_bysort_byYsort_by path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull the EDGE top-10 skaters by skating distance.

Example

nhl_edge_skater_distance_top_10(positions='defense', strength='ev', sort_by='points')

Last validated n/a.

nhl_edge_skater_zone_time

Pull EDGE zone-time detail for a single skater.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/skater-zone-time/{player_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/skater-zone-time/8480801

API ParameterPythonPatternRequiredNullableDescription
player_idplayer_idYplayer_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

col_nametypedescription
strength_codecharacter
offensive_zone_pctgdouble
offensive_zone_percentiledouble
offensive_zone_league_avgdouble
neutral_zone_pctgdouble
neutral_zone_percentiledouble
neutral_zone_league_avgdouble
defensive_zone_pctgdouble
defensive_zone_percentiledouble
defensive_zone_league_avgdouble

Example

nhl_edge_skater_zone_time(player_id=8480801)

Last validated n/a.

nhl_edge_skater_zone_time_top_10

Pull the EDGE top-10 skaters by zone time.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/skater-zone-time-top-10/{positions}/{strength}/{sort_by}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/skater-zone-time-top-10/defense/ev/points

API ParameterPythonPatternRequiredNullableDescription
positionspositionsYpositions path parameter.
strengthstrengthYstrength path parameter.
sort_bysort_byYsort_by path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull the EDGE top-10 skaters by zone time.

Example

nhl_edge_skater_zone_time_top_10(positions='defense', strength='ev', sort_by='points')

Last validated n/a.

nhl_edge_skater_landing

Pull the EDGE skater landing page (summary across all skaters).

Endpoint URL: GET https://api-web.nhle.com/v1/edge/skater-landing/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/skater-landing

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull the EDGE skater landing page (summary across all skaters).

Example

nhl_edge_skater_landing()

Last validated n/a.

nhl_edge_goalie_detail

Pull EDGE detail stats for a single goalie.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/goalie-detail/{player_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/goalie-detail/8480801

API ParameterPythonPatternRequiredNullableDescription
player_idplayer_idYplayer_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

col_nametypedescription
seasons_with_edge_statscharacter
shot_location_summarycharacter
shot_location_detailscharacter
player_idintegerUnique player identifier.
player_first_name_defaultcharacter
player_last_name_defaultcharacter
player_birth_datecharacterParticipant birth date (YYYY-MM-DD).
player_shoots_catchescharacter
player_sweater_numberinteger
player_slugcharacterURL-safe player identifier.
player_headshotcharacter
player_winsinteger
player_lossesinteger
player_overtime_lossesinteger
player_goals_against_avgdouble
player_save_pctgdouble
player_games_playedinteger
player_team_common_name_defaultcharacter
player_team_place_name_with_preposition_defaultcharacter
player_team_place_name_with_preposition_frcharacter
player_team_abbrevcharacter
player_team_team_logo_lightcharacter
player_team_team_logo_darkcharacter
stats_goals_against_avg_valuedouble
stats_goals_against_avg_percentiledouble
stats_goals_against_avg_league_avgdouble
stats_games_above900_valuedouble
stats_games_above900_percentiledouble
stats_games_above900_league_avgdouble
stats_goal_differential_per60_valuedouble
stats_goal_differential_per60_percentiledouble
stats_goal_differential_per60_league_avgdouble
stats_goal_support_avg_valuedouble
stats_goal_support_avg_percentiledouble
stats_goal_support_avg_league_avgdouble
stats_point_pctg_valuedouble
stats_point_pctg_percentiledouble
stats_point_pctg_league_avgdouble

Example

nhl_edge_goalie_detail(player_id=8480801)

Last validated n/a.

nhl_edge_goalie_5v5_detail

Pull EDGE 5-on-5 detail stats for a single goalie.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/goalie-5v5-detail/{player_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/goalie-5v5-detail/8480801

API ParameterPythonPatternRequiredNullableDescription
player_idplayer_idYplayer_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull EDGE 5-on-5 detail stats for a single goalie.

Example

nhl_edge_goalie_5v5_detail(player_id=8480801)

Last validated n/a.

nhl_edge_goalie_5v5_top_10

Pull the EDGE top-10 goalies by 5-on-5 metrics.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/goalie-5v5-top-10/{sort_by}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/goalie-5v5-top-10/points

API ParameterPythonPatternRequiredNullableDescription
sort_bysort_byYsort_by path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull the EDGE top-10 goalies by 5-on-5 metrics.

Example

nhl_edge_goalie_5v5_top_10(sort_by='points')

Last validated n/a.

nhl_edge_goalie_comparison

Pull EDGE comparison data for a single goalie.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/goalie-comparison/{player_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/goalie-comparison/8480801

API ParameterPythonPatternRequiredNullableDescription
player_idplayer_idYplayer_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull EDGE comparison data for a single goalie.

Example

nhl_edge_goalie_comparison(player_id=8480801)

Last validated n/a.

nhl_edge_goalie_save_percentage_detail

Pull EDGE save-percentage detail for a single goalie.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/goalie-save-percentage-detail/{player_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/goalie-save-percentage-detail/8480801

API ParameterPythonPatternRequiredNullableDescription
player_idplayer_idYplayer_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull EDGE save-percentage detail for a single goalie.

Example

nhl_edge_goalie_save_percentage_detail(player_id=8480801)

Last validated n/a.

nhl_edge_goalie_edge_save_pctg_top_10

Pull the EDGE top-10 goalies by save-percentage.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/goalie-edge-save-pctg-top-10/{sort_by}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/goalie-edge-save-pctg-top-10/points

API ParameterPythonPatternRequiredNullableDescription
sort_bysort_byYsort_by path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull the EDGE top-10 goalies by save-percentage.

Example

nhl_edge_goalie_edge_save_pctg_top_10(sort_by='points')

Last validated n/a.

nhl_edge_goalie_shot_location_detail

Pull EDGE shot-location detail for a single goalie.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/goalie-shot-location-detail/{player_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/goalie-shot-location-detail/8480801

API ParameterPythonPatternRequiredNullableDescription
player_idplayer_idYplayer_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

col_nametypedescription
areacharacterArea.
shots_againstinteger
savesintegerSaves.
goals_againstinteger
save_pctgdouble
shots_against_percentiledouble
saves_percentiledouble
goals_against_percentiledouble
save_pctg_percentiledouble

Example

nhl_edge_goalie_shot_location_detail(player_id=8480801)

Last validated n/a.

nhl_edge_goalie_shot_location_top_10

Pull the EDGE top-10 goalies for a shot-location category.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/goalie-shot-location-top-10/{category}/{sort_by}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/goalie-shot-location-top-10/shots/points

API ParameterPythonPatternRequiredNullableDescription
categorycategoryYcategory path parameter.
sort_bysort_byYsort_by path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull the EDGE top-10 goalies for a shot-location category.

Example

nhl_edge_goalie_shot_location_top_10(category='shots', sort_by='points')

Last validated n/a.

nhl_edge_goalie_landing

Pull the EDGE goalie landing page (summary across all goalies).

Endpoint URL: GET https://api-web.nhle.com/v1/edge/goalie-landing/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/goalie-landing

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull the EDGE goalie landing page (summary across all goalies).

Example

nhl_edge_goalie_landing()

Last validated n/a.

nhl_edge_team_detail

Pull EDGE detail stats for a single team.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/team-detail/{team_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/team-detail/10

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

col_nametypedescription
seasons_with_edge_statscharacter
sog_summarycharacter
sog_detailscharacter
team_idintegerUnique team identifier.
team_common_name_defaultcharacter
team_place_name_with_preposition_defaultcharacter
team_place_name_with_preposition_frcharacter
team_abbrevcharacterAbbreviation for team.
team_team_logo_lightcharacter
team_team_logo_darkcharacter
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_conferencecharacter
team_divisioncharacter
team_winsintegerTeam wins.
team_lossesintegerTeam losses.
team_ot_lossesinteger
team_games_playedinteger
team_pointsintegerTotal points scored by the player's team in this game.
shot_speed_shot_attempts_over90_valueinteger
shot_speed_shot_attempts_over90_rankinteger
shot_speed_top_shot_speed_imperialdouble
shot_speed_top_shot_speed_metricdouble
shot_speed_top_shot_speed_rankinteger
shot_speed_top_shot_speed_league_avg_imperialdouble
shot_speed_top_shot_speed_league_avg_metricdouble
shot_speed_top_shot_speed_overlay_player_first_name_defaultcharacter
shot_speed_top_shot_speed_overlay_player_last_name_defaultcharacter
shot_speed_top_shot_speed_overlay_game_datecharacter
shot_speed_top_shot_speed_overlay_away_team_abbrevcharacter
shot_speed_top_shot_speed_overlay_away_team_scoreinteger
shot_speed_top_shot_speed_overlay_home_team_abbrevcharacter
shot_speed_top_shot_speed_overlay_home_team_scoreinteger
shot_speed_top_shot_speed_overlay_game_outcome_last_period_typecharacter
shot_speed_top_shot_speed_overlay_game_outcome_ot_periodsinteger
shot_speed_top_shot_speed_overlay_period_descriptor_max_regulation_periodsinteger
shot_speed_top_shot_speed_overlay_period_descriptor_numberinteger
shot_speed_top_shot_speed_overlay_period_descriptor_period_typecharacter
shot_speed_top_shot_speed_overlay_time_in_periodcharacter
shot_speed_top_shot_speed_overlay_game_typeinteger
skating_speed_bursts_over22_valueinteger
skating_speed_bursts_over22_rankinteger
skating_speed_bursts_over20_valueinteger
skating_speed_bursts_over20_rankinteger
skating_speed_bursts_over20_league_avg_valueinteger
skating_speed_speed_max_imperialdouble
skating_speed_speed_max_metricdouble
skating_speed_speed_max_rankinteger
skating_speed_speed_max_league_avg_imperialdouble
skating_speed_speed_max_league_avg_metricdouble
skating_speed_speed_max_overlay_player_first_name_defaultcharacter
skating_speed_speed_max_overlay_player_last_name_defaultcharacter
skating_speed_speed_max_overlay_game_datecharacter
skating_speed_speed_max_overlay_away_team_abbrevcharacter
skating_speed_speed_max_overlay_away_team_scoreinteger
skating_speed_speed_max_overlay_home_team_abbrevcharacter
skating_speed_speed_max_overlay_home_team_scoreinteger
skating_speed_speed_max_overlay_game_outcome_last_period_typecharacter
skating_speed_speed_max_overlay_period_descriptor_max_regulation_periodsinteger
skating_speed_speed_max_overlay_period_descriptor_numberinteger
skating_speed_speed_max_overlay_period_descriptor_period_typecharacter
skating_speed_speed_max_overlay_time_in_periodcharacter
skating_speed_speed_max_overlay_game_typeinteger
distance_skated_total_imperialdouble
distance_skated_total_metricdouble
distance_skated_total_rankinteger
distance_skated_total_league_avg_imperialdouble
distance_skated_total_league_avg_metricdouble
zone_time_details_offensive_zone_pctgdouble
zone_time_details_offensive_zone_rankinteger
zone_time_details_offensive_zone_league_avgdouble
zone_time_details_offensive_zone_ev_pctgdouble
zone_time_details_offensive_zone_ev_rankinteger
zone_time_details_offensive_zone_ev_league_avgdouble
zone_time_details_neutral_zone_pctgdouble
zone_time_details_neutral_zone_rankinteger
zone_time_details_neutral_zone_league_avgdouble
zone_time_details_defensive_zone_pctgdouble
zone_time_details_defensive_zone_rankinteger
zone_time_details_defensive_zone_league_avgdouble

Example

nhl_edge_team_detail(team_id=10)

Last validated n/a.

nhl_edge_team_landing

Pull the EDGE team landing page (summary across all teams).

Endpoint URL: GET https://api-web.nhle.com/v1/edge/team-landing/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/team-landing

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull the EDGE team landing page (summary across all teams).

Example

nhl_edge_team_landing()

Last validated n/a.

nhl_edge_team_shot_location_detail

Pull EDGE shot-location detail for a single team.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/team-shot-location-detail/{team_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/team-shot-location-detail/10

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

col_nametypedescription
areacharacterArea.
soginteger
sog_rankinteger
goalsinteger
goals_rankinteger
shooting_pctgdouble
shooting_pctg_rankinteger

Example

nhl_edge_team_shot_location_detail(team_id=10)

Last validated n/a.

nhl_edge_team_shot_location_top_10

Pull the EDGE top-10 teams for a shot-location category.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/team-shot-location-top-10/{position}/{category}/{sort_by}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/team-shot-location-top-10/forwards/shots/points

API ParameterPythonPatternRequiredNullableDescription
positionpositionYposition path parameter.
categorycategoryYcategory path parameter.
sort_bysort_byYsort_by path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull the EDGE top-10 teams for a shot-location category.

Example

nhl_edge_team_shot_location_top_10(position='forwards', category='shots', sort_by='points')

Last validated n/a.

nhl_edge_team_shot_speed_detail

Pull EDGE shot-speed detail for a single team.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/team-shot-speed-detail/{team_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/team-shot-speed-detail/10

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull EDGE shot-speed detail for a single team.

Example

nhl_edge_team_shot_speed_detail(team_id=10)

Last validated n/a.

nhl_edge_team_skating_distance_detail

Pull EDGE skating-distance detail for a single team.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/team-skating-distance-detail/{team_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/team-skating-distance-detail/10

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull EDGE skating-distance detail for a single team.

Example

nhl_edge_team_skating_distance_detail(team_id=10)

Last validated n/a.

nhl_edge_team_skating_distance_top_10

Pull the EDGE top-10 teams by skating distance.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/team-skating-distance-top-10/{positions}/{strength}/{sort_by}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/team-skating-distance-top-10/defense/ev/points

API ParameterPythonPatternRequiredNullableDescription
positionspositionsYpositions path parameter.
strengthstrengthYstrength path parameter.
sort_bysort_byYsort_by path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull the EDGE top-10 teams by skating distance.

Example

nhl_edge_team_skating_distance_top_10(positions='defense', strength='ev', sort_by='points')

Last validated n/a.

nhl_edge_team_skating_speed_detail

Pull EDGE skating-speed detail for a single team.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/team-skating-speed-detail/{team_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/team-skating-speed-detail/10

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull EDGE skating-speed detail for a single team.

Example

nhl_edge_team_skating_speed_detail(team_id=10)

Last validated n/a.

nhl_edge_team_skating_speed_top_10

Pull the EDGE top-10 teams by skating speed.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/team-skating-speed-top-10/{positions}/{sort_by}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/team-skating-speed-top-10/defense/points

API ParameterPythonPatternRequiredNullableDescription
positionspositionsYpositions path parameter.
sort_bysort_byYsort_by path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull the EDGE top-10 teams by skating speed.

Example

nhl_edge_team_skating_speed_top_10(positions='defense', sort_by='points')

Last validated n/a.

nhl_edge_team_zone_time_details

Pull EDGE zone-time details for a single team.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/team-zone-time-details/{team_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/team-zone-time-details/10

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull EDGE zone-time details for a single team.

Example

nhl_edge_team_zone_time_details(team_id=10)

Last validated n/a.

nhl_edge_team_zone_time_top_10

Pull the EDGE top-10 teams by zone time.

Endpoint URL: GET https://api-web.nhle.com/v1/edge/team-zone-time-top-10/{strength}/{sort_by}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/edge/team-zone-time-top-10/ev/points

API ParameterPythonPatternRequiredNullableDescription
strengthstrengthYstrength path parameter.
sort_bysort_byYsort_by path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull the EDGE top-10 teams by zone time.

Example

nhl_edge_team_zone_time_top_10(strength='ev', sort_by='points')

Last validated n/a.

nhl_edge_cat_skater_detail

Pull categorized (cat) EDGE detail stats for a single skater.

Endpoint URL: GET https://api-web.nhle.com/v1/cat/edge/skater-detail/{player_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/cat/edge/skater-detail/8480801

API ParameterPythonPatternRequiredNullableDescription
player_idplayer_idYplayer_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull categorized (cat) EDGE detail stats for a single skater.

Example

nhl_edge_cat_skater_detail(player_id=8480801)

Last validated n/a.

nhl_edge_cat_goalie_detail

Pull categorized (cat) EDGE detail stats for a single goalie.

Endpoint URL: GET https://api-web.nhle.com/v1/cat/edge/goalie-detail/{player_id}/{season}/{game_type}

Valid URL: https://api-web.nhle.com/v1/cat/edge/goalie-detail/8480801

API ParameterPythonPatternRequiredNullableDescription
player_idplayer_idYplayer_id path parameter.
seasonseasonYseason path parameter.
game_typegame_typeYgame_type path parameter.

Returns

Pull categorized (cat) EDGE detail stats for a single goalie.

Example

nhl_edge_cat_goalie_detail(player_id=8480801)

Last validated n/a.