QMJHL — additional Python functions

Hand-written wrappers, loaders, and helpers in sportsdataverse.hockey.qmjhl that are not generated API-endpoint wrappers (those have their own reference pages).

HockeyTech / LeagueStat

qmjhl_game_corsi

qmjhl_game_corsi(game_id: 'int', return_as_pandas: 'bool' = False) -> 'Any'

Player-level on-ice Corsi and Fenwick for a single QMJHL game.

Parameters

Parameter	Type	Default	Description
game_id	int		The HockeyTech game id.
return_as_pandas	bool	False	Return a pandas DataFrame instead of polars.

Returns

One row per player on ice for a shot attempt: player_id (Int64), corsi_for / corsi_against / corsi_for_pct, fenwick_for / fenwick_against / fenwick_for_pct, corsi_includes_missed (Boolean), toi_seconds (Int64) and corsi_for_per60 (Float64, null without time on ice). A pandas DataFrame when return_as_pandas is True.

Raises

Exception	Description
NoDataError	The feed answered 404.
AssetFetchError	The fetch failed: a non-2xx status, an empty or unparseable body, or an Undefined Tab / InvalidView sentinel.

qmjhl_game_shifts

qmjhl_game_shifts(game_id: 'int', return_as_pandas: 'bool' = False) -> 'Any'

Parsed shift stints for a single QMJHL game.

Parameters

Parameter	Type	Default	Description
game_id	int		The HockeyTech game id.
return_as_pandas	bool	False	Return a pandas DataFrame instead of polars.

Returns

One row per shift: game_id and player_id (Int64), first_name, last_name, jersey_number, home (Int64, 1 = home), period, start_time / end_time / length (clock strings), start_s / end_s (Int64 seconds) and the goal_on_shift / penalty_on_shift flags. A pandas DataFrame when return_as_pandas is True.

Raises

Exception	Description
NoDataError	The feed answered 404.
AssetFetchError	The fetch failed: a non-2xx status, an empty or unparseable body, or an Undefined Tab / InvalidView sentinel.

qmjhl_game_summary

qmjhl_game_summary(game_id: 'int') -> 'dict'

QMJHL game summary — dict of frames (game/goals/penalties/shots_by_period/three_stars).

Parameters

Parameter	Type	Default	Description
game_id	int		The HockeyTech game id.

Returns

game (one row: game_id, date, status, venue, attendance, both teams and scores), goals (one row per goal with the scorer, both assists and the plus / minus skaters), penalties (one row per penalty), shots_by_period (side, period, shots) and three_stars. When the league denies the summary view, the event frames are empty and game is a game_id stub row.

Raises

Exception	Description
NoDataError	The feed answered 404.
AssetFetchError	The fetch failed: a non-2xx status, an empty or unparseable body, or an Undefined Tab / InvalidView sentinel.

qmjhl_leaders

qmjhl_leaders(season: 'Optional[int]' = None, season_id: 'Optional[int]' = None, return_as_pandas: 'bool' = False) -> 'Any'

QMJHL statistical leaders for a given season.

Parameters

Parameter	Type	Default	Description
season	Optional[int]	None	Season as an END year (2026 = the 2025-26 season). Defaults to the newest regular season when neither season nor season_id is given.
season_id	Optional[int]	None	The HockeyTech season id, when it is already known.
return_as_pandas	bool	False	Return a pandas DataFrame instead of polars.

Returns

One row per ranked skater (points and goals leaders): rank (Int64), player_id, name, jersey_number, position, team_id / team_name / team_code, stat_formatted and type_formatted (player_id / team_id Int64, the rest String), plus photo and logo URLs. A pandas DataFrame when return_as_pandas is True.

col_name	type	description
rank	Int64	Rank of the streak.
player_id	Int64	Unique player identifier.
jersey_number	String	Jersey number.
name	String	Team mascot name.
team_id	Int64	Unique team identifier.
team_name	String	Team name.
team_code	String	Team abbreviation.
team_logo	String	URL to the team logo image.
team_logo_small	String	URL of the small-format team logo image for the player's QMJHL club.
stat_formatted	String	The leader's value in the type_formatted category as a display string; for the Points and Goals leaderboards requested here it is a whole-number count (e.g. '29'), and '0' on every row when the season has no games yet.
type_formatted	String	Human-readable label describing the statistical category for which the player appears on the leaders list (e.g., 'Points', 'Goals', 'Save Percentage').
photo	String	URL to the player photo.
photo_small	String	URL of a small-format headshot image of the player from the QMJHL HockeyTech feed.
position	String	Player position.
division	String	Division identifier.

Raises

Exception	Description
NoDataError	The feed answered 404.
AssetFetchError	The fetch failed: a non-2xx status, an empty or unparseable body, or an Undefined Tab / InvalidView sentinel.

qmjhl_pbp

qmjhl_pbp(game_id: 'int', return_as_pandas: 'bool' = False) -> 'Any'

QMJHL play-by-play — one row per event, fully enriched.

Parameters

Parameter	Type	Default	Description
game_id	int		The HockeyTech game id.
return_as_pandas	bool	False	Return a pandas DataFrame instead of polars.

Returns

One row per event (shot, goal, penalty, faceoff, hit, goalie change ...): game_id, event, team_id, period_of_game, time_of_period, rink x_coord / y_coord (Float64, the raw 600×300 feed canvas, NOT feet), the feet frames x_coord_fixed / y_coord_fixed (home team shoots right) and x_coord_right / y_coord_right (every team shoots right), the primary / second / third player and goalie ids (Int64) and names, the plus / minus skaters on a goal, game metadata from the game summary, and derived shot_distance / shot_angle / scoring_chance and the on_ice_home / on_ice_away skaters from the shift feed. The release loader load_pwhl_pbp publishes x_coord in feet, so compare it with x_coord_fixed / x_coord_right here, never with this x_coord. Some leagues (USHL, MJHL) publish only goals, penalties and goalie changes, with no coordinates. A pandas DataFrame when return_as_pandas is True.

Raises

Exception	Description
NoDataError	The feed answered 404.
AssetFetchError	The fetch failed: a non-2xx status, an empty or unparseable body, or an Undefined Tab / InvalidView sentinel.

qmjhl_player_stats

qmjhl_player_stats(player_id: 'int', return_as_pandas: 'bool' = False) -> 'Any'

QMJHL player season stats across all seasons.

Parameters

Parameter	Type	Default	Description
player_id	int		The HockeyTech player id.
return_as_pandas	bool	False	Return a pandas DataFrame instead of polars.

Returns

One row per season (and team) the player played: season_id, season_name, playoff, team_id / team_name / team_code, games_played, goals, assists, points, plus_minus, penalty_minutes, power-play / short-handed / shootout splits, shots, faceoff_wins / faceoff_attempts, ice_time and stat_type. season_id and team_id are Int64; the rest are String, as the feed ships them. A pandas DataFrame when return_as_pandas is True.

col_name	type	description
season_id	Int64	Season identifier.
season_name	String	Full season name (e.g., "2024-25 Regular Season").
shortname	String	Player short name.
playoff	String	Whether the row is playoff statistics.
career	String	Whether this is a career-stats season.
sopt_track_faceoffs	String	Flag or value indicating whether faceoff tracking is enabled for this player's statistical record in the QMJHL HockeyTech system.
max_start_date	String	Latest game start date for the season.
veteran_status	String	Player veteran status.
veteran	String	Whether the player is a veteran.
jersey_number	String	Jersey number.
goals	String	Goals scored.
games_played	String	Games played.
assists	String	Assists.
points	String	Total points (goals + assists).
plus_minus	String	Plus/minus rating.
penalty_minutes	String	Penalty minutes.
power_play_goals	String	Power-play goals.
power_play_assists	String	Power-play assists.
shots	String	Shots on goal.
shootout_attempts	String	Shootout attempts.
shootout_goals	String	Shootout goals.
shootout_percentage	String	Shootout scoring percentage.
shooting_percentage	String	Shooting percentage.
shootout_winning_goals	String	Shootout game-winning goals.
points_per_game	String	Points per game.
short_handed_goals	String	Short-handed goals.
short_handed_assists	String	Short-handed assists.
game_winning_goals	String	Game-winning goals.
game_tieing_goals	String	Game-tying goals.
faceoff_wins	String	Faceoff wins.
faceoff_attempts	String	Faceoff attempts.
faceoff_pct	String	Faceoff win percentage.
hits	String	Hits.
shots_on	String	Shots on goal count.
shots_wide	String	Number of shots the player directed wide of the net during the season, as tracked in the QMJHL HockeyTech feed.
team_name	String	Team name.
team_code	String	Team abbreviation.
team_city	String	Team city.
team_nickname	String	Team nickname.
team_id	Int64	Unique team identifier.
active	String	Whether athlete is currently active.
first_goals	String	First goals of a game.
insurance_goals	String	Insurance goals.
overtime_goals	String	Overtime goals.
unassisted_goals	String	Unassisted goals.
empty_net_goals	String	Empty-net goals.
penalty_minutes_per_game	String	Penalty minutes per game.
division	String	Division identifier.
ice_time	String	Total ice time.
ice_time_minutes_seconds	String	Ice time in minutes and seconds.
shots_blocked_by_player	String	Shots blocked by the player.
stat_type	String	Statistic type ("regular"/"playoff").

Raises

Exception	Description
NoDataError	The feed answered 404.
AssetFetchError	The fetch failed: a non-2xx status, an empty or unparseable body, or an Undefined Tab / InvalidView sentinel.

qmjhl_player_toi

qmjhl_player_toi(game_id: 'int', return_as_pandas: 'bool' = False) -> 'Any'

Per-player time-on-ice totals for a single QMJHL game.

Parameters

Parameter	Type	Default	Description
game_id	int		The HockeyTech game id.
return_as_pandas	bool	False	Return a pandas DataFrame instead of polars.

Returns

One row per player: player_id (Int64), first_name, last_name, toi_seconds (Int64), num_shifts and avg_shift_s (Float64). A pandas DataFrame when return_as_pandas is True.

Raises

Exception	Description
NoDataError	The feed answered 404.
AssetFetchError	The fetch failed: a non-2xx status, an empty or unparseable body, or an Undefined Tab / InvalidView sentinel.

qmjhl_schedule

qmjhl_schedule(season: 'Optional[int]' = None, season_id: 'Optional[int]' = None, return_as_pandas: 'bool' = False) -> 'Any'

QMJHL schedule — one row per game of one season.

Parameters

Parameter	Type	Default	Description
season	Optional[int]	None	Season as an END year (2026 = the 2025-26 season). Defaults to the newest regular season when neither season nor season_id is given.
season_id	Optional[int]	None	The HockeyTech season id, when it is already known.
return_as_pandas	bool	False	Return a pandas DataFrame instead of polars.

Returns

One row per game: game_id, game_date, game_status, home_team / home_team_id / home_score, away_team / away_team_id / away_score, venue, season_id and game_type; the *_id columns are Int64, the rest String. Only the requested season's games: a regular season, its playoffs and its preseason are separate season ids, so pass season_id (from qmjhl_season_id()) for the playoffs. A pandas DataFrame when return_as_pandas is True.

col_name	type	description
game_id	Int64	Unique game identifier.
game_date	String	Game date.
game_status	String	Game status text.
home_team	String	Home team name.
home_team_id	Int64	Home team identifier.
home_score	String	Home team final score.
away_team	String	Away team name.
away_team_id	Int64	Away team identifier.
away_score	String	Away team final score.
venue	String	Venue where the game was played.
season_id	Int64	Season identifier.
game_type	String	Game type the row belongs to.

Raises

Exception	Description
NoDataError	The feed answered 404. With no season given, the seasons feed lists no regular season.
AssetFetchError	The fetch failed: a non-2xx status, an empty or unparseable body, or an Undefined Tab / InvalidView sentinel.
ValueError	No season matches season.

qmjhl_standings

qmjhl_standings(season: 'Optional[int]' = None, season_id: 'Optional[int]' = None, return_as_pandas: 'bool' = False) -> 'Any'

QMJHL standings — one row per team.

Parameters

Parameter	Type	Default	Description
season	Optional[int]	None	Season as an END year (2026 = the 2025-26 season). Defaults to the newest regular season when neither season nor season_id is given.
season_id	Optional[int]	None	The HockeyTech season id, when it is already known.
return_as_pandas	bool	False	Return a pandas DataFrame instead of polars.

Returns

One row per team: team, team_code, team_rank and wins (Int64), and games_played, losses, regulation_wins, non_reg_wins, non_reg_losses, points, goals_for, goals_against, games_remaining, percentage and overall_rank (String, as the feed ships them). A pandas DataFrame when return_as_pandas is True.

col_name	type	description
team_code	String	Team abbreviation.
wins	String	Wins.
losses	String	Losses.
ot_losses	String	Overtime losses.
ot_wins	String	Overtime wins.
shootout_wins	String	Shootout wins.
shootout_losses	String	Shootout losses.
row	String
points	Int64	Total points (goals + assists).
penalty_minutes	String	Penalty minutes.
streak	String	Current streak value.
goals_for	String	Goals for.
goals_against	String	Goals against.
goals_diff	String	Goals-for minus goals-against differential for the team through the current point in the QMJHL season.
percentage	String	Points percentage representing the fraction of available points earned by the team in the QMJHL standings.
overall_rank	String
games_played	String	Games played.
team_rank	Int64	Team rank in the standings.
past_10	String	Win-loss-overtime record string for the team over its most recent ten games (e.g., "7-2-1").
team	String	Team name.

Raises

Exception	Description
NoDataError	The feed answered 404.
AssetFetchError	The fetch failed: a non-2xx status, an empty or unparseable body, or an Undefined Tab / InvalidView sentinel.

qmjhl_team_roster

qmjhl_team_roster(team_id: 'int', season: 'Optional[int]' = None, season_id: 'Optional[int]' = None, return_as_pandas: 'bool' = False) -> 'Any'

QMJHL team roster for a given team + season.

Parameters

Parameter	Type	Default	Description
team_id	int		The HockeyTech team id.
season	Optional[int]	None	Season as an END year (2026 = the 2025-26 season). Defaults to the newest regular season when neither season nor season_id is given.
season_id	Optional[int]	None	The HockeyTech season id, when it is already known.
return_as_pandas	bool	False	Return a pandas DataFrame instead of polars.

Returns

One row per rostered player: player_id, person_id, names (first_name, last_name, display_name), position, tp_jersey_number, shoots / catches, height / weight, birthdate, home and birth places, rookie, veteran_status, draft_status and player_image. The id / *_id columns are Int64; the rest are String, as the feed ships them. A pandas DataFrame when return_as_pandas is True.

col_name	type	description
id	Int64	Unique player identifier.
person_id	Int64	Unique person identifier.
active	String	Whether athlete is currently active.
first_name	String	Player first name.
last_name	String	Player last name.
phonetic_name	String	Phonetic spelling of the player name.
display_name	String	Player display name.
shoots	String	Shooting hand.
hometown	String	Prospect hometown.
homeprov	String	Player home province/state.
homecntry	String	Player home country.
homeplace	String	Player home place description.
birthtown	String	Player birth town.
birthprov	String	Player birth province/state.
birthcntry	String	Player birth country.
birthplace	String	Combined birthplace string (typically city and country) for the player as stored in the HockeyTech roster feed.
height	String	Player height in inches.
weight	String	Player weight in pounds.
height_hyphenated	String	Player height formatted as a hyphenated feet-inches string (e.g., "6-1") as returned by the HockeyTech feed.
hidden	String	Flag indicating whether this roster entry is suppressed from public-facing displays in the HockeyTech system.
current_team	String	Name or identifier of the team to which the player is currently assigned within the HockeyTech system.
player_id	Int64	Unique player identifier.
status	String	Status string (e.g. captain markers).
birthdate	String	Date of birth.
birthdate_year	String	Player birth year.
rawbirthdate	String	Player's date of birth as a raw string in the format returned by the HockeyTech feed (e.g., "YYYY-MM-DD").
latest_team_id	Int64	Most recent team identifier.
veteran_status	String	Player veteran status.
veteran_description	String	Text label describing the player's veteran status or classification under QMJHL roster rules.
team_id	Int64	Unique team identifier.
team_name	String	Team name.
division	String	Division identifier.
tp_jersey_number	String	Jersey number assigned to the player on the QMJHL team's official roster (may differ from current game-night number).
rookie	String	Whether the player is a rookie.
position_id	Int64	Official position identifier.
position	String	Player position.
nhlteam	String	Name or abbreviation of the NHL team that holds the player's NHL rights, if applicable.
player_id_1	String	Primary alternate player identifier used by the HockeyTech system to cross-reference player records.
is_rookie	String	Whether the player is a rookie.
h	String
w	String
draft_status	String	Description of the player's NHL or league draft eligibility or draft history (e.g., "Drafted", "Eligible").
name	String	Team mascot name.
player_image	String	URL of the player's headshot or profile image as stored in the HockeyTech roster feed.
catches	String	Catching hand (goalies).

Raises

Exception	Description
NoDataError	The feed answered 404.
AssetFetchError	The fetch failed: a non-2xx status, an empty or unparseable body, or an Undefined Tab / InvalidView sentinel.

qmjhl_teams

qmjhl_teams(season: 'Optional[int]' = None, season_id: 'Optional[int]' = None, return_as_pandas: 'bool' = False) -> 'Any'

QMJHL teams for a given season.

Parameters

Parameter	Type	Default	Description
season	Optional[int]	None	Season as an END year (2026 = the 2025-26 season). Defaults to the newest regular season when neither season nor season_id is given.
season_id	Optional[int]	None	The HockeyTech season id, when it is already known.
return_as_pandas	bool	False	Return a pandas DataFrame instead of polars.

Returns

One row per team: team_id, team_name, team_code, team_nickname, team_label, division and team_logo; team_id is Int64, the rest String. A pandas DataFrame when return_as_pandas is True.

col_name	type	description
team_name	String	Team name.
team_id	Int64	Unique team identifier.
team_code	String	Team abbreviation.
team_nickname	String	Team nickname.
team_label	String	Short city label.
division	String	Division identifier.
team_logo	String	URL to the team logo image.

Raises

Exception	Description
NoDataError	The feed answered 404.
AssetFetchError	The fetch failed: a non-2xx status, an empty or unparseable body, or an Undefined Tab / InvalidView sentinel.

Dates and seasons

most_recent_qmjhl_season

most_recent_qmjhl_season() -> 'int'

Newest QMJHL regular season as an end-year integer: the highest season_yr of a regular season that is not a one-off event, so a preseason listed first is not a default.

Returns

The newest regular season's END year (2026 = the 2025-26 season).

Raises

Exception	Description
NoDataError	The seasons feed lists no regular season.
AssetFetchError	The seasons feed failed.

qmjhl_season_id

qmjhl_season_id(return_as_pandas: 'bool' = False) -> 'Any'

All QMJHL seasons with end-year + game-type labels.

Parameters

Parameter	Type	Default	Description
return_as_pandas	bool	False	Return a pandas DataFrame instead of polars.

Returns

One row per season: season_id (Int64), season_name, season_short, career, playoff, start_date, end_date, season_yr (Int64, the END year) and game_type_label. A pandas DataFrame when return_as_pandas is True.

col_name	type	description
season_id	Int64	Season identifier.
season_name	String	Full season name (e.g., "2024-25 Regular Season").
season_short	String	Short season name.
career	String	Whether this is a career-stats season.
playoff	String	Whether the row is playoff statistics.
start_date	String	Season start date.
end_date	String	Season end date.
season_yr	Int64	End year of the season the row belongs to, read from its name: "2025-26", "2025/26" and "2025-2026" are 2026, "26-27" is 2027, a compact "2425" is 2025. A preseason or exhibition named with the one year it starts in belongs to the next season ("2026 Pre-season" is 2027). Null when the name holds no year.
game_type_label	String	Game type read from the season name, first match wins: "preseason" (pre-season, preseason), "playoffs" (playoff, post), "exhibition", else "regular". One-off events such as all-star games are labelled "regular" too; season resolution skips them.

Raises

Exception	Description
NoDataError	The feed answered 404.
AssetFetchError	The fetch failed: a non-2xx status, an empty or unparseable body, or an Undefined Tab / InvalidView sentinel.