Data atlas
Inspect the hockey data layer before you build on it.
PuckAPI exposes hockey datasets through REST and MCP. This atlas keeps coverage claims explicit: what exists, which endpoints expose it, and where availability is partial.
Coverage ledger
Coverage is a product claim, not a freshness signal. Operational freshness is tracked separately.
| Data | Status | Coverage | Volume |
|---|---|---|---|
Play-by-play Every event, with rink coordinates, strength state, zone, shot type and the players involved where the event has them: goals, shots, misses, blocks, faceoffs, hits, giveaways, takeaways, penalties. 22,097 of 22,184 completed games. The 87 gaps are preseason games before 2018, for which the source publishes no play data. Coordinates are present on locatable events; stoppages and period markers carry none. | Available | 2010-11 through current | 6,900,000+ events |
Shift charts and situation time Every player's shifts in every game, and from them the exact seconds each team spent at 5v5, on the power play, shorthanded or with the goalie pulled, plus each skater's time by strength. Game logs carry official time on ice and plus/minus. 22,009 of 22,237 completed games. The 228 gaps are preseason games for which the NHL publishes no shift chart or time-on-ice report. For 1,268 games the NHL's shift API has no chart, and the shifts come from its official HTML time-on-ice reports instead. | Available | 2010-11 through current | 16,000,000+ shifts |
Games Game records and detail for supported regular season, playoff, and preseason matchups. Historical coverage depends on supported seasons and source availability. | Available | 2010-11 through current | 23,000+ |
Players Player search and player stat lookup across supported datasets. | Available | Bio, roster, position, supported stats | 4,900+ |
Skaters Skater season totals: goals, assists, points, plus/minus, power play and shorthanded production, shooting%, faceoff% and time on ice. One line per player per regular season. A player traded mid-season is combined into one line; his faceoff% and time on ice are weighted by games played. | Available | 2010-11 to current | 14,000+ |
Goalies Goalie stat lookup including save percentage, GAA, goals saved above expected, high-danger save%, rolling form and rest days. | Available | Supported goalie stat seasons | 1,509 |
Teams Team metadata, abbreviations, divisions, conferences, and arenas. | Available | Active and historical franchises represented in PuckAPI | 34 |
Standings + rankings Standings and rankings with 5v5 possession: Corsi%, Fenwick% and expected goals for and against. Do not treat standings as real-time unless freshness is shown separately. | Available | Supported seasons and current-season snapshots | 526 |
Odds Odds for supported games, books, and markets where available. Coverage varies by sportsbook, game, market, and source availability. | Partial | 2019 playoffs, then every game from 2019-20 through current | 191,000+ |
Line movement Line movement data where multiple odds snapshots exist for a supported game and market. Not every game, book, or market has line movement history. | Partial | Historical odds snapshots where available | Opening/current/closing snapshots |
Head-to-head Historical matchup context for supported teams and games. | Available | Supported teams and games | Matchup history |
Endpoint map
Start with the dataset, then jump to the exact tool reference or a runnable surface.
Play-by-play
availableEvery event, with rink coordinates, strength state, zone, shot type and the players involved where the event has them: goals, shots, misses, blocks, faceoffs, hits, giveaways, takeaways, penalties.
Shift charts and situation time
availableEvery player's shifts in every game, and from them the exact seconds each team spent at 5v5, on the power play, shorthanded or with the goalie pulled, plus each skater's time by strength. Game logs carry official time on ice and plus/minus.
Games
availableGame records and detail for supported regular season, playoff, and preseason matchups.
Players
availablePlayer search and player stat lookup across supported datasets.
Skaters
availableSkater season totals: goals, assists, points, plus/minus, power play and shorthanded production, shooting%, faceoff% and time on ice.
Goalies
availableGoalie stat lookup including save percentage, GAA, goals saved above expected, high-danger save%, rolling form and rest days.
Teams
availableTeam metadata, abbreviations, divisions, conferences, and arenas.
Standings + rankings
availableStandings and rankings with 5v5 possession: Corsi%, Fenwick% and expected goals for and against.
Line movement
partialLine movement data where multiple odds snapshots exist for a supported game and market.
Head-to-head
availableHistorical matchup context for supported teams and games.
Sportsbook coverage
Odds coverage currently documents All eight books (including DraftKings, FanDuel, BetMGM, ESPN BET and Pinnacle) fetched every hour from October 7 2026 for games in the next 7 days, with five labelled snapshots a day kept (latenight, earlyam, midday, afternoon, night) plus opening and closing; opening and closing history from the sportsbook odds archive covers seven books, among them DraftKings, FanDuel, BetMGM and Pinnacle, from 2020-21 and ESPN BET from 2023-24; 2019-20 to 2023-24 also carries Bet365, Caesars, Betfair, Unibet, PointsBet and others (closing lines). Sportsbook availability varies by game, market, and source. Do not assume every book is available for every game. Pass one of these keys as the bookmaker filter.