nhl

NHL statistical leaders

Goals, assists, points and shots are licensed all-situations box-score totals. xg is the compatibility view of our own all-situations shot model over licensed play-by-play, joined to those season totals to preserve the legacy min_games filter and response envelope. Only seasons present in that computed model are available for xg; an unsupported historical season returns 404 rather than falling back to source-restricted rows. The additional metrics are full-situation season totals and are included only where the box-score aggregate does not already hold the same field.

get/v1/nhl/leaders

Request

  • Base URL: https://api.bigballsdata.com
  • URL: https://api.bigballsdata.com/v1/nhl/leaders
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

stat'goals' | 'assists' | 'points' | 'shots' | 'xg' | 'even_strength_goals' | 'even_strength_points' | 'faceoff_win_pct' | 'game_winning_goals' | 'games_started' | 'losses' | 'ot_losses' | 'overtime_goals' | 'power_play_points' | 'short_handed_goals' | 'short_handed_points' | 'wins'
seasoninteger

Season LABEL, not a calendar year: the year a season STARTS in. 2025 means the 2025-26 campaign for leagues that cross the new year (EPL, NBA, NHL) and the 2025 season for those that do not (MLB, MLS, WNBA). Filtering resolves each league's own start month, so a season never spans two calendar years' worth of rows.

season_type'regular' | 'playoffs'
min_gamesinteger
limitinteger

Response

ok. { data, meta } with a route-local cache stamp.

dataobject required

Changes

No recorded changes to this operation across all 3 revisions of this API.