PuckAPI is an MCP server published by io.github.noahowsh, hosted at mcp.puckapi.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 28 tools, including get_standings, get_team_stats, list_teams, get_games, get_schedule.
NHL and PWHL stats, play-by-play, expected goals and odds. REST API and MCP server. Free to start.
16 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Use when checking where teams rank in their division or conference. Returns points, wins, losses, OT losses, point%, goal differential, goals for/against per game, and 5v5 possession: Corsi%, Fenwick% and expected goals for and against. The possession columns are 5v5 only, so they will not match a goalie's expected goals against, which covers every strength. Defaults to the most recent season with standings. Costs 2 credits.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl. |
| season | string | Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. Defaults to current season. |
| division | string | Filter by division (e.g. Atlantic, Metropolitan, Central, Pacific) |
| conference | string | Filter by conference |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
{
"name": "get_standings",
"title": "Standings",
"description": "Use when checking where teams rank in their division or conference. Returns points, wins, losses, OT losses, point%, goal differential, goals for/against per game, and 5v5 possession: Corsi%, Fenwick% and expected goals for and against. The possession columns are 5v5 only, so they will not match a goalie's expected goals against, which covers every strength. Defaults to the most recent season with standings. Costs 2 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"league": {
"enum": [
"nhl",
"pwhl",
"ohl",
"whl",
"qmjhl",
"echl",
"ahl",
"ushl"
],
"type": "string",
"description": "League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl."
},
"season": {
"type": "string",
"description": "Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. Defaults to current season."
},
"division": {
"type": "string",
"description": "Filter by division (e.g. Atlantic, Metropolitan, Central, Pacific)"
},
"conference": {
"enum": [
"Eastern",
"Western"
],
"type": "string",
"description": "Filter by conference"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"standings",
"snapshot_date",
"count"
],
"properties": {
"count": {
"type": "number"
},
"standings": {
"type": "array",
"items": {
"type": "object",
"required": [
"teamAbbrev",
"teamName",
"conference",
"division",
"rank",
"points",
"gamesPlayed",
"wins",
"losses",
"otLosses",
"pointPct",
"goalDiff",
"goalsForPerGame",
"goalsAgainstPerGame",
"corsiPct",
"fenwickPct",
"expectedGoalsFor",
"expectedGoalsAgainst",
"snapshotDate"
],
"properties": {
"rank": {
"type": [
"number",
"null"
]
},
"wins": {
"type": [
"number",
"null"
]
},
"losses": {
"type": [
"number",
"null"
]
},
"points": {
"type": [
"number",
"null"
]
},
"corsiPct": {
"type": [
"number",
"null"
]
},
"division": {
"type": "string"
},
"goalDiff": {
"type": [
"number",
"null"
]
},
"otLosses": {
"type": [
"number",
"null"
]
},
"pointPct": {
"type": [
"number",
"null"
]
},
"teamName": {
"type": "string"
},
"conference": {
"type": "string"
},
"fenwickPct": {
"type": [
"number",
"null"
]
},
"teamAbbrev": {
"type": "string"
},
"gamesPlayed": {
"type": [
"number",
"null"
]
},
"snapshotDate": {
"type": [
"string",
"null"
]
},
"shootoutLosses": {
"type": "number"
},
"goalsForPerGame": {
"type": [
"number",
"null"
]
},
"expectedGoalsFor": {
"type": [
"number",
"null"
]
},
"goalsAgainstPerGame": {
"type": [
"number",
"null"
]
},
"expectedGoalsAgainst": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"snapshot_date": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Standings",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when you need full details for one team: record, goals for and against, league rank, and 5v5 possession (Corsi%, Fenwick%, expected goals for and against). Possession is 5v5 only. Requires a team abbreviation (use list_teams if unsure). Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| team * | string | Team abbreviation (e.g. BUF, TOR, NYR) |
| league | string | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl. |
| season | string | Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. Defaults to current season. |
{
"name": "get_team_stats",
"title": "Team stats",
"description": "Use when you need full details for one team: record, goals for and against, league rank, and 5v5 possession (Corsi%, Fenwick%, expected goals for and against). Possession is 5v5 only. Requires a team abbreviation (use list_teams if unsure). Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"team"
],
"properties": {
"team": {
"type": "string",
"description": "Team abbreviation (e.g. BUF, TOR, NYR)"
},
"league": {
"enum": [
"nhl",
"pwhl",
"ohl",
"whl",
"qmjhl",
"echl",
"ahl",
"ushl"
],
"type": "string",
"description": "League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl."
},
"season": {
"type": "string",
"description": "Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. Defaults to current season."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"team",
"current_stats",
"season"
],
"properties": {
"team": {},
"season": {
"type": [
"string",
"null"
]
},
"current_stats": {
"anyOf": [
{},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Team stats",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when you need team abbreviations, or to see all 32 active NHL teams with city, conference, division, and arena. Excludes historical franchises (ATL, ARI). Cheapest tool at 1 credit.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl. |
| division | string | Filter by division |
| conference | string | Filter by conference |
{
"name": "list_teams",
"title": "List teams",
"description": "Use when you need team abbreviations, or to see all 32 active NHL teams with city, conference, division, and arena. Excludes historical franchises (ATL, ARI). Cheapest tool at 1 credit.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"league": {
"enum": [
"nhl",
"pwhl",
"ohl",
"whl",
"qmjhl",
"echl",
"ahl",
"ushl"
],
"type": "string",
"description": "League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl."
},
"division": {
"type": "string",
"description": "Filter by division"
},
"conference": {
"enum": [
"Eastern",
"Western"
],
"type": "string",
"description": "Filter by conference"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"teams",
"count"
],
"properties": {
"count": {
"type": "number"
},
"teams": {
"type": "array",
"items": {
"type": "object",
"required": [
"abbrev",
"name",
"conference",
"division"
],
"properties": {
"city": {
"type": "string"
},
"name": {
"type": "string"
},
"arena": {
"type": [
"string",
"null"
]
},
"abbrev": {
"type": "string"
},
"division": {
"type": "string"
},
"conference": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "List teams",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when querying past or future games with filters. Returns scores, teams, venue, and game metadata. For upcoming-only games, prefer get_schedule (2 cr) instead. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| team | string | Team abbreviation to filter (home or away) |
| limit | integer | Max results (default 100) |
| league | string | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl. |
| season | string | Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. |
| date_to | string | End date (YYYY-MM-DD) |
| date_from | string | Start date (YYYY-MM-DD) |
| game_type | string | Filter by game type |
| game_state | string | Filter by game state. FINAL and OFF both mean finished and return the same games; FUT is scheduled, LIVE in progress. |
{
"name": "get_games",
"title": "Games",
"description": "Use when querying past or future games with filters. Returns scores, teams, venue, and game metadata. For upcoming-only games, prefer get_schedule (2 cr) instead. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"team": {
"type": "string",
"description": "Team abbreviation to filter (home or away)"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results (default 100)"
},
"league": {
"enum": [
"nhl",
"pwhl",
"ohl",
"whl",
"qmjhl",
"echl",
"ahl",
"ushl"
],
"type": "string",
"description": "League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl."
},
"season": {
"type": "string",
"description": "Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted."
},
"date_to": {
"type": "string",
"description": "End date (YYYY-MM-DD)"
},
"date_from": {
"type": "string",
"description": "Start date (YYYY-MM-DD)"
},
"game_type": {
"enum": [
"regular",
"playoff",
"preseason"
],
"type": "string",
"description": "Filter by game type"
},
"game_state": {
"enum": [
"FUT",
"LIVE",
"FINAL",
"OFF"
],
"type": "string",
"description": "Filter by game state. FINAL and OFF both mean finished and return the same games; FUT is scheduled, LIVE in progress."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"games",
"count"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"games": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"season",
"gameDate",
"startTime",
"homeTeam",
"awayTeam",
"homeScore",
"awayScore",
"gameState",
"gameType",
"venue"
],
"properties": {
"id": {
"type": "string"
},
"venue": {
"type": [
"string",
"null"
]
},
"season": {
"type": [
"string",
"null"
]
},
"awayTeam": {
"type": "string"
},
"gameDate": {
"type": [
"string",
"null"
]
},
"gameType": {
"type": [
"string",
"null"
]
},
"homeTeam": {
"type": "string"
},
"awayScore": {
"type": [
"number",
"null"
]
},
"gameState": {
"type": [
"string",
"null"
]
},
"homeScore": {
"type": [
"number",
"null"
]
},
"startTime": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Games",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when checking what games are coming up. Returns only unplayed future games for the next N days (default 7). For past games, use get_games instead. Costs 2 credits.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Number of days ahead to look (default 7) |
| team | string | Team abbreviation to filter |
| league | string | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl. |
{
"name": "get_schedule",
"title": "Schedule",
"description": "Use when checking what games are coming up. Returns only unplayed future games for the next N days (default 7). For past games, use get_games instead. Costs 2 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"days": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Number of days ahead to look (default 7)"
},
"team": {
"type": "string",
"description": "Team abbreviation to filter"
},
"league": {
"enum": [
"nhl",
"pwhl",
"ohl",
"whl",
"qmjhl",
"echl",
"ahl",
"ushl"
],
"type": "string",
"description": "League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"upcoming_games",
"count"
],
"properties": {
"count": {
"type": "number"
},
"upcoming_games": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"gameDate",
"startTime",
"homeTeam",
"awayTeam",
"homeTeamName",
"awayTeamName",
"venue",
"gameType"
],
"properties": {
"id": {
"type": "string"
},
"venue": {
"type": [
"string",
"null"
]
},
"awayTeam": {
"type": "string"
},
"gameDate": {
"type": [
"string",
"null"
]
},
"gameType": {
"type": [
"string",
"null"
]
},
"homeTeam": {
"type": "string"
},
"startTime": {
"type": [
"string",
"null"
]
},
"awayTeamName": {
"type": [
"string",
"null"
]
},
"homeTeamName": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Schedule",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when you need everything about one game: both teams' full info, all betting odds, and the goalies who started, with their time on ice. Requires a game ID (get one from get_games or get_schedule). Odds for every game from 2019-20 on (and part of the 2019 playoffs). Goalie starts are derived from play-by-play, so they are available for played games, not upcoming ones. Costs 10 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl. |
| game_id * | string | NHL game ID (e.g. 2025020887) |
{
"name": "get_game_detail",
"title": "Game detail",
"description": "Use when you need everything about one game: both teams' full info, all betting odds, and the goalies who started, with their time on ice. Requires a game ID (get one from get_games or get_schedule). Odds for every game from 2019-20 on (and part of the 2019 playoffs). Goalie starts are derived from play-by-play, so they are available for played games, not upcoming ones. Costs 10 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id"
],
"properties": {
"league": {
"enum": [
"nhl",
"pwhl",
"ohl",
"whl",
"qmjhl",
"echl",
"ahl",
"ushl"
],
"type": "string",
"description": "League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl."
},
"game_id": {
"type": "string",
"description": "NHL game ID (e.g. 2025020887)"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game",
"home_team",
"away_team",
"odds",
"goalie_starts"
],
"properties": {
"game": {},
"odds": {
"type": "array",
"items": {
"type": "object",
"required": [
"bookmaker",
"snapshotType",
"source",
"mlHome",
"mlAway",
"mlHomeProb",
"mlAwayProb",
"spreadHome",
"spreadHomeOdds",
"spreadAway",
"spreadAwayOdds",
"total",
"totalOverOdds",
"totalUnderOdds",
"capturedAt"
],
"properties": {
"total": {
"type": [
"number",
"null"
]
},
"mlAway": {
"type": [
"number",
"null"
]
},
"mlHome": {
"type": [
"number",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"bookmaker": {
"type": "string"
},
"capturedAt": {
"type": [
"string",
"null"
]
},
"mlAwayProb": {
"type": [
"number",
"null"
]
},
"mlHomeProb": {
"type": [
"number",
"null"
]
},
"spreadAway": {
"type": [
"number",
"null"
]
},
"spreadHome": {
"type": [
"number",
"null"
]
},
"snapshotType": {
"type": [
"string",
"null"
]
},
"totalOverOdds": {
"type": [
"number",
"null"
]
},
"spreadAwayOdds": {
"type": [
"number",
"null"
]
},
"spreadHomeOdds": {
"type": [
"number",
"null"
]
},
"totalUnderOdds": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"away_team": {},
"home_team": {},
"goalie_starts": {
"anyOf": [
{},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Game detail",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when comparing two teams' history. Returns recent matchups with win/loss record. Can filter by season or get all-time. Costs 10 credits.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max games to return (default 20) |
| team1 * | string | First team abbreviation (e.g. BUF) |
| team2 * | string | Second team abbreviation (e.g. TOR) |
| league | string | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl. |
| season | string | Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. Omit for all-time. |
{
"name": "get_head_to_head",
"title": "Head to head",
"description": "Use when comparing two teams' history. Returns recent matchups with win/loss record. Can filter by season or get all-time. Costs 10 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"team1",
"team2"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max games to return (default 20)"
},
"team1": {
"type": "string",
"description": "First team abbreviation (e.g. BUF)"
},
"team2": {
"type": "string",
"description": "Second team abbreviation (e.g. TOR)"
},
"league": {
"enum": [
"nhl",
"pwhl",
"ohl",
"whl",
"qmjhl",
"echl",
"ahl",
"ushl"
],
"type": "string",
"description": "League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl."
},
"season": {
"type": "string",
"description": "Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. Omit for all-time."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"team1",
"team2",
"record",
"total_games",
"games"
],
"properties": {
"games": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"season",
"gameDate",
"startTime",
"homeTeam",
"awayTeam",
"homeScore",
"awayScore",
"gameState",
"gameType",
"venue"
],
"properties": {
"id": {
"type": "string"
},
"venue": {
"type": [
"string",
"null"
]
},
"season": {
"type": [
"string",
"null"
]
},
"awayTeam": {
"type": "string"
},
"gameDate": {
"type": [
"string",
"null"
]
},
"gameType": {
"type": [
"string",
"null"
]
},
"homeTeam": {
"type": "string"
},
"awayScore": {
"type": [
"number",
"null"
]
},
"gameState": {
"type": [
"string",
"null"
]
},
"homeScore": {
"type": [
"number",
"null"
]
},
"startTime": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"team1": {
"type": "string"
},
"team2": {
"type": "string"
},
"record": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"total_games": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Head to head",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when looking up a player by name. Searches 4,900+ players across every season since 2010-11. Returns active players by default; set active=false for retired/historical. Use the returned player ID with get_player_stats for full details. Costs 2 credits.
| Parameter | Type | Description |
|---|---|---|
| team | string | Filter by team abbreviation |
| limit | integer | Max results (default 10) |
| query * | string | Player name to search for (partial match supported) |
| active | boolean | Filter by active status (default: true). Set false to search active plus retired/historical players. |
| league | string | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl. |
| position | string | Filter by position |
{
"name": "search_players",
"title": "Search players",
"description": "Use when looking up a player by name. Searches 4,900+ players across every season since 2010-11. Returns active players by default; set active=false for retired/historical. Use the returned player ID with get_player_stats for full details. Costs 2 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"team": {
"type": "string",
"description": "Filter by team abbreviation"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max results (default 10)"
},
"query": {
"type": "string",
"minLength": 1,
"description": "Player name to search for (partial match supported)"
},
"active": {
"type": "boolean",
"description": "Filter by active status (default: true). Set false to search active plus retired/historical players."
},
"league": {
"enum": [
"nhl",
"pwhl",
"ohl",
"whl",
"qmjhl",
"echl",
"ahl",
"ushl"
],
"type": "string",
"description": "League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl."
},
"position": {
"enum": [
"G",
"D",
"C",
"LW",
"RW"
],
"type": "string",
"description": "Filter by position"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"players",
"count",
"included_inactive"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"players": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"firstName",
"lastName",
"team",
"teamName",
"position",
"positionType",
"jerseyNumber",
"birthCountry",
"active"
],
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"team": {
"type": [
"string",
"null"
]
},
"active": {
"type": [
"boolean",
"null"
]
},
"lastName": {
"type": [
"string",
"null"
]
},
"position": {
"type": [
"string",
"null"
]
},
"teamName": {
"type": [
"string",
"null"
]
},
"firstName": {
"type": [
"string",
"null"
]
},
"birthCountry": {
"type": [
"string",
"null"
]
},
"jerseyNumber": {
"type": [
"number",
"null"
]
},
"positionType": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"included_inactive": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search players",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when you need full details for one player: bio, team, and physical attributes. For skaters, also returns the latest season line (games, goals, assists, points, +/-, PP/SH, shooting%, TOI). For goalies, save%, GAA, GSAX, and trend data. Requires player ID from search_players. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl. |
| player_id * | integer | NHL player ID |
{
"name": "get_player_stats",
"title": "Player stats",
"description": "Use when you need full details for one player: bio, team, and physical attributes. For skaters, also returns the latest season line (games, goals, assists, points, +/-, PP/SH, shooting%, TOI). For goalies, save%, GAA, GSAX, and trend data. Requires player ID from search_players. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player_id"
],
"properties": {
"league": {
"enum": [
"nhl",
"pwhl",
"ohl",
"whl",
"qmjhl",
"echl",
"ahl",
"ushl"
],
"type": "string",
"description": "League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl."
},
"player_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "NHL player ID"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player",
"goalie_stats",
"skater_stats"
],
"properties": {
"player": {},
"goalie_stats": {
"anyOf": [
{},
{
"type": "null"
}
]
},
"skater_stats": {
"anyOf": [
{},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Player stats",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when ranking goalies or comparing goalie performance. Returns a leaderboard sorted by save%, GAA, GSAX, or wins, with a games-played filter. Includes goals saved above expected, high-danger save%, rolling save% and GSAX over the last 10 appearances, form trend and rest days. Goalie expected goals cover every strength, unlike the 5v5-only team possession columns. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| team | string | Filter by team abbreviation |
| limit | integer | Max results (default 20) |
| league | string | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl. |
| season | string | Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. Defaults to the most recent season with stats, which is the current season once it is under way and the previous one before that. The season actually used is echoed in filters.season. |
| sort_by | string | Sort metric (default save_pct). gsax is goals saved above expected. |
| min_games | integer | Minimum games played (default 10; early in a season, half the most games anyone has played so far) |
{
"name": "get_goalie_stats",
"title": "Goalie stats",
"description": "Use when ranking goalies or comparing goalie performance. Returns a leaderboard sorted by save%, GAA, GSAX, or wins, with a games-played filter. Includes goals saved above expected, high-danger save%, rolling save% and GSAX over the last 10 appearances, form trend and rest days. Goalie expected goals cover every strength, unlike the 5v5-only team possession columns. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"team": {
"type": "string",
"description": "Filter by team abbreviation"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max results (default 20)"
},
"league": {
"enum": [
"nhl",
"pwhl",
"ohl",
"whl",
"qmjhl",
"echl",
"ahl",
"ushl"
],
"type": "string",
"description": "League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl."
},
"season": {
"type": "string",
"description": "Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. Defaults to the most recent season with stats, which is the current season once it is under way and the previous one before that. The season actually used is echoed in filters.season."
},
"sort_by": {
"enum": [
"save_pct",
"gaa",
"gsax",
"wins"
],
"type": "string",
"description": "Sort metric (default save_pct). gsax is goals saved above expected."
},
"min_games": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Minimum games played (default 10; early in a season, half the most games anyone has played so far)"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"goalies",
"count",
"filters"
],
"properties": {
"count": {
"type": "number"
},
"filters": {
"type": "object",
"required": [
"season",
"min_games",
"sort_by"
],
"properties": {
"season": {
"type": [
"string",
"null"
]
},
"sort_by": {
"type": "string"
},
"min_games": {
"type": "number"
}
},
"additionalProperties": false
},
"goalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"playerId",
"playerName",
"team",
"teamName",
"gamesPlayed",
"wins",
"losses",
"otLosses",
"savePct",
"gaa",
"gsax",
"shutouts",
"highDangerSavePct",
"rollingSavePct",
"trend",
"restDays",
"snapshotDate"
],
"properties": {
"gaa": {
"type": [
"number",
"null"
]
},
"gsax": {
"type": [
"number",
"null"
]
},
"team": {
"type": [
"string",
"null"
]
},
"wins": {
"type": [
"number",
"null"
]
},
"trend": {
"type": [
"string",
"null"
]
},
"losses": {
"type": [
"number",
"null"
]
},
"savePct": {
"type": [
"number",
"null"
]
},
"otLosses": {
"type": [
"number",
"null"
]
},
"playerId": {
"type": "number"
},
"restDays": {
"type": [
"number",
"null"
]
},
"shutouts": {
"type": [
"number",
"null"
]
},
"teamName": {
"type": [
"string",
"null"
]
},
"playerName": {
"type": "string"
},
"gamesPlayed": {
"type": [
"number",
"null"
]
},
"snapshotDate": {
"type": [
"string",
"null"
]
},
"rollingSavePct": {
"type": [
"number",
"null"
]
},
"highDangerSavePct": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Goalie stats",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when ranking skaters or comparing scoring. Returns a leaderboard sorted by points, goals, assists, plus/minus, or shots, with a games-played filter. Includes power play and shorthanded production, shooting%, faceoff%, and average time on ice. Seasons from 2010-11 on. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| team | string | Filter by team abbreviation |
| limit | integer | Max results (default 20) |
| league | string | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl. |
| season | string | Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. Defaults to the most recent season with stats, which is the current season once it is under way and the previous one before that. The season actually used is echoed in filters.season. |
| sort_by | string | Sort metric (default points) |
| min_games | integer | Minimum games played (default 10; early in a season, half the most games anyone has played so far) |
{
"name": "get_skater_season_stats",
"title": "Skater season stats",
"description": "Use when ranking skaters or comparing scoring. Returns a leaderboard sorted by points, goals, assists, plus/minus, or shots, with a games-played filter. Includes power play and shorthanded production, shooting%, faceoff%, and average time on ice. Seasons from 2010-11 on. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"team": {
"type": "string",
"description": "Filter by team abbreviation"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max results (default 20)"
},
"league": {
"enum": [
"nhl",
"pwhl",
"ohl",
"whl",
"qmjhl",
"echl",
"ahl",
"ushl"
],
"type": "string",
"description": "League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl."
},
"season": {
"type": "string",
"description": "Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. Defaults to the most recent season with stats, which is the current season once it is under way and the previous one before that. The season actually used is echoed in filters.season."
},
"sort_by": {
"enum": [
"points",
"goals",
"assists",
"plus_minus",
"shots"
],
"type": "string",
"description": "Sort metric (default points)"
},
"min_games": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Minimum games played (default 10; early in a season, half the most games anyone has played so far)"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"skaters",
"count",
"filters"
],
"properties": {
"count": {
"type": "number"
},
"filters": {
"type": "object",
"required": [
"season",
"min_games",
"sort_by"
],
"properties": {
"season": {
"type": [
"string",
"null"
]
},
"sort_by": {
"type": "string"
},
"min_games": {
"type": "number"
}
},
"additionalProperties": false
},
"skaters": {
"type": "array",
"items": {
"type": "object",
"required": [
"playerId",
"playerName",
"team",
"teamName",
"position",
"gamesPlayed",
"goals",
"assists",
"points",
"plusMinus",
"pim",
"powerPlayGoals",
"powerPlayPoints",
"shorthandedGoals",
"shorthandedPoints",
"gameWinningGoals",
"otGoals",
"shots",
"shootingPct",
"faceoffPct",
"avgToiPerGame",
"snapshotDate"
],
"properties": {
"pim": {
"type": [
"number",
"null"
]
},
"team": {
"type": [
"string",
"null"
]
},
"goals": {
"type": [
"number",
"null"
]
},
"shots": {
"type": [
"number",
"null"
]
},
"points": {
"type": [
"number",
"null"
]
},
"assists": {
"type": [
"number",
"null"
]
},
"otGoals": {
"type": [
"number",
"null"
]
},
"playerId": {
"type": "number"
},
"position": {
"type": [
"string",
"null"
]
},
"teamName": {
"type": [
"string",
"null"
]
},
"plusMinus": {
"type": [
"number",
"null"
]
},
"faceoffPct": {
"type": [
"number",
"null"
]
},
"playerName": {
"type": "string"
},
"gamesPlayed": {
"type": [
"number",
"null"
]
},
"shootingPct": {
"type": [
"number",
"null"
]
},
"snapshotDate": {
"type": [
"string",
"null"
]
},
"avgToiPerGame": {
"type": [
"number",
"null"
]
},
"powerPlayGoals": {
"type": [
"number",
"null"
]
},
"powerPlayPoints": {
"type": [
"number",
"null"
]
},
"gameWinningGoals": {
"type": [
"number",
"null"
]
},
"shorthandedGoals": {
"type": [
"number",
"null"
]
},
"shorthandedPoints": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Skater season stats",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when you need a player's game-by-game stat lines for a season, not a season total. For skaters: date, opponent, home/away, goals, assists, points, shots, PIM, power-play points, time on ice and plus/minus for each game. For goalies: date, opponent, home/away, decision, shots against, saves, goals against, save% and time on ice for each game. Time on ice and plus/minus are the official NHL boxscore figures, loaded with each game's shift chart (2010-11 on); a game not loaded yet shows null. Requires player ID from search_players. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max games to return (default 100) |
| league | string | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl. |
| offset | integer | Pagination offset |
| season | string | Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. Defaults to the most recent season with stats for this player, which is the current season once it is under way and the previous one before that. The season actually used is echoed back in the response. |
| game_type | string | Which games to include: regular, playoff, preseason, or all. Defaults to regular, matching every other stats tool. |
| player_id * | integer | NHL player ID |
{
"name": "get_player_game_log",
"title": "Player game log",
"description": "Use when you need a player's game-by-game stat lines for a season, not a season total. For skaters: date, opponent, home/away, goals, assists, points, shots, PIM, power-play points, time on ice and plus/minus for each game. For goalies: date, opponent, home/away, decision, shots against, saves, goals against, save% and time on ice for each game. Time on ice and plus/minus are the official NHL boxscore figures, loaded with each game's shift chart (2010-11 on); a game not loaded yet shows null. Requires player ID from search_players. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Max games to return (default 100)"
},
"league": {
"enum": [
"nhl",
"pwhl",
"ohl",
"whl",
"qmjhl",
"echl",
"ahl",
"ushl"
],
"type": "string",
"description": "League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Pagination offset"
},
"season": {
"type": "string",
"description": "Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. Defaults to the most recent season with stats for this player, which is the current season once it is under way and the previous one before that. The season actually used is echoed back in the response."
},
"game_type": {
"enum": [
"regular",
"playoff",
"preseason",
"all"
],
"type": "string",
"description": "Which games to include: regular, playoff, preseason, or all. Defaults to regular, matching every other stats tool."
},
"player_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "NHL player ID"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player",
"games",
"count",
"season",
"game_type",
"next_offset"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"games": {
"type": "array",
"items": {
"type": "object",
"required": [
"gameId",
"gameDate",
"gameType",
"team",
"opponent",
"homeAway",
"goals",
"assists",
"points",
"shots",
"pim",
"ppPoints",
"plusMinus",
"decision",
"shotsAgainst",
"saves",
"goalsAgainst",
"savePct",
"timeOnIce"
],
"properties": {
"pim": {
"type": [
"number",
"null"
]
},
"team": {
"type": [
"string",
"null"
]
},
"goals": {
"type": [
"number",
"null"
]
},
"saves": {
"type": [
"number",
"null"
]
},
"shots": {
"type": [
"number",
"null"
]
},
"gameId": {
"type": "string"
},
"points": {
"type": [
"number",
"null"
]
},
"assists": {
"type": [
"number",
"null"
]
},
"savePct": {
"type": [
"number",
"null"
]
},
"decision": {
"anyOf": [
{
"enum": [
"win",
"loss"
],
"type": "string"
},
{
"type": "null"
}
]
},
"gameDate": {
"type": [
"string",
"null"
]
},
"gameType": {
"type": [
"string",
"null"
]
},
"homeAway": {
"anyOf": [
{
"enum": [
"home",
"away"
],
"type": "string"
},
{
"type": "null"
}
]
},
"opponent": {
"type": [
"string",
"null"
]
},
"ppPoints": {
"type": [
"number",
"null"
]
},
"plusMinus": {
"type": [
"number",
"null"
]
},
"timeOnIce": {
"type": [
"number",
"null"
]
},
"goalsAgainst": {
"type": [
"number",
"null"
]
},
"shotsAgainst": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"player": {
"type": "object",
"required": [
"id",
"name",
"position"
],
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"position": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"season": {
"type": [
"string",
"null"
]
},
"game_type": {
"type": "string"
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Player game log",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when checking betting lines. Pass game_id for one game (10 credits): moneyline, puck line and total by bookmaker, opening and closing. Or pass season (optionally with team) for a whole season of closing lines in one call, with final scores, at 10 credits per game returned (a full season is ~13,700 credits, a team-season ~820), 100 games a page by default (up to 500). Each book's line is an array in the order given by columns. Set estimate_only to get the price without being charged. Every game from 2019-20 on (and part of the 2019 playoffs): about 16 to 18 books a game from 2020-21 to 2023-24, about 6 in 2019-20, 8 in 2024-25 and 2025-26 (60+ on about 300 games in 2025-26), with all_books; a season answer defaults to the four main books. A season those four do not carry (2019-20) returns every book it has. Each line carries a source field (one value for opening and closing lines from August 2020, another for final per-book lines); a season answer lists each game's sources. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| team | string | With season: only this team's games (abbreviation, e.g. BUF). |
| limit | integer | With season: games per page (default 100, max 500). |
| offset | integer | With season: page offset; use next_offset from the previous page. |
| season | string | Season for a whole season of lines, e.g. 2025-26 or 20252026. Used when game_id is not set. |
| game_id | string | NHL game ID (e.g. 2025020887). Omit and pass season for a whole season. |
| all_books | boolean | With season: every book held (16 to 18 a game from 2020-21 to 2023-24, 8 in 2024-25, more than 60 on about 300 games in 2025-26) instead of DraftKings, FanDuel, BetMGM and ESPN BET. |
| bookmaker | string | Filter by bookmaker key (e.g. draftkings, fanduel, betmgm). Lowercase. |
| estimate_only | boolean | Return what this call would cost, without charging or running it. |
| snapshot_type | string | opening (game-day morning; for a game not yet played, the latest morning line) or closing (final pre-game). Single game: default every snapshot held, including first (each book's first posted line, from October 2026). Season: default closing. |
{
"name": "get_odds",
"title": "Odds",
"description": "Use when checking betting lines. Pass game_id for one game (10 credits): moneyline, puck line and total by bookmaker, opening and closing. Or pass season (optionally with team) for a whole season of closing lines in one call, with final scores, at 10 credits per game returned (a full season is ~13,700 credits, a team-season ~820), 100 games a page by default (up to 500). Each book's line is an array in the order given by columns. Set estimate_only to get the price without being charged. Every game from 2019-20 on (and part of the 2019 playoffs): about 16 to 18 books a game from 2020-21 to 2023-24, about 6 in 2019-20, 8 in 2024-25 and 2025-26 (60+ on about 300 games in 2025-26), with all_books; a season answer defaults to the four main books. A season those four do not carry (2019-20) returns every book it has. Each line carries a source field (one value for opening and closing lines from August 2020, another for final per-book lines); a season answer lists each game's sources. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"team": {
"type": "string",
"description": "With season: only this team's games (abbreviation, e.g. BUF)."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "With season: games per page (default 100, max 500)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "With season: page offset; use next_offset from the previous page."
},
"season": {
"type": "string",
"description": "Season for a whole season of lines, e.g. 2025-26 or 20252026. Used when game_id is not set."
},
"game_id": {
"type": "string",
"description": "NHL game ID (e.g. 2025020887). Omit and pass season for a whole season."
},
"all_books": {
"type": "boolean",
"description": "With season: every book held (16 to 18 a game from 2020-21 to 2023-24, 8 in 2024-25, more than 60 on about 300 games in 2025-26) instead of DraftKings, FanDuel, BetMGM and ESPN BET."
},
"bookmaker": {
"type": "string",
"description": "Filter by bookmaker key (e.g. draftkings, fanduel, betmgm). Lowercase."
},
"estimate_only": {
"type": "boolean",
"description": "Return what this call would cost, without charging or running it."
},
"snapshot_type": {
"enum": [
"opening",
"closing"
],
"type": "string",
"description": "opening (game-day morning; for a game not yet played, the latest morning line) or closing (final pre-game). Single game: default every snapshot held, including first (each book's first posted line, from October 2026). Season: default closing."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"note": {
"type": "string"
},
"odds": {
"type": "array",
"items": {
"type": "object",
"required": [
"bookmaker",
"snapshotType",
"source",
"mlHome",
"mlAway",
"mlHomeProb",
"mlAwayProb",
"spreadHome",
"spreadHomeOdds",
"spreadAway",
"spreadAwayOdds",
"total",
"totalOverOdds",
"totalUnderOdds",
"capturedAt"
],
"properties": {
"total": {
"type": [
"number",
"null"
]
},
"mlAway": {
"type": [
"number",
"null"
]
},
"mlHome": {
"type": [
"number",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"bookmaker": {
"type": "string"
},
"capturedAt": {
"type": [
"string",
"null"
]
},
"mlAwayProb": {
"type": [
"number",
"null"
]
},
"mlHomeProb": {
"type": [
"number",
"null"
]
},
"spreadAway": {
"type": [
"number",
"null"
]
},
"spreadHome": {
"type": [
"number",
"null"
]
},
"snapshotType": {
"type": [
"string",
"null"
]
},
"totalOverOdds": {
"type": [
"number",
"null"
]
},
"spreadAwayOdds": {
"type": [
"number",
"null"
]
},
"spreadHomeOdds": {
"type": [
"number",
"null"
]
},
"totalUnderOdds": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"tool": {
"type": "string"
},
"count": {
"type": "number"
},
"games": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"season": {
"type": "string"
},
"columns": {
"type": "array",
"items": {
"type": "string"
}
},
"credits": {
"type": "number"
},
"game_id": {
"type": "string"
},
"away_team": {
"type": "string"
},
"game_date": {
"type": [
"string",
"null"
]
},
"home_team": {
"type": "string"
},
"next_offset": {
"type": [
"number",
"null"
]
},
"total_games": {
"type": "number"
},
"estimate_only": {
"type": "boolean"
},
"snapshot_type": {
"type": "string"
},
"bookmaker_count": {
"type": "number"
},
"credits_per_game": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Odds",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when analyzing how betting lines moved over time. Returns time-series snapshots grouped by bookmaker. Most expensive tool (25 cr). If you only need current lines, use get_odds (10 cr) instead. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| game_id * | string | NHL game ID |
| bookmaker | string | Filter by specific bookmaker key (lowercase) |
{
"name": "get_line_movement",
"title": "Line movement",
"description": "Use when analyzing how betting lines moved over time. Returns time-series snapshots grouped by bookmaker. Most expensive tool (25 cr). If you only need current lines, use get_odds (10 cr) instead. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id"
],
"properties": {
"game_id": {
"type": "string",
"description": "NHL game ID"
},
"bookmaker": {
"type": "string",
"description": "Filter by specific bookmaker key (lowercase)"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id",
"home_team",
"away_team",
"movement"
],
"properties": {
"game_id": {
"type": "string"
},
"movement": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "array",
"items": {
"type": "object",
"required": [
"bookmaker",
"snapshotType",
"mlHome",
"mlAway",
"spreadHome",
"total",
"capturedAt"
],
"properties": {
"total": {
"type": [
"number",
"null"
]
},
"mlAway": {
"type": [
"number",
"null"
]
},
"mlHome": {
"type": [
"number",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"bookmaker": {
"type": "string"
},
"capturedAt": {
"type": [
"string",
"null"
]
},
"spreadHome": {
"type": [
"number",
"null"
]
},
"snapshotType": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
}
},
"away_team": {
"type": "string"
},
"home_team": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Line movement",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for player prop lines by sportsbook: over/under on points, goals, assists, shots on goal, blocked shots, goalie saves, power-play points, anytime and first goal scorer, from May 2023 (DraftKings, FanDuel, BetMGM, ESPN BET, Pinnacle and others). Pass game_id for every player's props in one game, or player_id with from_date (and to_date) for one player across games (up to 100). A game costs 10 credits before it starts and 20 once it has (accounts opened before October 30 2026 pay 10 for every game). Returns the closing line by default (the last before the game starts) or the opening line, with each book's over and under prices. Each row has captured_at, scheduled_start and minutes_before_scheduled_start (negative when captured after the scheduled start); a row is kept when it was captured before the sportsbooks' listed start, which in the NBA is usually about 10 minutes after the scheduled one, so filter on minutes_before_scheduled_start > 0 for a strictly before-schedule backtest. Outside football the archive mostly holds one pre-game capture per line, so the opening and closing lines are usually the same; the opening line differs only where a second capture was taken (live capture from October 2026, and wherever else it is held). Set estimate_only to get the price without being charged. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| market | string | One market: player_points (points), player_goals (goals), player_assists (assists), player_shots_on_goal (shots on goal), player_blocked_shots (blocked shots), player_total_saves (goalie saves), player_goal_scorer_anytime (anytime goal scorer (over = scores)), player_power_play_points (power-play po… |
| game_id | string | Game id: every player's props for that game. |
| to_date | string | With player_id: last date (default: no end), YYYY-MM-DD (the game's date). |
| bookmaker | string | Bookmaker key, e.g. draftkings, fanduel, pinnacle. |
| from_date | string | With player_id: first date, YYYY-MM-DD (the game's date). |
| player_id | ["number","string"] | Player id (e.g. 8478402) from search_players. With from_date: that player's props across games. |
| estimate_only | boolean | Return what this call would cost, without charging or running it. |
| snapshot_type | string | closing (default): the last line before the game starts. opening: the first one captured, which is the same capture as the close wherever only one was taken. |
{
"name": "get_player_props",
"title": "Player props",
"description": "Use for player prop lines by sportsbook: over/under on points, goals, assists, shots on goal, blocked shots, goalie saves, power-play points, anytime and first goal scorer, from May 2023 (DraftKings, FanDuel, BetMGM, ESPN BET, Pinnacle and others). Pass game_id for every player's props in one game, or player_id with from_date (and to_date) for one player across games (up to 100). A game costs 10 credits before it starts and 20 once it has (accounts opened before October 30 2026 pay 10 for every game). Returns the closing line by default (the last before the game starts) or the opening line, with each book's over and under prices. Each row has captured_at, scheduled_start and minutes_before_scheduled_start (negative when captured after the scheduled start); a row is kept when it was captured before the sportsbooks' listed start, which in the NBA is usually about 10 minutes after the scheduled one, so filter on minutes_before_scheduled_start > 0 for a strictly before-schedule backtest. Outside football the archive mostly holds one pre-game capture per line, so the opening and closing lines are usually the same; the opening line differs only where a second capture was taken (live capture from October 2026, and wherever else it is held). Set estimate_only to get the price without being charged. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"market": {
"enum": [
"player_points",
"player_goals",
"player_assists",
"player_shots_on_goal",
"player_blocked_shots",
"player_total_saves",
"player_goal_scorer_anytime",
"player_power_play_points",
"player_goal_scorer_first"
],
"type": "string",
"description": "One market: player_points (points), player_goals (goals), player_assists (assists), player_shots_on_goal (shots on goal), player_blocked_shots (blocked shots), player_total_saves (goalie saves), player_goal_scorer_anytime (anytime goal scorer (over = scores)), player_power_play_points (power-play points), player_goal_scorer_first (first goal scorer (over = scores the game's first goal))"
},
"game_id": {
"type": "string",
"description": "Game id: every player's props for that game."
},
"to_date": {
"type": "string",
"description": "With player_id: last date (default: no end), YYYY-MM-DD (the game's date)."
},
"bookmaker": {
"type": "string",
"description": "Bookmaker key, e.g. draftkings, fanduel, pinnacle."
},
"from_date": {
"type": "string",
"description": "With player_id: first date, YYYY-MM-DD (the game's date)."
},
"player_id": {
"type": [
"number",
"string"
],
"description": "Player id (e.g. 8478402) from search_players. With from_date: that player's props across games."
},
"estimate_only": {
"type": "boolean",
"description": "Return what this call would cost, without charging or running it."
},
"snapshot_type": {
"enum": [
"opening",
"closing"
],
"type": "string",
"description": "closing (default): the last line before the game starts. opening: the first one captured, which is the same capture as the close wherever only one was taken."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"note": {
"type": "string"
},
"tool": {
"type": "string"
},
"count": {
"type": "number"
},
"games": {
"type": "number"
},
"props": {
"type": "array",
"items": {
"type": "object",
"required": [
"game_id",
"game_date",
"player_name",
"player_id",
"market",
"bookmaker",
"line",
"over_odds",
"under_odds",
"captured_at",
"source"
],
"properties": {
"line": {
"type": [
"number",
"null"
]
},
"market": {
"type": "string"
},
"source": {
"type": "string"
},
"game_id": {
"type": "string"
},
"bookmaker": {
"type": "string"
},
"game_date": {
"type": [
"string",
"null"
]
},
"over_odds": {
"type": [
"number",
"null"
]
},
"player_id": {
"type": [
"string",
"number",
"null"
]
},
"under_odds": {
"type": [
"number",
"null"
]
},
"captured_at": {
"type": "string"
},
"player_name": {
"type": "string"
},
"scheduled_start": {
"type": [
"string",
"null"
]
},
"minutes_before_scheduled_start": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"credits": {
"type": "number"
},
"estimate_only": {
"type": "boolean"
},
"snapshot_type": {
"type": "string"
},
"next_from_date": {
"type": [
"string",
"null"
]
},
"credits_per_game": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Player props",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use to see how a player did against his prop line over time: for one market (points, goals, assists, shots on goal, blocked shots, goalie saves, power-play points, or anytime or first goal scorer), one row per game with the closing line (the median across books, or one book's), the opening line (the same as the close wherever only one capture was taken), the prices, what the player actually recorded from our box scores and the result against the line, plus the over rate, up to 200 games a call. Costs 10 credits for every 25 games already played that a call covers, and at least 10 a call (accounts opened before November 1 2026 pay 10 a call). Set estimate_only to get the price without being charged. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Games to return, oldest first (default 50, max 200). next_from_date says where to continue. |
| market * | string | The market: player_points (points), player_goals (goals), player_assists (assists), player_shots_on_goal (shots on goal), player_blocked_shots (blocked shots), player_total_saves (goalie saves), player_goal_scorer_anytime (anytime goal scorer (over = scores)), player_power_play_points (power-play po… |
| to_date | string | Last date, YYYY-MM-DD (the game's date). |
| bookmaker | string | One book's closing line instead of the median across books, e.g. draftkings. |
| from_date | string | First date, YYYY-MM-DD (the game's date). |
| player_id * | ["number","string"] | Player id (e.g. 8478402) from search_players. |
| estimate_only | boolean | Return what this call would cost, without charging or running it. |
{
"name": "get_prop_history",
"title": "Prop history",
"description": "Use to see how a player did against his prop line over time: for one market (points, goals, assists, shots on goal, blocked shots, goalie saves, power-play points, or anytime or first goal scorer), one row per game with the closing line (the median across books, or one book's), the opening line (the same as the close wherever only one capture was taken), the prices, what the player actually recorded from our box scores and the result against the line, plus the over rate, up to 200 games a call. Costs 10 credits for every 25 games already played that a call covers, and at least 10 a call (accounts opened before November 1 2026 pay 10 a call). Set estimate_only to get the price without being charged. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player_id",
"market"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Games to return, oldest first (default 50, max 200). next_from_date says where to continue."
},
"market": {
"enum": [
"player_points",
"player_goals",
"player_assists",
"player_shots_on_goal",
"player_blocked_shots",
"player_total_saves",
"player_goal_scorer_anytime",
"player_power_play_points",
"player_goal_scorer_first"
],
"type": "string",
"description": "The market: player_points (points), player_goals (goals), player_assists (assists), player_shots_on_goal (shots on goal), player_blocked_shots (blocked shots), player_total_saves (goalie saves), player_goal_scorer_anytime (anytime goal scorer (over = scores)), player_power_play_points (power-play points), player_goal_scorer_first (first goal scorer (over = scores the game's first goal))"
},
"to_date": {
"type": "string",
"description": "Last date, YYYY-MM-DD (the game's date)."
},
"bookmaker": {
"type": "string",
"description": "One book's closing line instead of the median across books, e.g. draftkings."
},
"from_date": {
"type": "string",
"description": "First date, YYYY-MM-DD (the game's date)."
},
"player_id": {
"type": [
"number",
"string"
],
"description": "Player id (e.g. 8478402) from search_players."
},
"estimate_only": {
"type": "boolean",
"description": "Return what this call would cost, without charging or running it."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player_id",
"player_name",
"market",
"stat",
"bookmaker",
"games",
"count",
"summary"
],
"properties": {
"note": {
"type": "string"
},
"stat": {
"type": "string"
},
"tool": {
"type": "string"
},
"count": {
"type": "number"
},
"games": {
"type": "array",
"items": {
"type": "object",
"required": [
"game_id",
"game_date",
"line",
"open_line",
"over_odds",
"under_odds",
"books",
"actual",
"result",
"margin"
],
"properties": {
"line": {
"type": [
"number",
"null"
]
},
"books": {
"type": "number"
},
"actual": {
"type": [
"number",
"null"
]
},
"margin": {
"type": [
"number",
"null"
]
},
"result": {
"anyOf": [
{
"enum": [
"over",
"under",
"push"
],
"type": "string"
},
{
"type": "null"
}
]
},
"game_id": {
"type": "string"
},
"game_date": {
"type": [
"string",
"null"
]
},
"open_line": {
"type": [
"number",
"null"
]
},
"over_odds": {
"type": [
"number",
"null"
]
},
"under_odds": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"market": {
"type": "string"
},
"credits": {
"type": "number"
},
"summary": {
"type": "object",
"required": [
"games",
"graded",
"overs",
"unders",
"pushes",
"over_rate",
"avg_line",
"avg_actual"
],
"properties": {
"games": {
"type": "number"
},
"overs": {
"type": "number"
},
"graded": {
"type": "number"
},
"pushes": {
"type": "number"
},
"unders": {
"type": "number"
},
"avg_line": {
"type": [
"number",
"null"
]
},
"over_rate": {
"type": [
"number",
"null"
]
},
"avg_actual": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"bookmaker": {
"type": [
"string",
"null"
]
},
"player_id": {
"type": [
"string",
"number"
]
},
"truncated": {
"type": "boolean"
},
"player_name": {
"type": [
"string",
"null"
]
},
"estimate_only": {
"type": "boolean"
},
"next_from_date": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Prop history",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use to see how one player's prop line moved before a game: every capture we hold, book by book and oldest first, with the line, both prices and the minutes before the start. line_change is the last capture's line minus the first's. The number of captures varies by game and book. Costs 10 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| market * | string | The market: player_points (points), player_goals (goals), player_assists (assists), player_shots_on_goal (shots on goal), player_blocked_shots (blocked shots), player_total_saves (goalie saves), player_goal_scorer_anytime (anytime goal scorer (over = scores)), player_power_play_points (power-play po… |
| game_id * | string | Game id. |
| bookmaker | string | One book's captures, e.g. draftkings. |
| player_id * | ["number","string"] | Player id (e.g. 8478402) from search_players. |
{
"name": "get_prop_movement",
"title": "Prop movement",
"description": "Use to see how one player's prop line moved before a game: every capture we hold, book by book and oldest first, with the line, both prices and the minutes before the start. line_change is the last capture's line minus the first's. The number of captures varies by game and book. Costs 10 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id",
"player_id",
"market"
],
"properties": {
"market": {
"enum": [
"player_points",
"player_goals",
"player_assists",
"player_shots_on_goal",
"player_blocked_shots",
"player_total_saves",
"player_goal_scorer_anytime",
"player_power_play_points",
"player_goal_scorer_first"
],
"type": "string",
"description": "The market: player_points (points), player_goals (goals), player_assists (assists), player_shots_on_goal (shots on goal), player_blocked_shots (blocked shots), player_total_saves (goalie saves), player_goal_scorer_anytime (anytime goal scorer (over = scores)), player_power_play_points (power-play points), player_goal_scorer_first (first goal scorer (over = scores the game's first goal))"
},
"game_id": {
"type": "string",
"description": "Game id."
},
"bookmaker": {
"type": "string",
"description": "One book's captures, e.g. draftkings."
},
"player_id": {
"type": [
"number",
"string"
],
"description": "Player id (e.g. 8478402) from search_players."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id",
"player_id",
"player_name",
"market",
"books",
"count"
],
"properties": {
"note": {
"type": "string"
},
"tool": {
"type": "string"
},
"books": {
"type": "array",
"items": {
"type": "object",
"required": [
"bookmaker",
"snapshots",
"line_change"
],
"properties": {
"bookmaker": {
"type": "string"
},
"snapshots": {
"type": "array",
"items": {
"type": "object",
"required": [
"captured_at",
"minutes_before_scheduled_start",
"line",
"over_odds",
"under_odds"
],
"properties": {
"line": {
"type": [
"number",
"null"
]
},
"over_odds": {
"type": [
"number",
"null"
]
},
"under_odds": {
"type": [
"number",
"null"
]
},
"captured_at": {
"type": "string"
},
"minutes_before_scheduled_start": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"line_change": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"market": {
"type": "string"
},
"credits": {
"type": "number"
},
"game_id": {
"type": "string"
},
"player_id": {
"type": [
"string",
"number"
]
},
"player_name": {
"type": [
"string",
"null"
]
},
"estimate_only": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Prop movement",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for the extra betting markets of a game as history: the regulation result (three-way, a draw is possible), the 1st period result and puck line, and the 1st, 2nd and 3rd period totals. Pass game_id (from get_schedule or get_games) and market. For each sportsbook it returns the opening line (the first one we captured) and the closing line (the last one before the game started), each as the list of outcomes with their point and American price, plus captured_at and minutes_before_start (negative when the last capture came after our scheduled start, which the sportsbooks' listed start can run past). Most books were captured once, so opening and closing are often the same line. Held from May 2023 (the 2022-23 playoffs) for the larger sportsbooks only; not every game has every market. Each game's lines are added the morning after it is played. Costs 10 credits a call; a game with no lines is refunded. Set estimate_only to get the price without being charged. For the full-game moneyline, spread and total use get_odds. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| market * | string | The market: h2h_3_way (regulation result: home, draw or away after 60 minutes), totals_p1 (1st period total goals), totals_p2 (2nd period total goals), totals_p3 (3rd period total goals), h2h_p1 (1st period result: home, draw or away), spreads_p1 (1st period puck line) |
| game_id * | string | Game id from get_schedule or get_games. |
| bookmaker | string | One bookmaker key, e.g. draftkings, fanduel, pinnacle. |
| estimate_only | boolean | Return what this call would cost, without charging or running it. |
{
"name": "get_market_odds",
"title": "Market odds",
"description": "Use for the extra betting markets of a game as history: the regulation result (three-way, a draw is possible), the 1st period result and puck line, and the 1st, 2nd and 3rd period totals. Pass game_id (from get_schedule or get_games) and market. For each sportsbook it returns the opening line (the first one we captured) and the closing line (the last one before the game started), each as the list of outcomes with their point and American price, plus captured_at and minutes_before_start (negative when the last capture came after our scheduled start, which the sportsbooks' listed start can run past). Most books were captured once, so opening and closing are often the same line. Held from May 2023 (the 2022-23 playoffs) for the larger sportsbooks only; not every game has every market. Each game's lines are added the morning after it is played. Costs 10 credits a call; a game with no lines is refunded. Set estimate_only to get the price without being charged. For the full-game moneyline, spread and total use get_odds. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id",
"market"
],
"properties": {
"market": {
"enum": [
"h2h_3_way",
"totals_p1",
"totals_p2",
"totals_p3",
"h2h_p1",
"spreads_p1"
],
"type": "string",
"description": "The market: h2h_3_way (regulation result: home, draw or away after 60 minutes), totals_p1 (1st period total goals), totals_p2 (2nd period total goals), totals_p3 (3rd period total goals), h2h_p1 (1st period result: home, draw or away), spreads_p1 (1st period puck line)"
},
"game_id": {
"type": "string",
"description": "Game id from get_schedule or get_games."
},
"bookmaker": {
"type": "string",
"description": "One bookmaker key, e.g. draftkings, fanduel, pinnacle."
},
"estimate_only": {
"type": "boolean",
"description": "Return what this call would cost, without charging or running it."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id",
"market",
"label",
"scheduled_start",
"books",
"count"
],
"properties": {
"note": {
"type": "string"
},
"tool": {
"type": "string"
},
"books": {
"type": "array",
"items": {
"type": "object",
"required": [
"bookmaker",
"opening",
"opening_captured_at",
"closing",
"closing_captured_at",
"minutes_before_start"
],
"properties": {
"closing": {
"type": "array",
"items": {
"type": "object",
"required": [
"outcome",
"point",
"price"
],
"properties": {
"point": {
"type": [
"number",
"null"
]
},
"price": {
"type": [
"number",
"null"
]
},
"outcome": {
"type": "string"
}
},
"additionalProperties": false
}
},
"opening": {
"type": "array",
"items": {
"type": "object",
"required": [
"outcome",
"point",
"price"
],
"properties": {
"point": {
"type": [
"number",
"null"
]
},
"price": {
"type": [
"number",
"null"
]
},
"outcome": {
"type": "string"
}
},
"additionalProperties": false
}
},
"bookmaker": {
"type": "string"
},
"closing_captured_at": {
"type": "string"
},
"opening_captured_at": {
"type": "string"
},
"minutes_before_start": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"label": {
"type": "string"
},
"market": {
"type": "string"
},
"credits": {
"type": "number"
},
"game_id": {
"type": "string"
},
"estimate_only": {
"type": "boolean"
},
"scheduled_start": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Market odds",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for what the market thinks of one game, not any one book's price: the average implied probability (margin in) and the fair probability (margin out) for the moneyline, each puck line and each total, with how many books each rests on. Only identical lines are combined. Each book's last pre-game prices by default (snapshot_type reads latest until the start, closing after it); opening on request. For each book's prices use get_odds. Costs 5 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| game_id * | string | Game id, e.g. 2024020001. |
| snapshot_type | string | closing (default): each book's last pre-game price so far. opening: each book's first. |
{
"name": "get_game_probabilities",
"title": "Game probabilities",
"description": "Use for what the market thinks of one game, not any one book's price: the average implied probability (margin in) and the fair probability (margin out) for the moneyline, each puck line and each total, with how many books each rests on. Only identical lines are combined. Each book's last pre-game prices by default (snapshot_type reads latest until the start, closing after it); opening on request. For each book's prices use get_odds. Costs 5 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id"
],
"properties": {
"game_id": {
"type": "string",
"description": "Game id, e.g. 2024020001."
},
"snapshot_type": {
"enum": [
"opening",
"closing"
],
"type": "string",
"description": "closing (default): each book's last pre-game price so far. opening: each book's first."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id",
"home_team",
"away_team",
"scheduled_start",
"snapshot_type",
"moneyline",
"spreads",
"totals",
"count",
"method"
],
"properties": {
"note": {
"type": "string"
},
"tool": {
"type": "string"
},
"count": {
"type": "number"
},
"method": {
"type": "string"
},
"totals": {
"type": "array",
"items": {
"type": "object",
"required": [
"line",
"books_used",
"fair_books",
"over",
"under"
],
"properties": {
"line": {
"type": "number"
},
"over": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"under": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"books_used": {
"type": "number"
},
"fair_books": {
"type": "number"
}
},
"additionalProperties": false
}
},
"credits": {
"type": "number"
},
"game_id": {
"type": "string"
},
"spreads": {
"type": "array",
"items": {
"type": "object",
"required": [
"home_line",
"books_used",
"fair_books",
"home",
"away"
],
"properties": {
"away": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"home": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"home_line": {
"type": "number"
},
"books_used": {
"type": "number"
},
"fair_books": {
"type": "number"
}
},
"additionalProperties": false
}
},
"away_team": {
"type": [
"string",
"null"
]
},
"home_team": {
"type": [
"string",
"null"
]
},
"moneyline": {
"anyOf": [
{
"type": "object",
"required": [
"books_used",
"fair_books",
"home",
"away"
],
"properties": {
"away": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"draw": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"home": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"books_used": {
"type": "number"
},
"fair_books": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"estimate_only": {
"type": "boolean"
},
"snapshot_type": {
"type": "string"
},
"scheduled_start": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Game probabilities",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for what the market thinks of the player props in one game, not any one book's price: for each player and each line, the average implied probability (margin in) and the fair probability (margin out), with how many books each rests on. Only identical lines are combined, and a yes/no market whose books post only the yes price has no fair probability. Latest pre-game prices. For each book's prices use get_player_props. Costs 10 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| market | string | One market, e.g. player_shots_on_goal. Default every market. |
| game_id * | string | Game id, e.g. 2024020001. |
| player_id | ["number","string"] | One player's id (e.g. 8478402, from search_players). Default every player. |
{
"name": "get_prop_probabilities",
"title": "Prop probabilities",
"description": "Use for what the market thinks of the player props in one game, not any one book's price: for each player and each line, the average implied probability (margin in) and the fair probability (margin out), with how many books each rests on. Only identical lines are combined, and a yes/no market whose books post only the yes price has no fair probability. Latest pre-game prices. For each book's prices use get_player_props. Costs 10 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id"
],
"properties": {
"market": {
"enum": [
"player_points",
"player_goals",
"player_assists",
"player_shots_on_goal",
"player_blocked_shots",
"player_total_saves",
"player_goal_scorer_anytime",
"player_power_play_points",
"player_goal_scorer_first"
],
"type": "string",
"description": "One market, e.g. player_shots_on_goal. Default every market."
},
"game_id": {
"type": "string",
"description": "Game id, e.g. 2024020001."
},
"player_id": {
"type": [
"number",
"string"
],
"description": "One player's id (e.g. 8478402, from search_players). Default every player."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id",
"scheduled_start",
"props",
"count",
"method"
],
"properties": {
"note": {
"type": "string"
},
"tool": {
"type": "string"
},
"count": {
"type": "number"
},
"props": {
"type": "array",
"items": {
"type": "object",
"required": [
"player_id",
"player_name",
"market",
"label",
"consensus_line",
"lines"
],
"properties": {
"label": {
"type": "string"
},
"lines": {
"type": "array",
"items": {
"type": "object",
"required": [
"line",
"books_used",
"fair_books",
"over",
"under"
],
"properties": {
"line": {
"type": [
"number",
"null"
]
},
"over": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"under": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"books_used": {
"type": "number"
},
"fair_books": {
"type": "number"
}
},
"additionalProperties": false
}
},
"market": {
"type": "string"
},
"player_id": {
"type": [
"string",
"number",
"null"
]
},
"player_name": {
"type": "string"
},
"consensus_line": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"method": {
"type": "string"
},
"credits": {
"type": "number"
},
"game_id": {
"type": "string"
},
"estimate_only": {
"type": "boolean"
},
"scheduled_start": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Prop probabilities",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use to test an idea about player props without pulling every row: how often a kind of prop went over or under against what the market implied, across every finished game we hold prices for that fits your filters. Returns the hit rate, its 95% interval, the average implied and fair probabilities, and each season on its own. For example, shots on goal overs for players whose team was the underdog at home. One result per player per game at the median closing line. It describes the past and recommends nothing. For one player game by game use get_prop_history. Costs 25 credits.
| Parameter | Type | Description |
|---|---|---|
| side | string | over (default) or under. Yes/no markets are graded on the yes price: over only. |
| team | string | The player's team, e.g. TOR. |
| market * | string | The market, e.g. player_shots_on_goal. |
| to_date | string | Last game date, YYYY-MM-DD. Default all held. |
| fair_max | number | Highest fair probability of this side to include, 0 to 1. |
| fair_min | number | Lowest fair probability of this side to include, 0 to 1. |
| line_max | number | Highest median closing line to include. |
| line_min | number | Lowest median closing line to include. |
| opponent | string | The team he played. |
| from_date | string | First game date, YYYY-MM-DD. Default all held. |
| home_away | string | Whether his team was at home. |
| player_id | ["number","string"] | One player's id (e.g. 8478402, from search_players). |
| team_role | string | Whether his team was favored, by the books' closing moneylines. |
{
"name": "get_prop_backtest",
"title": "Prop backtest",
"description": "Use to test an idea about player props without pulling every row: how often a kind of prop went over or under against what the market implied, across every finished game we hold prices for that fits your filters. Returns the hit rate, its 95% interval, the average implied and fair probabilities, and each season on its own. For example, shots on goal overs for players whose team was the underdog at home. One result per player per game at the median closing line. It describes the past and recommends nothing. For one player game by game use get_prop_history. Costs 25 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market"
],
"properties": {
"side": {
"enum": [
"over",
"under"
],
"type": "string",
"description": "over (default) or under. Yes/no markets are graded on the yes price: over only."
},
"team": {
"type": "string",
"description": "The player's team, e.g. TOR."
},
"market": {
"enum": [
"player_points",
"player_goals",
"player_assists",
"player_shots_on_goal",
"player_blocked_shots",
"player_total_saves",
"player_goal_scorer_anytime",
"player_power_play_points"
],
"type": "string",
"description": "The market, e.g. player_shots_on_goal."
},
"to_date": {
"type": "string",
"description": "Last game date, YYYY-MM-DD. Default all held."
},
"fair_max": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Highest fair probability of this side to include, 0 to 1."
},
"fair_min": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Lowest fair probability of this side to include, 0 to 1."
},
"line_max": {
"type": "number",
"description": "Highest median closing line to include."
},
"line_min": {
"type": "number",
"description": "Lowest median closing line to include."
},
"opponent": {
"type": "string",
"description": "The team he played."
},
"from_date": {
"type": "string",
"description": "First game date, YYYY-MM-DD. Default all held."
},
"home_away": {
"enum": [
"home",
"away"
],
"type": "string",
"description": "Whether his team was at home."
},
"player_id": {
"type": [
"number",
"string"
],
"description": "One player's id (e.g. 8478402, from search_players)."
},
"team_role": {
"enum": [
"favorite",
"underdog"
],
"type": "string",
"description": "Whether his team was favored, by the books' closing moneylines."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"label",
"side",
"filters",
"results",
"hits",
"misses",
"pushes",
"hit_rate",
"avg_implied_prob",
"avg_fair_prob",
"no_result",
"no_price",
"games",
"players",
"avg_books",
"avg_line",
"avg_actual",
"hit_rate_minus_implied",
"hit_rate_minus_fair",
"hit_rate_interval_95",
"market_inside_interval",
"by_season",
"method",
"caution"
],
"properties": {
"hits": {
"type": "number"
},
"note": {
"type": "string"
},
"side": {
"type": "string"
},
"tool": {
"type": "string"
},
"games": {
"type": "number"
},
"label": {
"type": "string"
},
"market": {
"type": "string"
},
"method": {
"type": "string"
},
"misses": {
"type": "number"
},
"pushes": {
"type": "number"
},
"caution": {
"type": "string"
},
"credits": {
"type": "number"
},
"filters": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"players": {
"type": "number"
},
"results": {
"type": "number"
},
"avg_line": {
"type": [
"number",
"null"
]
},
"hit_rate": {
"type": [
"number",
"null"
]
},
"no_price": {
"type": "number"
},
"avg_books": {
"type": [
"number",
"null"
]
},
"by_season": {
"type": "array",
"items": {
"type": "object",
"required": [
"season",
"results",
"hits",
"misses",
"pushes",
"hit_rate",
"avg_implied_prob",
"avg_fair_prob"
],
"properties": {
"hits": {
"type": "number"
},
"misses": {
"type": "number"
},
"pushes": {
"type": "number"
},
"season": {
"type": [
"number",
"string"
]
},
"results": {
"type": "number"
},
"hit_rate": {
"type": [
"number",
"null"
]
},
"avg_fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"no_result": {
"type": "number"
},
"avg_actual": {
"type": [
"number",
"null"
]
},
"avg_fair_prob": {
"type": [
"number",
"null"
]
},
"estimate_only": {
"type": "boolean"
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
},
"hit_rate_minus_fair": {
"type": [
"number",
"null"
]
},
"hit_rate_interval_95": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
{
"type": "null"
}
]
},
"hit_rate_minus_implied": {
"type": [
"number",
"null"
]
},
"market_inside_interval": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Prop backtest",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for play-by-play events: goals, shots, misses, blocks, faceoffs, hits, giveaways, takeaways, penalties, with rink coordinates, strength state (5v5, 5v4), zone, and the players involved. Filter by game, season, team, player (any role), event type, strength, zone, or period. Requires at least one of game_id, season or player_id. Paginate with offset. Costs 10 credits.
| Parameter | Type | Description |
|---|---|---|
| team | string | Team abbreviation that owns the event (e.g. BUF) |
| type | string | Event type |
| zone | string | Zone: O offensive, N neutral, D defensive |
| limit | integer | Max events (default 200) |
| league | string | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl. |
| offset | integer | Pagination offset |
| period | integer | Period number (4+ is overtime) |
| season | string | Season ID, 8-digit (e.g. 20242025). |
| game_id | string | NHL game ID (e.g. 2025020887) |
| strength | string | Skater strength from the event owner's view, e.g. 5v5, 5v4, 4v5 |
| player_id | integer | NHL player ID; matches the player in any role on the event |
| shot_attempts_only | boolean | Only goals, shots on goal, missed shots and blocked shots (Corsi events) |
{
"name": "get_plays",
"title": "Plays",
"description": "Use for play-by-play events: goals, shots, misses, blocks, faceoffs, hits, giveaways, takeaways, penalties, with rink coordinates, strength state (5v5, 5v4), zone, and the players involved. Filter by game, season, team, player (any role), event type, strength, zone, or period. Requires at least one of game_id, season or player_id. Paginate with offset. Costs 10 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"team": {
"type": "string",
"description": "Team abbreviation that owns the event (e.g. BUF)"
},
"type": {
"enum": [
"goal",
"shot-on-goal",
"missed-shot",
"blocked-shot",
"faceoff",
"hit",
"giveaway",
"takeaway",
"penalty",
"delayed-penalty",
"stoppage",
"period-start",
"period-end",
"game-end",
"shootout-complete",
"failed-shot-attempt"
],
"type": "string",
"description": "Event type"
},
"zone": {
"enum": [
"O",
"N",
"D"
],
"type": "string",
"description": "Zone: O offensive, N neutral, D defensive"
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Max events (default 200)"
},
"league": {
"enum": [
"nhl",
"pwhl",
"ohl",
"whl",
"qmjhl",
"echl",
"ahl",
"ushl"
],
"type": "string",
"description": "League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Pagination offset"
},
"period": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Period number (4+ is overtime)"
},
"season": {
"type": "string",
"description": "Season ID, 8-digit (e.g. 20242025)."
},
"game_id": {
"type": "string",
"description": "NHL game ID (e.g. 2025020887)"
},
"strength": {
"type": "string",
"description": "Skater strength from the event owner's view, e.g. 5v5, 5v4, 4v5"
},
"player_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "NHL player ID; matches the player in any role on the event"
},
"shot_attempts_only": {
"type": "boolean",
"description": "Only goals, shots on goal, missed shots and blocked shots (Corsi events)"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"plays",
"summary",
"count",
"next_offset"
],
"properties": {
"count": {
"type": "number"
},
"plays": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"summary": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Plays",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when you want shot locations rather than a list of events: every shot attempt with rink coordinates, shot type, strength, shooter and goalie. Filter by game, or by season plus a team or player. Paginated: follow next_offset, since a season runs past one page and pages are chronological. Costs 10 credits.
| Parameter | Type | Description |
|---|---|---|
| team | string | Team abbreviation; use with season |
| limit | integer | Max shots per page (default 1000) |
| league | string | League. Defaults to nhl. One of: nhl, pwhl, ohl, qmjhl, echl, ahl. |
| offset | integer | Pagination offset; follow next_offset for a full season |
| season | string | Season ID, 8-digit (e.g. 20242025); use with team |
| game_id | string | NHL game ID |
| strength | string | Strength filter, e.g. 5v5 |
| game_type | string | Which games to include: regular (default for a season) or all (default for one game). Shootout attempts are never included. |
| player_id | integer | NHL player ID of the shooter |
{
"name": "get_shot_map",
"title": "Shot map",
"description": "Use when you want shot locations rather than a list of events: every shot attempt with rink coordinates, shot type, strength, shooter and goalie. Filter by game, or by season plus a team or player. Paginated: follow next_offset, since a season runs past one page and pages are chronological. Costs 10 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"team": {
"type": "string",
"description": "Team abbreviation; use with season"
},
"limit": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Max shots per page (default 1000)"
},
"league": {
"enum": [
"nhl",
"pwhl",
"ohl",
"qmjhl",
"echl",
"ahl"
],
"type": "string",
"description": "League. Defaults to nhl. One of: nhl, pwhl, ohl, qmjhl, echl, ahl."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Pagination offset; follow next_offset for a full season"
},
"season": {
"type": "string",
"description": "Season ID, 8-digit (e.g. 20242025); use with team"
},
"game_id": {
"type": "string",
"description": "NHL game ID"
},
"strength": {
"type": "string",
"description": "Strength filter, e.g. 5v5"
},
"game_type": {
"enum": [
"regular",
"playoff",
"preseason",
"all"
],
"type": "string",
"description": "Which games to include: regular (default for a season) or all (default for one game). Shootout attempts are never included."
},
"player_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "NHL player ID of the shooter"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"shots",
"summary",
"count",
"next_offset"
],
"properties": {
"count": {
"type": "number"
},
"shots": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"summary": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Shot map",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for who was on the ice and when: every player's shifts in one NHL game, each with period, start and end (period clock and seconds from the opening faceoff) and duration, plus the official boxscore time on ice and plus/minus. Filter to one team or player. NHL games from 2010-11 on. Costs 10 credits.
| Parameter | Type | Description |
|---|---|---|
| team | string | Only this team's players, by abbreviation (e.g. WSH) |
| game_id * | string | NHL game ID, 10 digits (e.g. 2026020084) |
| player_id | integer | Only this player, by NHL player ID |
{
"name": "get_shifts",
"title": "Shifts",
"description": "Use for who was on the ice and when: every player's shifts in one NHL game, each with period, start and end (period clock and seconds from the opening faceoff) and duration, plus the official boxscore time on ice and plus/minus. Filter to one team or player. NHL games from 2010-11 on. Costs 10 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id"
],
"properties": {
"team": {
"type": "string",
"description": "Only this team's players, by abbreviation (e.g. WSH)"
},
"game_id": {
"type": "string",
"description": "NHL game ID, 10 digits (e.g. 2026020084)"
},
"player_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Only this player, by NHL player ID"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id",
"players",
"count"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"source": {
"type": [
"string",
"null"
]
},
"game_id": {
"type": "string"
},
"players": {
"type": "array",
"items": {
"type": "object",
"required": [
"player_id",
"name",
"position",
"team",
"home_away",
"goalie",
"shift_count",
"shift_seconds",
"official_toi_seconds",
"plus_minus",
"shifts"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"team": {
"type": "string"
},
"goalie": {
"type": "boolean"
},
"shifts": {
"type": "array",
"items": {
"type": "object",
"required": [
"period",
"start",
"end",
"start_seconds",
"end_seconds",
"duration_seconds"
],
"properties": {
"end": {
"type": "string"
},
"start": {
"type": "string"
},
"period": {
"type": "number"
},
"end_seconds": {
"type": "number"
},
"start_seconds": {
"type": "number"
},
"duration_seconds": {
"type": "number"
}
},
"additionalProperties": false
}
},
"position": {
"type": [
"string",
"null"
]
},
"home_away": {
"enum": [
"home",
"away"
],
"type": "string"
},
"player_id": {
"type": "number"
},
"plus_minus": {
"type": [
"number",
"null"
]
},
"shift_count": {
"type": "number"
},
"shift_seconds": {
"type": "number"
},
"official_toi_seconds": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"away_team": {
"type": "string"
},
"game_date": {
"type": [
"string",
"null"
]
},
"home_team": {
"type": "string"
},
"dropped_shifts": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Shifts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for exact time at each strength: the seconds each team spent at 5v5, 5v4, 4v5, 4v4, 6v5 with the goalie pulled and every other on-ice state in an NHL game, split into regulation and overtime, from the shift charts. Also even / power-play / shorthanded totals, goalie-pulled seconds, period lengths and a completeness check against the play-by-play. include_players adds each skater's time by strength. One game by game_id (10 credits), or every game on a date (10 credits per game). NHL games from 2010-11 on.
| Parameter | Type | Description |
|---|---|---|
| date | string | Every game played on this date, YYYY-MM-DD (instead of game_id) |
| game_id | string | NHL game ID, 10 digits (e.g. 2026020084) |
| include_players | boolean | Add each skater's seconds by strength (default false) |
{
"name": "get_situation_time",
"title": "Situation time",
"description": "Use for exact time at each strength: the seconds each team spent at 5v5, 5v4, 4v5, 4v4, 6v5 with the goalie pulled and every other on-ice state in an NHL game, split into regulation and overtime, from the shift charts. Also even / power-play / shorthanded totals, goalie-pulled seconds, period lengths and a completeness check against the play-by-play. include_players adds each skater's time by strength. One game by game_id (10 credits), or every game on a date (10 credits per game). NHL games from 2010-11 on.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"date": {
"type": "string",
"description": "Every game played on this date, YYYY-MM-DD (instead of game_id)"
},
"game_id": {
"type": "string",
"description": "NHL game ID, 10 digits (e.g. 2026020084)"
},
"include_players": {
"type": "boolean",
"description": "Add each skater's seconds by strength (default false)"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"games",
"count"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"games": {
"type": "array",
"items": {
"type": "object",
"required": [
"game_id",
"game_date",
"game_type",
"home_team",
"away_team",
"teams",
"periods",
"completeness"
],
"properties": {
"teams": {
"type": "array",
"items": {
"type": "object",
"required": [
"team",
"home_away",
"states",
"even_seconds",
"power_play_seconds",
"shorthanded_seconds",
"goalie_pulled_seconds",
"opponent_goalie_pulled_seconds"
],
"properties": {
"team": {
"type": "string"
},
"states": {
"type": "array",
"items": {
"type": "object",
"required": [
"strength",
"skaters",
"opponent_skaters",
"goalie_in",
"opponent_goalie_in",
"regulation_seconds",
"overtime_seconds"
],
"properties": {
"skaters": {
"type": "number"
},
"strength": {
"type": "string"
},
"goalie_in": {
"type": "boolean"
},
"opponent_skaters": {
"type": "number"
},
"overtime_seconds": {
"type": "number"
},
"opponent_goalie_in": {
"type": "boolean"
},
"regulation_seconds": {
"type": "number"
}
},
"additionalProperties": false
}
},
"home_away": {
"enum": [
"home",
"away"
],
"type": "string"
},
"even_seconds": {
"type": "number"
},
"power_play_seconds": {
"type": "number"
},
"shorthanded_seconds": {
"type": "number"
},
"goalie_pulled_seconds": {
"type": "number"
},
"opponent_goalie_pulled_seconds": {
"type": "number"
}
},
"additionalProperties": false
}
},
"game_id": {
"type": "string"
},
"periods": {
"type": "array",
"items": {
"type": "object",
"required": [
"period",
"length_seconds",
"unresolved_seconds"
],
"properties": {
"period": {
"type": "number"
},
"length_seconds": {
"type": "number"
},
"unresolved_seconds": {
"type": "number"
}
},
"additionalProperties": false
}
},
"players": {
"type": "array",
"items": {
"type": "object",
"required": [
"player_id",
"name",
"team",
"toi_seconds"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"team": {
"type": "string"
},
"player_id": {
"type": "number"
},
"by_strength": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"toi_seconds": {
"type": "number"
},
"even_seconds": {
"type": "number"
},
"power_play_seconds": {
"type": "number"
},
"unresolved_seconds": {
"type": "number"
},
"shorthanded_seconds": {
"type": "number"
}
},
"additionalProperties": false
}
},
"away_team": {
"type": "string"
},
"game_date": {
"type": [
"string",
"null"
]
},
"game_type": {
"type": "string"
},
"home_team": {
"type": "string"
},
"completeness": {
"type": "object",
"required": [
"unresolved_seconds",
"dropped_shifts",
"source",
"regulation_periods_full",
"events_compared",
"events_agreeing",
"complete"
],
"properties": {
"source": {
"type": [
"string",
"null"
]
},
"complete": {
"type": "boolean"
},
"dropped_shifts": {
"type": "number"
},
"events_agreeing": {
"type": "number"
},
"events_compared": {
"type": "number"
},
"unresolved_seconds": {
"type": "number"
},
"regulation_periods_full": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"credits_per_game": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Situation time",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for the model's win probability for each NHL game on the current slate: home and away win probability, the A/B/C confidence grade, start time, plus the model version and when the slate was generated. Takes no arguments (current slate only). Probabilities are the model's own; no odds, prices or goalie and injury notes are included. The accuracy note states the backtest figure and that it is not a live record. An empty slate costs nothing, and a note says why (not generated yet, or no games today); so does a failed call. Costs 5 credits.
No parameters.
{
"name": "get_predictions",
"title": "Predictions",
"description": "Use for the model's win probability for each NHL game on the current slate: home and away win probability, the A/B/C confidence grade, start time, plus the model version and when the slate was generated. Takes no arguments (current slate only). Probabilities are the model's own; no odds, prices or goalie and injury notes are included. The accuracy note states the backtest figure and that it is not a live record. An empty slate costs nothing, and a note says why (not generated yet, or no games today); so does a failed call. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"generatedAt",
"modelVersion",
"accuracyNote",
"games",
"count"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"games": {
"type": "array",
"items": {
"type": "object",
"required": [
"gameId",
"gameDate",
"startTimeUtc",
"homeTeam",
"awayTeam",
"homeWinProb",
"awayWinProb",
"grade"
],
"properties": {
"grade": {
"type": "string"
},
"gameId": {
"type": "string"
},
"awayTeam": {
"type": "string"
},
"gameDate": {
"type": "string"
},
"homeTeam": {
"type": "string"
},
"awayWinProb": {
"type": "number"
},
"homeWinProb": {
"type": "number"
},
"startTimeUtc": {
"type": "string"
}
},
"additionalProperties": false
}
},
"generatedAt": {
"type": "string"
},
"accuracyNote": {
"type": "string"
},
"modelVersion": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Predictions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Paid plans only (not available on the free plan). Use for the model's projected stat lines for tonight's NHL players: for each game, each skater's projected goals, assists, points and shots with a low-to-high range, and each goalie's projected saves. Skaters also carry over probabilities at the usual half-point lines (goals 0.5 and 1.5, assists 0.5 and 1.5, points 0.5 to 2.5, shots 1.5 to 5.5): goals use the model's own goal distribution, the others are Poisson on the projected rate. Optional team (either side of the game) and player (name fragment) filters. Tonight's slate only; no date argument. Numbers only: no odds, prices or injury notes. An empty slate costs nothing; so does a failed call. Costs 25 credits.
| Parameter | Type | Description |
|---|---|---|
| team | string | Team abbreviation, e.g. COL. Keeps the games that team plays in, home or away. |
| player | string | Part of a player's name, e.g. makar. Accents are ignored. Keeps only matching players. |
{
"name": "get_prop_projections",
"title": "Prop projections",
"description": "Paid plans only (not available on the free plan). Use for the model's projected stat lines for tonight's NHL players: for each game, each skater's projected goals, assists, points and shots with a low-to-high range, and each goalie's projected saves. Skaters also carry over probabilities at the usual half-point lines (goals 0.5 and 1.5, assists 0.5 and 1.5, points 0.5 to 2.5, shots 1.5 to 5.5): goals use the model's own goal distribution, the others are Poisson on the projected rate. Optional team (either side of the game) and player (name fragment) filters. Tonight's slate only; no date argument. Numbers only: no odds, prices or injury notes. An empty slate costs nothing; so does a failed call. Costs 25 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"team": {
"type": "string",
"pattern": "^[A-Za-z]{2,4}$",
"description": "Team abbreviation, e.g. COL. Keeps the games that team plays in, home or away."
},
"player": {
"type": "string",
"maxLength": 64,
"minLength": 2,
"description": "Part of a player's name, e.g. makar. Accents are ignored. Keeps only matching players."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"generatedAt",
"method",
"games",
"count"
],
"properties": {
"count": {
"type": "number"
},
"games": {
"type": "array",
"items": {
"type": "object",
"required": [
"gameId",
"gameDate",
"startTimeUtc",
"homeTeam",
"awayTeam",
"skaters",
"goalies"
],
"properties": {
"gameId": {
"type": "string"
},
"goalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"playerId",
"name",
"team",
"saves"
],
"properties": {
"name": {
"type": "string"
},
"team": {
"type": "string"
},
"saves": {
"anyOf": [
{
"type": "object",
"required": [
"projected",
"low",
"high"
],
"properties": {
"low": {
"type": "number"
},
"high": {
"type": "number"
},
"projected": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"playerId": {
"type": "number"
}
},
"additionalProperties": false
}
},
"skaters": {
"type": "array",
"items": {
"type": "object",
"required": [
"playerId",
"name",
"team",
"position",
"goals",
"assists",
"points",
"shots"
],
"properties": {
"name": {
"type": "string"
},
"team": {
"type": "string"
},
"goals": {
"anyOf": [
{
"type": "object",
"required": [
"projected",
"low",
"high",
"overProbs"
],
"properties": {
"low": {
"type": "number"
},
"high": {
"type": "number"
},
"overProbs": {
"type": "array",
"items": {
"type": "object",
"required": [
"line",
"overProb"
],
"properties": {
"line": {
"type": "number"
},
"overProb": {
"type": "number"
}
},
"additionalProperties": false
}
},
"projected": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"shots": {
"anyOf": [
{
"type": "object",
"required": [
"projected",
"low",
"high",
"overProbs"
],
"properties": {
"low": {
"type": "number"
},
"high": {
"type": "number"
},
"overProbs": {
"type": "array",
"items": {
"type": "object",
"required": [
"line",
"overProb"
],
"properties": {
"line": {
"type": "number"
},
"overProb": {
"type": "number"
}
},
"additionalProperties": false
}
},
"projected": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"points": {
"anyOf": [
{
"type": "object",
"required": [
"projected",
"low",
"high",
"overProbs"
],
"properties": {
"low": {
"type": "number"
},
"high": {
"type": "number"
},
"overProbs": {
"type": "array",
"items": {
"type": "object",
"required": [
"line",
"overProb"
],
"properties": {
"line": {
"type": "number"
},
"overProb": {
"type": "number"
}
},
"additionalProperties": false
}
},
"projected": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"assists": {
"anyOf": [
{
"type": "object",
"required": [
"projected",
"low",
"high",
"overProbs"
],
"properties": {
"low": {
"type": "number"
},
"high": {
"type": "number"
},
"overProbs": {
"type": "array",
"items": {
"type": "object",
"required": [
"line",
"overProb"
],
"properties": {
"line": {
"type": "number"
},
"overProb": {
"type": "number"
}
},
"additionalProperties": false
}
},
"projected": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"playerId": {
"type": "number"
},
"position": {
"type": "string"
}
},
"additionalProperties": false
}
},
"awayTeam": {
"type": "string"
},
"gameDate": {
"type": "string"
},
"homeTeam": {
"type": "string"
},
"startTimeUtc": {
"type": "string"
}
},
"additionalProperties": false
}
},
"method": {
"type": "string"
},
"generatedAt": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Prop projections",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for alternate puck lines and totals by sportsbook: every point on each book's ladder with its price (e.g. -2.5 at +250, over 7.5 at +160), for one game. Held for NHL games from the 2023-24 season on, from up to five books (Pinnacle, Bovada, BetMGM and DraftKings, FanDuel on some). Games before Nov 12 2026 were captured once shortly before puck drop, so their opening and closing ladders are the same; from Nov 12 2026 upcoming games are captured up to three times a day before the start. Games not yet priced have none. Returns each book's closing ladder by default (its last before the start) or its opening one. side is home or away for puck lines (point is that side's puck line) and over or under for totals. For the main line use get_odds. 10 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl. |
| market | string | One market (default both). |
| game_id * | string | Game id, e.g. 2025020150 (from get_games or get_schedule). |
| bookmaker | string | One bookmaker key, e.g. draftkings, fanduel. |
| snapshot_type | string | Closing (default) or opening ladder. |
{
"name": "get_alt_lines",
"title": "Alt lines",
"description": "Use for alternate puck lines and totals by sportsbook: every point on each book's ladder with its price (e.g. -2.5 at +250, over 7.5 at +160), for one game. Held for NHL games from the 2023-24 season on, from up to five books (Pinnacle, Bovada, BetMGM and DraftKings, FanDuel on some). Games before Nov 12 2026 were captured once shortly before puck drop, so their opening and closing ladders are the same; from Nov 12 2026 upcoming games are captured up to three times a day before the start. Games not yet priced have none. Returns each book's closing ladder by default (its last before the start) or its opening one. side is home or away for puck lines (point is that side's puck line) and over or under for totals. For the main line use get_odds. 10 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id"
],
"properties": {
"league": {
"enum": [
"nhl",
"pwhl",
"ohl",
"whl",
"qmjhl",
"echl",
"ahl",
"ushl"
],
"type": "string",
"description": "League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl."
},
"market": {
"enum": [
"alternate_spreads",
"alternate_totals"
],
"type": "string",
"description": "One market (default both)."
},
"game_id": {
"type": "string",
"description": "Game id, e.g. 2025020150 (from get_games or get_schedule)."
},
"bookmaker": {
"type": "string",
"description": "One bookmaker key, e.g. draftkings, fanduel."
},
"snapshot_type": {
"enum": [
"opening",
"closing"
],
"type": "string",
"description": "Closing (default) or opening ladder."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id",
"league",
"snapshot_type",
"lines",
"count"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"lines": {
"type": "array",
"items": {
"type": "object",
"required": [
"bookmaker",
"market",
"side",
"point",
"price",
"captured_at",
"source"
],
"properties": {
"side": {
"type": "string"
},
"point": {
"type": "number"
},
"price": {
"type": "number"
},
"market": {
"enum": [
"alternate_spreads",
"alternate_totals"
],
"type": "string"
},
"source": {
"type": "string"
},
"bookmaker": {
"type": "string"
},
"captured_at": {
"type": "string"
}
},
"additionalProperties": false
}
},
"league": {
"type": "string"
},
"game_id": {
"type": "string"
},
"snapshot_type": {
"enum": [
"opening",
"closing"
],
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Alt lines",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}PuckAPI -- 28 hockey data tools for the NHL, plus the PWHL, OHL, WHL, QMJHL, ECHL, AHL and USHL. Stats, odds, and everything between. ## First Steps 1. Call list_teams (1 cr) to see all 32 NHL teams and their abbreviations. 2. For upcoming games, use get_schedule (2 cr). For past games, use get_games (5 cr). ## Tool Selection ### Looking up a team? - Need all teams or check an abbreviation? -> list_teams (1 cr) - Current standings with records? -> get_standings (2 cr) - Detailed stats for one team? -> get_team_stats (5 cr) - Compare two teams head-to-head? -> get_head_to_head (10 cr) ### Looking up games? - Upcoming schedule? -> get_schedule (2 cr) - Past games with filters? -> get_games (5 cr) - The model's win probability for each game on today's slate? -> get_predictions (5 cr) - Full detail for one game with odds and starting goalies? -> get_game_detail (10 cr) ### Looking up players? - Find a player by name? -> search_players (2 cr) - Bio and team context for one player? -> get_player_stats (5 cr) - Goalie leaderboard (save%, GAA, GSAX, wins)? -> get_goalie_stats (5 cr) - Skater leaderboard (points, goals, assists, +/-, shots)? -> get_skater_season_stats (5 cr) - Game-by-game stat lines for one player, not a season total? -> get_player_game_log (5 cr) - The model's projected goals, assists, points, shots and saves for tonight's players, with over probabilities? -> get_prop_projections (25 cr, paid plans only; a free-plan call is refused and charged nothing) ### Play-by-play? - Events for a game, player or season? -> get_plays (10 cr) - Shot locations to plot or model? -> get_shot_map (10 cr) - Who was on the ice, shift by shift? -> get_shifts (10 cr) - Exact 5v5 / power-play / shorthanded time per team? -> get_situation_time (10 cr per game) ### Betting odds? - Odds for a specific game? -> get_odds (10 cr) - How lines moved over time? -> get_line_movement (25 cr, most expensive) - Player prop lines (points, goals, assists, shots, saves, anytime scorer) by sportsbook? -> get_player_props (10 cr) - How a player did against his prop line, game by game? -> get_prop_history (10 cr) - How a player's prop line moved before a game? -> get_prop_movement (10 cr) - Period and regulation-result lines (1st period result, puck line and totals; period totals) as history, opening and closing by sportsbook? -> get_market_odds (10 cr) - Alternate puck lines and totals, every point on each book's ladder (from 2023-24)? -> get_alt_lines (10 cr) - What the market thinks of a game, one number across books: average implied and fair (no-margin) probability? -> get_game_probabilities (5 cr) - The same for a game's player props? -> get_prop_probabilities (10 cr) - How often a kind of prop hit against the market ("shots on goal overs for road underdogs"), without pulling every row? -> get_prop_backtest (25 cr). Report its sample size, its interval and by_season with the answer, and do not present a past result as a pick ## Common Workflows Team overview: list_teams -> get_team_stats -> get_standings (8 cr) Game preview: get_schedule -> get_game_detail -> get_odds (22 cr) Player lookup: search_players -> get_player_stats (7 cr) Matchup analysis: get_head_to_head -> get_odds (20 cr) Goalie comparison: get_goalie_stats (5 cr) Shot analysis: search_players -> get_shot_map (12 cr) Game breakdown: get_game_detail -> get_plays (20 cr) ## Credit Costs | Credits | Tools | |---------|-------| | 1 | list_teams | | 2 | get_standings, get_schedule, search_players | | 5 | get_games, get_game_probabilities, get_predictions, get_team_stats, get_player_stats, get_goalie_stats, get_skater_season_stats, get_player_game_log | | 10 | get_odds, get_game_detail, get_head_to_head, get_plays, get_shot_map, get_shifts, get_situation_time, get_player_props, get_prop_history, get_prop_movement, get_market_odds, get_alt_lines, get_prop_probabilities | | 25 | get_line_movement, get_prop_backtest, get_prop_projections (paid plans only) | ## Data Coverage - Teams: A
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.