Skip to main content
Version: 0.1.5

NHL — additional Python functions — NHL Records

nhl_records_coach_milestone_wins​

nhl_records_coach_milestone_wins(wins: 'int', playoffs: 'bool' = False, **filters) -> 'Dict'

Coaches who reached a wins milestone in fewest games.

Wraps one of the /coach-fewest-games-to-{N}-wins or /coach-fewest-games-to-{N}-playoff-wins paths.

Supported wins values: 50, 100, 150, 200, 300, 400, 500, 600, 700, 800, 900, 1000 (regular season); 50, 100, 150 (playoffs).

Parameters

ParameterTypeDefaultDescription
winsintMilestone win total (e.g. 100).
playoffsboolFalseIf True, use the playoff-wins path.

Returns

Coaches who hit the milestone, sorted by games needed.

nhl_records_comeback_wins​

nhl_records_comeback_wins(scope: 'str' = 'league', **filters) -> 'Dict'

Comeback wins from a multi-goal deficit.

Wraps:

  • GET /comeback-league-wins when scope is "league".
  • GET /comeback-franchise-wins when scope is "franchise".

Parameters

ParameterTypeDefaultDescription
scopestr'league'"league" (default) or "franchise".

Returns

Games where the team overcame a deficit to win.

nhl_records_consecutive_goal_seasons​

nhl_records_consecutive_goal_seasons(goals: 'int' = 50, **filters) -> 'Dict'

Skaters with the most consecutive N-goal seasons.

Wraps one of:

  • GET /consecutive-20-goal-seasons
  • GET /consecutive-30-goal-seasons
  • GET /consecutive-40-goal-seasons
  • GET /consecutive-50-goal-seasons
  • GET /consecutive-60-goal-seasons

Parameters

ParameterTypeDefaultDescription
goalsint50Goal threshold — one of 20, 30, 40, 50, 60.

Returns

Skaters sorted by consecutive-season streak.

nhl_records_fastest_goals​

nhl_records_fastest_goals(n_goals: 'int' = 2, **filters) -> 'Dict'

Fastest N goals by one team in a single game.

Wraps one of:

  • GET /fastest-2-goals-one-team
  • GET /fastest-3-goals-one-team
  • GET /fastest-4-goals-one-team
  • GET /fastest-5-goals-one-team

Parameters

ParameterTypeDefaultDescription
n_goalsint2Goal count — one of 2, 3, 4, 5.

Returns

Games where the milestone was set, sorted by elapsed time (fastest first).

nhl_records_fastest_goals_both_teams​

nhl_records_fastest_goals_both_teams(n_goals: 'int' = 2, **filters) -> 'Dict'

Fastest N goals combined (both teams) in a single game.

Wraps one of:

  • GET /fastest-2-goals-both-teams
  • GET /fastest-3-goals-both-teams
  • GET /fastest-4-goals-both-teams
  • GET /fastest-5-goals-both-teams
  • GET /fastest-6-goals-both-teams

Parameters

ParameterTypeDefaultDescription
n_goalsint2Combined goal count — one of 2, 3, 4, 5, 6.

Returns

Sorted by elapsed time (fastest first).

nhl_records_games_played_streak_skaters​

nhl_records_games_played_streak_skaters(active_only: 'bool' = False, **filters) -> 'Dict'

Consecutive games-played streaks for skaters.

Wraps GET /games-played-streak-skaters (career) or GET /games-played-active-streak-skaters (currently active streaks).

Parameters

ParameterTypeDefaultDescription
active_onlyboolFalseIf True, return only active streaks.

Returns

Skaters sorted by streak length.