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: goals, shots, misses, blocks, faceoffs, hits, giveaways, takeaways, penalties. 21,980 of 22,067 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,800,000+ events |
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,800+ |
Goalies Goalie stat lookup including save percentage, GAA, wins, shutouts, and time on ice. Shot-quality metrics (GSAX, high-danger save%) are not yet computed. | 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, rankings, and supported advanced team metrics. Do not treat standings as real-time unless freshness is shown separately. | Available | Supported seasons and current-season snapshots | 494 |
Odds Odds for supported games, books, and markets where available. Coverage varies by sportsbook, game, market, and source availability. | Partial | 2019-20 through current | 107,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: goals, shots, misses, blocks, faceoffs, hits, giveaways, takeaways, penalties.
Games
availableGame records and detail for supported regular season, playoff, and preseason matchups.
Players
availablePlayer search and player stat lookup across supported datasets.
Goalies
availableGoalie stat lookup including save percentage, GAA, wins, shutouts, and time on ice. Shot-quality metrics (GSAX, high-danger save%) are not yet computed.
Teams
availableTeam metadata, abbreviations, divisions, conferences, and arenas.
Standings + rankings
availableStandings, rankings, and supported advanced team metrics.
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 DraftKings, FanDuel, BetMGM, and ESPN BET. 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.