EndzoneAPI is an MCP server published by io.github.noahowsh, hosted at mcp.endzoneapi.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 26 tools, including list_teams, get_standings, get_team_stats, get_games, get_schedule.
NFL player props by sportsbook since 2023, plus play-by-play with EPA, stats and odds. REST and MCP.
12 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 you need team codes, or all 32 current teams with conference, division, colours, and logo URLs. Team codes are standard abbreviations (LA for the Rams, WAS for Washington). Cheapest tool at 1 credit.
| Parameter | Type | Description |
|---|---|---|
| division | string | Filter by division, e.g. 'AFC East' or 'NFC West' |
| conference | string | Filter by conference |
{
"name": "list_teams",
"title": "List teams",
"description": "Use when you need team codes, or all 32 current teams with conference, division, colours, and logo URLs. Team codes are standard abbreviations (LA for the Rams, WAS for Washington). Cheapest tool at 1 credit.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"division": {
"type": "string",
"description": "Filter by division, e.g. 'AFC East' or 'NFC West'"
},
"conference": {
"enum": [
"AFC",
"NFC"
],
"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"
],
"properties": {
"logo": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"abbrev": {
"type": "string"
},
"division": {
"type": [
"string",
"null"
]
},
"conference": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "List teams",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
Use for regular-season standings and playoff seeding: record, win%, points for/against, home/away/division/conference records, streak, division rank, and conference seed. Ranks apply the real NFL tiebreaking procedure and report which step decided each one. Computed from final scores. Defaults to the current season. Costs 2 credits.
| Parameter | Type | Description |
|---|---|---|
| season | ["string","number"] | Season year the regular season starts (e.g. 2025). Defaults to current. |
| division | string | Filter by division, e.g. 'NFC North' |
| conference | string | Filter by conference |
{
"name": "get_standings",
"title": "Standings",
"description": "Use for regular-season standings and playoff seeding: record, win%, points for/against, home/away/division/conference records, streak, division rank, and conference seed. Ranks apply the real NFL tiebreaking procedure and report which step decided each one. Computed from final scores. Defaults to the current season. Costs 2 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"season": {
"type": [
"string",
"number"
],
"description": "Season year the regular season starts (e.g. 2025). Defaults to current."
},
"division": {
"type": "string",
"description": "Filter by division, e.g. 'NFC North'"
},
"conference": {
"enum": [
"AFC",
"NFC"
],
"type": "string",
"description": "Filter by conference"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"season",
"standings",
"count"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"season": {
"type": "number"
},
"standings": {
"type": "array",
"items": {
"type": "object",
"required": [
"team",
"wins",
"losses",
"ties"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"team": {
"type": "string"
},
"ties": {
"type": "number"
},
"wins": {
"type": "number"
},
"losses": {
"type": "number"
},
"streak": {
"type": [
"string",
"null"
]
},
"win_pct": {
"type": [
"number",
"null"
]
},
"division": {
"type": [
"string",
"null"
]
},
"conference": {
"type": [
"string",
"null"
]
},
"point_diff": {
"type": [
"number",
"null"
]
},
"points_for": {
"type": [
"number",
"null"
]
},
"division_rank": {
"type": [
"number",
"null"
]
},
"points_against": {
"type": [
"number",
"null"
]
},
"conference_rank": {
"type": [
"number",
"null"
]
},
"division_tiebreaker": {
"type": [
"string",
"null"
]
},
"conference_tiebreaker": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Standings",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for one team's season: totals (passing, rushing, receiving, defense, kicking, penalties), EPA per play, yards per attempt/carry, the standings row, and every weekly stat line. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| team * | string | Team code (e.g. KC, BUF, PHI) |
| season | ["string","number"] | Season year (e.g. 2025). Defaults to current. |
| season_type | string | Regular season (default) or postseason |
{
"name": "get_team_stats",
"title": "Team stats",
"description": "Use for one team's season: totals (passing, rushing, receiving, defense, kicking, penalties), EPA per play, yards per attempt/carry, the standings row, and every weekly stat line. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"team"
],
"properties": {
"team": {
"type": "string",
"description": "Team code (e.g. KC, BUF, PHI)"
},
"season": {
"type": [
"string",
"number"
],
"description": "Season year (e.g. 2025). Defaults to current."
},
"season_type": {
"enum": [
"REG",
"POST"
],
"type": "string",
"description": "Regular season (default) or postseason"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"team",
"season",
"season_type",
"record",
"totals",
"weeks",
"count"
],
"properties": {
"team": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"count": {
"type": "number"
},
"weeks": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"record": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"season": {
"type": "number"
},
"totals": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"season_type": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Team stats",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when querying past or future games with filters: season, week, team, date range, game type, status. Returns scores, kickoff (UTC), venue, rest days, starting QBs, coaches, referee, and the consensus closing spread, total, and moneylines. For upcoming-only games prefer get_schedule (2 cr). Costs 5 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| team | string | Team code (home or away) |
| week | integer | Week number (1-18 regular season; 19+ postseason) |
| limit | integer | Max results (default 100) |
| season | ["string","number"] | Season year (e.g. 2025) |
| status | string | Game status |
| date_to | string | End date YYYY-MM-DD |
| date_from | string | Start date YYYY-MM-DD |
| game_type | string | REG, WC, DIV, CON, SB, or POST for any playoff game |
{
"name": "get_games",
"title": "Games",
"description": "Use when querying past or future games with filters: season, week, team, date range, game type, status. Returns scores, kickoff (UTC), venue, rest days, starting QBs, coaches, referee, and the consensus closing spread, total, and moneylines. For upcoming-only games prefer get_schedule (2 cr). 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#",
"properties": {
"team": {
"type": "string",
"description": "Team code (home or away)"
},
"week": {
"type": "integer",
"maximum": 22,
"minimum": 1,
"description": "Week number (1-18 regular season; 19+ postseason)"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results (default 100)"
},
"season": {
"type": [
"string",
"number"
],
"description": "Season year (e.g. 2025)"
},
"status": {
"enum": [
"FUT",
"LIVE",
"FINAL"
],
"type": "string",
"description": "Game status"
},
"date_to": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"date_from": {
"type": "string",
"description": "Start date YYYY-MM-DD"
},
"game_type": {
"enum": [
"REG",
"WC",
"DIV",
"CON",
"SB",
"POST"
],
"type": "string",
"description": "REG, WC, DIV, CON, SB, or POST for any playoff game"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"games",
"count",
"filters"
],
"properties": {
"count": {
"type": "number"
},
"games": {
"type": "array",
"items": {
"type": "object",
"required": [
"game_id",
"season",
"week",
"game_type",
"home_team",
"away_team",
"home_score",
"away_score",
"status",
"kickoff"
],
"properties": {
"roof": {
"type": [
"string",
"null"
]
},
"week": {
"type": "number"
},
"season": {
"type": "number"
},
"status": {
"type": "string"
},
"game_id": {
"type": "string"
},
"gameday": {
"type": [
"string",
"null"
]
},
"kickoff": {
"type": [
"string",
"null"
]
},
"stadium": {
"type": [
"string",
"null"
]
},
"surface": {
"type": [
"string",
"null"
]
},
"away_team": {
"type": "string"
},
"game_type": {
"type": "string"
},
"home_team": {
"type": "string"
},
"away_score": {
"type": [
"number",
"null"
]
},
"home_score": {
"type": [
"number",
"null"
]
},
"total_line": {
"type": [
"number",
"null"
]
},
"spread_line": {
"type": [
"number",
"null"
]
},
"away_qb_name": {
"type": [
"string",
"null"
]
},
"home_qb_name": {
"type": [
"string",
"null"
]
},
"away_moneyline": {
"type": [
"number",
"null"
]
},
"home_moneyline": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
}
},
"filters": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Games",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use to see what is coming up: unplayed games in the next N days (default 7), or a specific week of the current season. Includes consensus lines where posted. Costs 2 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Days ahead to look when week is not set (default 7) |
| team | string | Team code to filter |
| week | integer | A specific week of the current season (returns all games that week, played or not) |
{
"name": "get_schedule",
"title": "Schedule",
"description": "Use to see what is coming up: unplayed games in the next N days (default 7), or a specific week of the current season. Includes consensus lines where posted. Costs 2 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"days": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Days ahead to look when week is not set (default 7)"
},
"team": {
"type": "string",
"description": "Team code to filter"
},
"week": {
"type": "integer",
"maximum": 22,
"minimum": 1,
"description": "A specific week of the current season (returns all games that week, played or not)"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"season",
"week",
"days",
"upcoming_games",
"count"
],
"properties": {
"days": {
"type": [
"number",
"null"
]
},
"week": {
"type": [
"number",
"null"
]
},
"count": {
"type": "number"
},
"season": {
"type": "number"
},
"upcoming_games": {
"type": "array",
"items": {
"type": "object",
"required": [
"game_id",
"season",
"week",
"game_type",
"home_team",
"away_team",
"home_score",
"away_score",
"status",
"kickoff"
],
"properties": {
"roof": {
"type": [
"string",
"null"
]
},
"week": {
"type": "number"
},
"season": {
"type": "number"
},
"status": {
"type": "string"
},
"game_id": {
"type": "string"
},
"gameday": {
"type": [
"string",
"null"
]
},
"kickoff": {
"type": [
"string",
"null"
]
},
"stadium": {
"type": [
"string",
"null"
]
},
"surface": {
"type": [
"string",
"null"
]
},
"away_team": {
"type": "string"
},
"game_type": {
"type": "string"
},
"home_team": {
"type": "string"
},
"away_score": {
"type": [
"number",
"null"
]
},
"home_score": {
"type": [
"number",
"null"
]
},
"total_line": {
"type": [
"number",
"null"
]
},
"spread_line": {
"type": [
"number",
"null"
]
},
"away_qb_name": {
"type": [
"string",
"null"
]
},
"home_qb_name": {
"type": [
"string",
"null"
]
},
"away_moneyline": {
"type": [
"number",
"null"
]
},
"home_moneyline": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Schedule",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when you need everything about one game: both teams, full team box-score stats (EPA, success, drives), consensus closing line, per-bookmaker opening/closing/latest odds, weather, surface, and officials. Requires a game id from get_games or get_schedule. Costs 10 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| game_id * | string | Game id, e.g. 2025_01_KC_BUF |
{
"name": "get_game_detail",
"title": "Game detail",
"description": "Use when you need everything about one game: both teams, full team box-score stats (EPA, success, drives), consensus closing line, per-bookmaker opening/closing/latest odds, weather, surface, and officials. Requires a game id from get_games or get_schedule. 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": {
"game_id": {
"type": "string",
"description": "Game id, e.g. 2025_01_KC_BUF"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game",
"home_team",
"away_team",
"consensus_closing",
"team_stats",
"odds",
"officials"
],
"properties": {
"game": {
"type": "object",
"required": [
"game_id",
"season",
"week",
"game_type",
"home_team",
"away_team",
"home_score",
"away_score",
"status",
"kickoff"
],
"properties": {
"roof": {
"type": [
"string",
"null"
]
},
"week": {
"type": "number"
},
"season": {
"type": "number"
},
"status": {
"type": "string"
},
"game_id": {
"type": "string"
},
"gameday": {
"type": [
"string",
"null"
]
},
"kickoff": {
"type": [
"string",
"null"
]
},
"stadium": {
"type": [
"string",
"null"
]
},
"surface": {
"type": [
"string",
"null"
]
},
"away_team": {
"type": "string"
},
"game_type": {
"type": "string"
},
"home_team": {
"type": "string"
},
"away_score": {
"type": [
"number",
"null"
]
},
"home_score": {
"type": [
"number",
"null"
]
},
"total_line": {
"type": [
"number",
"null"
]
},
"spread_line": {
"type": [
"number",
"null"
]
},
"away_qb_name": {
"type": [
"string",
"null"
]
},
"home_qb_name": {
"type": [
"string",
"null"
]
},
"away_moneyline": {
"type": [
"number",
"null"
]
},
"home_moneyline": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
},
"odds": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"away_team": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"home_team": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"officials": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"team_stats": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"consensus_closing": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Game detail",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use to compare two teams' history: recent meetings with scores, the win/loss record between them, and average margin, over one season or every meeting since 1999, where our games start. Costs 10 credits.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max games (default 20) |
| team1 * | string | First team code |
| team2 * | string | Second team code |
| season | ["string","number"] | Season year. Omit for every meeting since 1999. |
{
"name": "get_head_to_head",
"title": "Head to head",
"description": "Use to compare two teams' history: recent meetings with scores, the win/loss record between them, and average margin, over one season or every meeting since 1999, where our games start. 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 (default 20)"
},
"team1": {
"type": "string",
"description": "First team code"
},
"team2": {
"type": "string",
"description": "Second team code"
},
"season": {
"type": [
"string",
"number"
],
"description": "Season year. Omit for every meeting since 1999."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"team1",
"team2",
"record",
"total_games",
"avg_margin_team1",
"games",
"count"
],
"properties": {
"count": {
"type": "number"
},
"games": {
"type": "array",
"items": {
"type": "object",
"required": [
"game_id",
"season",
"week",
"game_type",
"home_team",
"away_team",
"home_score",
"away_score",
"status",
"kickoff"
],
"properties": {
"roof": {
"type": [
"string",
"null"
]
},
"week": {
"type": "number"
},
"season": {
"type": "number"
},
"status": {
"type": "string"
},
"game_id": {
"type": "string"
},
"gameday": {
"type": [
"string",
"null"
]
},
"kickoff": {
"type": [
"string",
"null"
]
},
"stadium": {
"type": [
"string",
"null"
]
},
"surface": {
"type": [
"string",
"null"
]
},
"away_team": {
"type": "string"
},
"game_type": {
"type": "string"
},
"home_team": {
"type": "string"
},
"away_score": {
"type": [
"number",
"null"
]
},
"home_score": {
"type": [
"number",
"null"
]
},
"total_line": {
"type": [
"number",
"null"
]
},
"spread_line": {
"type": [
"number",
"null"
]
},
"away_qb_name": {
"type": [
"string",
"null"
]
},
"home_qb_name": {
"type": [
"string",
"null"
]
},
"away_moneyline": {
"type": [
"number",
"null"
]
},
"home_moneyline": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
}
},
"team1": {
"type": "string"
},
"team2": {
"type": "string"
},
"record": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"total_games": {
"type": "number"
},
"avg_margin_team1": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Head to head",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use to find a player by name (partial match). Searches ~25,000 players back to 1999; returns current-season players by default, falling back to all players back to 1999 when none match. Returns the GSIS player id needed by get_player_stats. Costs 2 credits.
| Parameter | Type | Description |
|---|---|---|
| team | string | Filter by current team code |
| limit | integer | Max results (default 10) |
| query * | string | Player name or part of it |
| active | boolean | Default true, but an active-only search that finds nobody automatically falls back to all players and says so. Set false to search everyone outright. |
| position | string | Filter by position (e.g. QB, RB, WR, TE, OL, DL, LB, DB) |
{
"name": "search_players",
"title": "Search players",
"description": "Use to find a player by name (partial match). Searches ~25,000 players back to 1999; returns current-season players by default, falling back to all players back to 1999 when none match. Returns the GSIS player id needed by get_player_stats. Costs 2 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"team": {
"type": "string",
"description": "Filter by current team code"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max results (default 10)"
},
"query": {
"type": "string",
"minLength": 1,
"description": "Player name or part of it"
},
"active": {
"type": "boolean",
"description": "Default true, but an active-only search that finds nobody automatically falls back to all players and says so. Set false to search everyone outright."
},
"position": {
"type": "string",
"description": "Filter by position (e.g. QB, RB, WR, TE, OL, DL, LB, DB)"
}
}
},
"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",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"team": {
"type": [
"string",
"null"
]
},
"active": {
"type": [
"boolean",
"null"
]
},
"pfr_id": {
"type": [
"string",
"null"
]
},
"espn_id": {
"type": [
"string",
"null"
]
},
"position": {
"type": [
"string",
"null"
]
},
"player_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
}
},
"included_inactive": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search players",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for one player: bio, draft, physicals, id crosswalk (pfr_id, espn_id), summed season totals across passing, rushing, receiving, defense, kicking, returns, and fantasy points, every weekly stat line for the season, and games played per season. Defaults to the player's latest season. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| season | ["string","number"] | Season year. Defaults to the player's latest season. |
| player_id * | string | GSIS player id from search_players (e.g. 00-0033873) |
| season_type | string | Regular season (default) or postseason |
{
"name": "get_player_stats",
"title": "Player stats",
"description": "Use for one player: bio, draft, physicals, id crosswalk (pfr_id, espn_id), summed season totals across passing, rushing, receiving, defense, kicking, returns, and fantasy points, every weekly stat line for the season, and games played per season. Defaults to the player's latest season. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player_id"
],
"properties": {
"season": {
"type": [
"string",
"number"
],
"description": "Season year. Defaults to the player's latest season."
},
"player_id": {
"type": "string",
"description": "GSIS player id from search_players (e.g. 00-0033873)"
},
"season_type": {
"enum": [
"REG",
"POST"
],
"type": "string",
"description": "Regular season (default) or postseason"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player",
"season",
"season_type",
"season_totals",
"weeks",
"seasons",
"count"
],
"properties": {
"count": {
"type": "number"
},
"weeks": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"player": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"season": {
"type": "number"
},
"seasons": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"season_type": {
"type": "string"
},
"season_totals": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Player stats",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use to rank players on any weekly stat over a season: passing_yards, passing_tds, rushing_yards, receiving_yards, receptions, targets, def_sacks, def_interceptions, fantasy_points_ppr, passing_epa, rushing_epa, receiving_epa, and ~130 more. Counting stats are summed, rate stats averaged. Filter by position, team, minimum games. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| stat * | string | Weekly stat column to rank by (e.g. passing_yards, receiving_epa, def_sacks) |
| team | string | Team code filter |
| limit | integer | Max results (default 20) |
| season | ["string","number"] | Season year. Defaults to current. |
| position | string | Position filter, e.g. QB, RB, WR, TE |
| min_games | integer | Minimum games with a stat line (default 1) |
| season_type | string | Regular season (default) or postseason |
{
"name": "get_player_leaders",
"title": "Player leaders",
"description": "Use to rank players on any weekly stat over a season: passing_yards, passing_tds, rushing_yards, receiving_yards, receptions, targets, def_sacks, def_interceptions, fantasy_points_ppr, passing_epa, rushing_epa, receiving_epa, and ~130 more. Counting stats are summed, rate stats averaged. Filter by position, team, minimum games. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"stat"
],
"properties": {
"stat": {
"type": "string",
"description": "Weekly stat column to rank by (e.g. passing_yards, receiving_epa, def_sacks)"
},
"team": {
"type": "string",
"description": "Team code filter"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max results (default 20)"
},
"season": {
"type": [
"string",
"number"
],
"description": "Season year. Defaults to current."
},
"position": {
"type": "string",
"description": "Position filter, e.g. QB, RB, WR, TE"
},
"min_games": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Minimum games with a stat line (default 1)"
},
"season_type": {
"enum": [
"REG",
"POST"
],
"type": "string",
"description": "Regular season (default) or postseason"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"stat",
"aggregation",
"season",
"season_type",
"leaders",
"count"
],
"properties": {
"stat": {
"type": "string"
},
"count": {
"type": "number"
},
"season": {
"type": "number"
},
"leaders": {
"type": "array",
"items": {
"type": "object",
"required": [
"rank"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"rank": {
"type": "number"
},
"team": {
"type": [
"string",
"null"
]
},
"games": {
"type": [
"number",
"null"
]
},
"value": {
"type": [
"number",
"null"
]
},
"position": {
"type": [
"string",
"null"
]
},
"player_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
}
},
"aggregation": {
"type": "string"
},
"season_type": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Player leaders",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for the official injury report: game status (Out, Doubtful, Questionable) and practice participation with the injury named, by team and week. Defaults to the latest reported week of the current season. Costs 2 credits.
| Parameter | Type | Description |
|---|---|---|
| team | string | Team code |
| week | integer | Week. Defaults to the latest week with a report. |
| season | ["string","number"] | Season year. Defaults to current. |
| status | string | Filter by game status: Out, Doubtful, Questionable |
{
"name": "get_injuries",
"title": "Injuries",
"description": "Use for the official injury report: game status (Out, Doubtful, Questionable) and practice participation with the injury named, by team and week. Defaults to the latest reported week of the current season. Costs 2 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"team": {
"type": "string",
"description": "Team code"
},
"week": {
"type": "integer",
"maximum": 22,
"minimum": 1,
"description": "Week. Defaults to the latest week with a report."
},
"season": {
"type": [
"string",
"number"
],
"description": "Season year. Defaults to current."
},
"status": {
"type": "string",
"description": "Filter by game status: Out, Doubtful, Questionable"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"season",
"week",
"injuries",
"count"
],
"properties": {
"note": {
"type": "string"
},
"week": {
"type": "number"
},
"count": {
"type": "number"
},
"season": {
"type": "number"
},
"injuries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"team": {
"type": [
"string",
"null"
]
},
"position": {
"type": [
"string",
"null"
]
},
"player_id": {
"type": [
"string",
"null"
]
},
"report_status": {
"type": [
"string",
"null"
]
},
"practice_status": {
"type": [
"string",
"null"
]
},
"report_primary_injury": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Injuries",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for a team's depth chart by week: formation, position, depth rank, player. Defaults to the latest week available. Costs 2 credits.
| Parameter | Type | Description |
|---|---|---|
| team * | string | Team code |
| week | integer | Week. Defaults to latest. |
| season | ["string","number"] | Season year. Defaults to current. |
| formation | string | Filter by formation/unit, e.g. Offense, Defense, Special Teams |
{
"name": "get_depth_chart",
"title": "Depth chart",
"description": "Use for a team's depth chart by week: formation, position, depth rank, player. Defaults to the latest week available. Costs 2 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"team"
],
"properties": {
"team": {
"type": "string",
"description": "Team code"
},
"week": {
"type": "integer",
"maximum": 22,
"minimum": 1,
"description": "Week. Defaults to latest."
},
"season": {
"type": [
"string",
"number"
],
"description": "Season year. Defaults to current."
},
"formation": {
"type": "string",
"description": "Filter by formation/unit, e.g. Offense, Defense, Special Teams"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"team",
"season",
"week",
"depth_chart",
"count"
],
"properties": {
"team": {
"type": "string"
},
"week": {
"type": "number"
},
"count": {
"type": "number"
},
"season": {
"type": "number"
},
"depth_chart": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"position": {
"type": [
"string",
"null"
]
},
"formation": {
"type": [
"string",
"null"
]
},
"player_id": {
"type": [
"string",
"null"
]
},
"depth_rank": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Depth chart",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for playing time: offensive, defensive, and special-teams snaps and snap shares, for one game, one player (PFR id), or a team's season. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| team | string | Team code |
| week | integer | Week filter |
| limit | integer | Max rows (default 200) |
| season | ["string","number"] | Season year (with team or player) |
| game_id | string | Game id, e.g. 2025_01_KC_BUF |
| player_id | string | PFR player id (from search_players pfr_id) |
{
"name": "get_snap_counts",
"title": "Snap counts",
"description": "Use for playing time: offensive, defensive, and special-teams snaps and snap shares, for one game, one player (PFR id), or a team's season. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"team": {
"type": "string",
"description": "Team code"
},
"week": {
"type": "integer",
"maximum": 22,
"minimum": 1,
"description": "Week filter"
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Max rows (default 200)"
},
"season": {
"type": [
"string",
"number"
],
"description": "Season year (with team or player)"
},
"game_id": {
"type": "string",
"description": "Game id, e.g. 2025_01_KC_BUF"
},
"player_id": {
"type": "string",
"description": "PFR player id (from search_players pfr_id)"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"filters",
"snap_counts",
"count"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"filters": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"snap_counts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"team": {
"type": [
"string",
"null"
]
},
"week": {
"type": [
"number",
"null"
]
},
"player": {
"type": [
"string",
"null"
]
},
"season": {
"type": [
"number",
"null"
]
},
"st_pct": {
"type": [
"number",
"null"
]
},
"game_id": {
"type": [
"string",
"null"
]
},
"position": {
"type": [
"string",
"null"
]
},
"st_snaps": {
"type": [
"number",
"null"
]
},
"defense_pct": {
"type": [
"number",
"null"
]
},
"offense_pct": {
"type": [
"number",
"null"
]
},
"defense_snaps": {
"type": [
"number",
"null"
]
},
"offense_snaps": {
"type": [
"number",
"null"
]
},
"pfr_player_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Snap counts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for play-by-play with advanced metrics: EPA, WPA, win probability, success, CPOE, air yards, formation flags, and the players involved. Filter by game, or by season plus week/team/player, plus play type, down, quarter, win-probability band, red zone, third down. Returns a per-query EPA and success-rate summary. Paginate with offset. Costs 10 credits.
| Parameter | Type | Description |
|---|---|---|
| down | integer | Down |
| week | integer | Week |
| limit | integer | Max plays (default 200) |
| max_wp | number | Maximum pre-play win probability |
| min_wp | number | Minimum pre-play win probability for the offense |
| offset | integer | Pagination offset |
| season | ["string","number"] | Season year (required when game_id is not set) |
| defteam | string | Defense team code |
| game_id | string | Game id, e.g. 2025_01_KC_BUF |
| posteam | string | Offense team code |
| quarter | integer | Quarter (5+ = overtime) |
| red_zone | boolean | Only plays inside the 20 |
| passer_id | string | GSIS id of the passer |
| play_type | string | Play type |
| rusher_id | string | GSIS id of the rusher |
| third_down | boolean | Only third downs |
| receiver_id | string | GSIS id of the receiver |
{
"name": "get_plays",
"title": "Plays",
"description": "Use for play-by-play with advanced metrics: EPA, WPA, win probability, success, CPOE, air yards, formation flags, and the players involved. Filter by game, or by season plus week/team/player, plus play type, down, quarter, win-probability band, red zone, third down. Returns a per-query EPA and success-rate summary. Paginate with offset. Costs 10 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"down": {
"type": "integer",
"maximum": 4,
"minimum": 1,
"description": "Down"
},
"week": {
"type": "integer",
"maximum": 22,
"minimum": 1,
"description": "Week"
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Max plays (default 200)"
},
"max_wp": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Maximum pre-play win probability"
},
"min_wp": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Minimum pre-play win probability for the offense"
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Pagination offset"
},
"season": {
"type": [
"string",
"number"
],
"description": "Season year (required when game_id is not set)"
},
"defteam": {
"type": "string",
"description": "Defense team code"
},
"game_id": {
"type": "string",
"description": "Game id, e.g. 2025_01_KC_BUF"
},
"posteam": {
"type": "string",
"description": "Offense team code"
},
"quarter": {
"type": "integer",
"maximum": 6,
"minimum": 1,
"description": "Quarter (5+ = overtime)"
},
"red_zone": {
"type": "boolean",
"description": "Only plays inside the 20"
},
"passer_id": {
"type": "string",
"description": "GSIS id of the passer"
},
"play_type": {
"enum": [
"pass",
"run",
"punt",
"kickoff",
"field_goal",
"extra_point",
"qb_kneel",
"qb_spike",
"no_play"
],
"type": "string",
"description": "Play type"
},
"rusher_id": {
"type": "string",
"description": "GSIS id of the rusher"
},
"third_down": {
"type": "boolean",
"description": "Only third downs"
},
"receiver_id": {
"type": "string",
"description": "GSIS id of the receiver"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"plays",
"summary",
"count",
"next_offset"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"plays": {
"type": "array",
"items": {
"type": "object",
"required": [
"game_id",
"play_id"
],
"properties": {
"wp": {
"type": [
"number",
"null"
]
},
"epa": {
"type": [
"number",
"null"
]
},
"qtr": {
"type": [
"number",
"null"
]
},
"wpa": {
"type": [
"number",
"null"
]
},
"desc": {
"type": [
"string",
"null"
]
},
"down": {
"type": [
"number",
"null"
]
},
"week": {
"type": [
"number",
"null"
]
},
"season": {
"type": [
"number",
"null"
]
},
"defteam": {
"type": [
"string",
"null"
]
},
"game_id": {
"type": "string"
},
"play_id": {
"type": "number"
},
"posteam": {
"type": [
"string",
"null"
]
},
"success": {
"type": [
"number",
"null"
]
},
"ydstogo": {
"type": [
"number",
"null"
]
},
"play_type": {
"type": [
"string",
"null"
]
},
"touchdown": {
"type": [
"number",
"null"
]
},
"yardline_100": {
"type": [
"number",
"null"
]
},
"yards_gained": {
"type": [
"number",
"null"
]
},
"passer_player_name": {
"type": [
"string",
"null"
]
},
"rusher_player_name": {
"type": [
"string",
"null"
]
},
"receiver_player_name": {
"type": [
"string",
"null"
]
}
},
"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 for tracking and advanced metrics the box score does not carry. Next Gen Stats (2016+): time to throw, air yards, completion percentage above expectation, separation, cushion, rush yards over expected. Pro Football Reference advanced (2018+): pressures, hurries, blitzes, drops, bad throws, missed tackles, coverage yards allowed. Pick a source, then filter by season, week, player or team. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| team | string | Team code |
| week | integer | Week. NGS also publishes week 0 as the season aggregate. |
| limit | integer | Max rows (default 50) |
| season | ["string","number"] | Season year. Defaults to current. NGS from 2016, PFR from 2018. |
| source * | string | Which dataset: ngs_passing, ngs_rushing, ngs_receiving, pfr_passing, pfr_rushing, pfr_receiving, pfr_defense |
| player_id | string | GSIS id for an ngs_* source, PFR id for a pfr_* source; both are on search_players |
{
"name": "get_advanced_stats",
"title": "Advanced stats",
"description": "Use for tracking and advanced metrics the box score does not carry. Next Gen Stats (2016+): time to throw, air yards, completion percentage above expectation, separation, cushion, rush yards over expected. Pro Football Reference advanced (2018+): pressures, hurries, blitzes, drops, bad throws, missed tackles, coverage yards allowed. Pick a source, then filter by season, week, player or team. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"source"
],
"properties": {
"team": {
"type": "string",
"description": "Team code"
},
"week": {
"type": "integer",
"maximum": 22,
"minimum": 0,
"description": "Week. NGS also publishes week 0 as the season aggregate."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Max rows (default 50)"
},
"season": {
"type": [
"string",
"number"
],
"description": "Season year. Defaults to current. NGS from 2016, PFR from 2018."
},
"source": {
"enum": [
"ngs_passing",
"ngs_rushing",
"ngs_receiving",
"pfr_passing",
"pfr_rushing",
"pfr_receiving",
"pfr_defense"
],
"type": "string",
"description": "Which dataset: ngs_passing, ngs_rushing, ngs_receiving, pfr_passing, pfr_rushing, pfr_receiving, pfr_defense"
},
"player_id": {
"type": "string",
"description": "GSIS id for an ngs_* source, PFR id for a pfr_* source; both are on search_players"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"source",
"season",
"player_id_kind",
"metric_keys",
"stats",
"count"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"stats": {
"type": "array",
"items": {
"type": "object",
"required": [
"metrics"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"team": {
"type": [
"string",
"null"
]
},
"week": {
"type": [
"number",
"null"
]
},
"season": {
"type": [
"number",
"null"
]
},
"metrics": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"player_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
}
},
"season": {
"type": "number"
},
"source": {
"type": "string"
},
"metric_keys": {
"type": "array",
"items": {
"type": "string"
}
},
"player_id_kind": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Advanced stats",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for betting lines. Pass game_id for one game (10 credits): the consensus closing spread and total (every game since 1999; moneyline every game since 2010) plus each sportsbook's closing line from the 2014 season (4-9 books for 2014-2019, closing only) and per-bookmaker opening, closing and latest lines from the 2020 season (up to 8 books, including Pinnacle). Or pass season (optionally team) for a season of per-book closing lines in one call, with final scores and the consensus close, at 10 credits per game returned, 100 games a page by default (up to 500); each book's line is an array in the order given by columns. Each line carries a source field (one value for the 2014-2019 closing lines, another from 2020); a season answer lists each game's sources. For consensus closing lines only, get_games returns a whole season for 5 credits. Set estimate_only to get the price without being charged. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| team | string | With season: only this team's games (e.g. KC). |
| 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","number"] | Season year for a whole season of per-book lines, e.g. 2026. Used when game_id is not set. |
| game_id | string | Game id, e.g. 2026_01_KC_BUF. Omit and pass season for a whole season. |
| bookmaker | string | Bookmaker key (draftkings, fanduel, betmgm, espnbet, pinnacle, bovada, betonlineag, mybookieag; for 2014-2019 also westgate, caesars, wynn, unibet, 5dimes, sportsbettingag and others) |
| estimate_only | boolean | Return what this call would cost, without charging or running it. |
| snapshot_type | string | Single game: one snapshot type (default all). Season: opening or closing (default closing). |
{
"name": "get_odds",
"title": "Odds",
"description": "Use for betting lines. Pass game_id for one game (10 credits): the consensus closing spread and total (every game since 1999; moneyline every game since 2010) plus each sportsbook's closing line from the 2014 season (4-9 books for 2014-2019, closing only) and per-bookmaker opening, closing and latest lines from the 2020 season (up to 8 books, including Pinnacle). Or pass season (optionally team) for a season of per-book closing lines in one call, with final scores and the consensus close, at 10 credits per game returned, 100 games a page by default (up to 500); each book's line is an array in the order given by columns. Each line carries a source field (one value for the 2014-2019 closing lines, another from 2020); a season answer lists each game's sources. For consensus closing lines only, get_games returns a whole season for 5 credits. 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": {
"team": {
"type": "string",
"description": "With season: only this team's games (e.g. KC)."
},
"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",
"number"
],
"description": "Season year for a whole season of per-book lines, e.g. 2026. Used when game_id is not set."
},
"game_id": {
"type": "string",
"description": "Game id, e.g. 2026_01_KC_BUF. Omit and pass season for a whole season."
},
"bookmaker": {
"type": "string",
"description": "Bookmaker key (draftkings, fanduel, betmgm, espnbet, pinnacle, bovada, betonlineag, mybookieag; for 2014-2019 also westgate, caesars, wynn, unibet, 5dimes, sportsbettingag and others)"
},
"estimate_only": {
"type": "boolean",
"description": "Return what this call would cost, without charging or running it."
},
"snapshot_type": {
"enum": [
"opening",
"closing",
"latest"
],
"type": "string",
"description": "Single game: one snapshot type (default all). Season: opening or closing (default closing)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"note": {
"type": "string"
},
"tool": {
"type": "string"
},
"books": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"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"
},
"kickoff": {
"type": [
"string",
"null"
]
},
"away_team": {
"type": "string"
},
"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"
},
"consensus_closing": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Odds",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use to see how a game's lines moved: each bookmaker's hourly snapshots where a line changed, plus the latest (all_snapshots for every capture). Most expensive tool (25 cr); use get_odds (10 cr) if you only need opening, closing, or current lines. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| game_id * | string | Game id |
| bookmaker | string | Bookmaker key filter |
| all_snapshots | boolean | Every hourly capture. By default a capture identical to the one before it is left out (the latest is always kept), which keeps every move and its time. |
{
"name": "get_line_movement",
"title": "Line movement",
"description": "Use to see how a game's lines moved: each bookmaker's hourly snapshots where a line changed, plus the latest (all_snapshots for every capture). Most expensive tool (25 cr); use get_odds (10 cr) if you only need opening, closing, or current lines. 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"
},
"bookmaker": {
"type": "string",
"description": "Bookmaker key filter"
},
"all_snapshots": {
"type": "boolean",
"description": "Every hourly capture. By default a capture identical to the one before it is left out (the latest is always kept), which keeps every move and its time."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id",
"home_team",
"away_team",
"kickoff",
"movement",
"snapshots"
],
"properties": {
"game_id": {
"type": "string"
},
"kickoff": {
"type": [
"string",
"null"
]
},
"movement": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "array",
"items": {
"type": "object",
"required": [
"bookmaker",
"snapshot_type"
],
"properties": {
"total": {
"type": [
"number",
"null"
]
},
"source": {
"type": "string"
},
"ml_away": {
"type": [
"number",
"null"
]
},
"ml_home": {
"type": [
"number",
"null"
]
},
"bookmaker": {
"type": "string"
},
"captured_at": {
"type": [
"string",
"null"
]
},
"spread_away": {
"type": [
"number",
"null"
]
},
"spread_home": {
"type": [
"number",
"null"
]
},
"snapshot_type": {
"type": "string"
}
},
"additionalProperties": {}
}
}
},
"away_team": {
"type": "string"
},
"home_team": {
"type": "string"
},
"snapshots": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Line movement",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for player prop lines by sportsbook: over/under on passing yards, passing TDs, rushing yards, receiving yards and receptions, plus anytime TD, from the 2023 season (7 books: DraftKings, FanDuel, BetMGM, ESPN BET, Pinnacle, Bovada, BetOnline). Pass game_id for every player's props in one game, or player_id with season for one player across a season. A game costs 10 credits before kickoff and 20 once it has kicked off (accounts opened before October 30 2026 pay 10 for every game). Returns the closing line by default (the last before kickoff) or the opening line. 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_pass_yds (passing yards), player_pass_tds (passing touchdowns), player_pass_completions (pass completions), player_pass_attempts (pass attempts), player_pass_interceptions (interceptions thrown), player_rush_yds (rushing yards), player_rush_attempts (rush attempts), player_recepti… |
| season | ["string","number"] | Season year, with player_id. |
| game_id | string | Game id, e.g. 2025_01_KC_LAC. |
| bookmaker | string | Bookmaker key, e.g. draftkings, fanduel, pinnacle. |
| player_id | string | GSIS player id (00-00XXXXX) from search_players. With season: that player's props across the season. |
| estimate_only | boolean | Return what this call would cost, without charging or running it. |
| snapshot_type | string | closing (default): the last line before kickoff. opening: the first one captured. |
{
"name": "get_player_props",
"title": "Player props",
"description": "Use for player prop lines by sportsbook: over/under on passing yards, passing TDs, rushing yards, receiving yards and receptions, plus anytime TD, from the 2023 season (7 books: DraftKings, FanDuel, BetMGM, ESPN BET, Pinnacle, Bovada, BetOnline). Pass game_id for every player's props in one game, or player_id with season for one player across a season. A game costs 10 credits before kickoff and 20 once it has kicked off (accounts opened before October 30 2026 pay 10 for every game). Returns the closing line by default (the last before kickoff) or the opening line. 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_pass_yds",
"player_pass_tds",
"player_pass_completions",
"player_pass_attempts",
"player_pass_interceptions",
"player_rush_yds",
"player_rush_attempts",
"player_reception_yds",
"player_receptions",
"player_anytime_td",
"player_tds_over",
"player_1st_td",
"player_pass_longest_completion",
"player_rush_longest",
"player_reception_longest"
],
"type": "string",
"description": "One market: player_pass_yds (passing yards), player_pass_tds (passing touchdowns), player_pass_completions (pass completions), player_pass_attempts (pass attempts), player_pass_interceptions (interceptions thrown), player_rush_yds (rushing yards), player_rush_attempts (rush attempts), player_reception_yds (receiving yards), player_receptions (receptions), player_anytime_td (anytime touchdown (over = scores)), player_tds_over (touchdowns scored), player_1st_td (first touchdown scorer (over = scores the game's first touchdown)), player_pass_longest_completion (longest completion), player_rush_longest (longest rush), player_reception_longest (longest reception)"
},
"season": {
"type": [
"string",
"number"
],
"description": "Season year, with player_id."
},
"game_id": {
"type": "string",
"description": "Game id, e.g. 2025_01_KC_LAC."
},
"bookmaker": {
"type": "string",
"description": "Bookmaker key, e.g. draftkings, fanduel, pinnacle."
},
"player_id": {
"type": "string",
"description": "GSIS player id (00-00XXXXX) from search_players. With season: that player's props across the season."
},
"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 kickoff. opening: the first one captured."
}
}
},
"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",
"player_name",
"gsis_id",
"market",
"bookmaker",
"line",
"over_odds",
"under_odds",
"captured_at"
],
"properties": {
"line": {
"type": [
"number",
"null"
]
},
"market": {
"type": "string"
},
"source": {
"type": "string"
},
"game_id": {
"type": "string"
},
"gsis_id": {
"type": [
"string",
"null"
]
},
"bookmaker": {
"type": "string"
},
"over_odds": {
"type": [
"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"
},
"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 (passing, rushing or receiving yards, passing touchdowns, completions, attempts, interceptions, carries, receptions, anytime or first touchdown, touchdowns scored, or the longest completion, rush or reception), 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_pass_yds (passing yards), player_pass_tds (passing touchdowns), player_pass_completions (pass completions), player_pass_attempts (pass attempts), player_pass_interceptions (interceptions thrown), player_rush_yds (rushing yards), player_rush_attempts (rush attempts), player_recepti… |
| 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 * | string | Player id (a GSIS id such as 00-0033873) 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 (passing, rushing or receiving yards, passing touchdowns, completions, attempts, interceptions, carries, receptions, anytime or first touchdown, touchdowns scored, or the longest completion, rush or reception), 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_pass_yds",
"player_pass_tds",
"player_pass_completions",
"player_pass_attempts",
"player_pass_interceptions",
"player_rush_yds",
"player_rush_attempts",
"player_receptions",
"player_reception_yds",
"player_anytime_td",
"player_tds_over",
"player_1st_td",
"player_pass_longest_completion",
"player_rush_longest",
"player_reception_longest"
],
"type": "string",
"description": "The market: player_pass_yds (passing yards), player_pass_tds (passing touchdowns), player_pass_completions (pass completions), player_pass_attempts (pass attempts), player_pass_interceptions (interceptions thrown), player_rush_yds (rushing yards), player_rush_attempts (rush attempts), player_receptions (receptions), player_reception_yds (receiving yards), player_anytime_td (anytime touchdown (over = scores)), player_tds_over (touchdowns scored), player_1st_td (first touchdown scorer (over = scores the game's first touchdown)), player_pass_longest_completion (longest completion), player_rush_longest (longest rush), player_reception_longest (longest reception)"
},
"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": "string",
"description": "Player id (a GSIS id such as 00-0033873) 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_pass_yds (passing yards), player_pass_tds (passing touchdowns), player_pass_completions (pass completions), player_pass_attempts (pass attempts), player_pass_interceptions (interceptions thrown), player_rush_yds (rushing yards), player_rush_attempts (rush attempts), player_recepti… |
| game_id * | string | Game id. |
| bookmaker | string | One book's captures, e.g. draftkings. |
| player_id * | string | Player id (a GSIS id such as 00-0033873) 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_pass_yds",
"player_pass_tds",
"player_pass_completions",
"player_pass_attempts",
"player_pass_interceptions",
"player_rush_yds",
"player_rush_attempts",
"player_receptions",
"player_reception_yds",
"player_anytime_td",
"player_tds_over",
"player_1st_td",
"player_pass_longest_completion",
"player_rush_longest",
"player_reception_longest"
],
"type": "string",
"description": "The market: player_pass_yds (passing yards), player_pass_tds (passing touchdowns), player_pass_completions (pass completions), player_pass_attempts (pass attempts), player_pass_interceptions (interceptions thrown), player_rush_yds (rushing yards), player_rush_attempts (rush attempts), player_receptions (receptions), player_reception_yds (receiving yards), player_anytime_td (anytime touchdown (over = scores)), player_tds_over (touchdowns scored), player_1st_td (first touchdown scorer (over = scores the game's first touchdown)), player_pass_longest_completion (longest completion), player_rush_longest (longest rush), player_reception_longest (longest reception)"
},
"game_id": {
"type": "string",
"description": "Game id."
},
"bookmaker": {
"type": "string",
"description": "One book's captures, e.g. draftkings."
},
"player_id": {
"type": "string",
"description": "Player id (a GSIS id such as 00-0033873) 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 alternate spreads and totals by sportsbook: every point on each book's ladder with its price (e.g. KC -10.5 at +260, over 51.5 at +140), for one game, from the 2023 season on, the current season included (6 to 7 books: FanDuel, DraftKings, BetMGM, Bovada, Pinnacle, ESPN BET). Returns each book's closing ladder by default (the last before kickoff) or its opening one. side is home or away for spreads (point is that side's spread) and over or under for totals. 10 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| market | string | One market (default both). |
| game_id * | string | Game id, e.g. 2025_01_KC_LAC. |
| bookmaker | string | Bookmaker key: fanduel, draftkings, betmgm, bovada, pinnacle, espnbet. |
| snapshot_type | string | closing (default): each book's last ladder before kickoff. opening: its first. |
{
"name": "get_alt_lines",
"title": "Alt lines",
"description": "Use for alternate spreads and totals by sportsbook: every point on each book's ladder with its price (e.g. KC -10.5 at +260, over 51.5 at +140), for one game, from the 2023 season on, the current season included (6 to 7 books: FanDuel, DraftKings, BetMGM, Bovada, Pinnacle, ESPN BET). Returns each book's closing ladder by default (the last before kickoff) or its opening one. side is home or away for spreads (point is that side's spread) and over or under for totals. 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": [
"alternate_spreads",
"alternate_totals"
],
"type": "string",
"description": "One market (default both)."
},
"game_id": {
"type": "string",
"description": "Game id, e.g. 2025_01_KC_LAC."
},
"bookmaker": {
"type": "string",
"description": "Bookmaker key: fanduel, draftkings, betmgm, bovada, pinnacle, espnbet."
},
"snapshot_type": {
"enum": [
"opening",
"closing"
],
"type": "string",
"description": "closing (default): each book's last ladder before kickoff. opening: its first."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id",
"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"
],
"properties": {
"side": {
"type": "string"
},
"point": {
"type": "number"
},
"price": {
"type": "number"
},
"market": {
"type": "string"
},
"source": {
"type": "string"
},
"bookmaker": {
"type": "string"
},
"captured_at": {
"type": "string"
}
},
"additionalProperties": false
}
},
"game_id": {
"type": "string"
},
"snapshot_type": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Alt lines",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for alternate player prop lines by sportsbook: every line a book posted for a player in one game, not only the main one (e.g. 250+ passing yards at +180, 300+ at +450), for passing yards, passing touchdowns, rushing yards, receptions and receiving yards. Pass game_id and market, and player_id (a GSIS id from search_players) for one player. Returns each book's last ladder before kickoff: per line the over price and, where the book posts it, the under. Alternate player props are held for NFL games from October 5 2023 (week 5) on, captured once in the last 75 minutes before kickoff, from 4 to 6 books since 2024. 2023 is partial: FanDuel, plus DraftKings from December 10; passing yards, passing touchdowns and receiving yards for about 217 games from October 5, rushing yards and receptions for about 87 from December 10. Weeks 1 to 4 of 2023 have none. A game further out has none yet. For the main line and the opening and closing prices use get_player_props; for how a player did against his main line use get_prop_history. 10 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| market * | string | The market: player_pass_yds_alternate (passing yards), player_pass_tds_alternate (passing touchdowns), player_rush_yds_alternate (rushing yards), player_receptions_alternate (receptions), player_reception_yds_alternate (receiving yards) |
| game_id * | string | Game id, e.g. 2025_01_KC_LAC. |
| bookmaker | string | One bookmaker key, e.g. draftkings, fanduel. |
| player_id | string | One player's GSIS id, e.g. 00-0034857 (from search_players). Default every player in the game. |
| estimate_only | boolean | Return what this call would cost, without charging or running it. |
{
"name": "get_alt_player_props",
"title": "Alt player props",
"description": "Use for alternate player prop lines by sportsbook: every line a book posted for a player in one game, not only the main one (e.g. 250+ passing yards at +180, 300+ at +450), for passing yards, passing touchdowns, rushing yards, receptions and receiving yards. Pass game_id and market, and player_id (a GSIS id from search_players) for one player. Returns each book's last ladder before kickoff: per line the over price and, where the book posts it, the under. Alternate player props are held for NFL games from October 5 2023 (week 5) on, captured once in the last 75 minutes before kickoff, from 4 to 6 books since 2024. 2023 is partial: FanDuel, plus DraftKings from December 10; passing yards, passing touchdowns and receiving yards for about 217 games from October 5, rushing yards and receptions for about 87 from December 10. Weeks 1 to 4 of 2023 have none. A game further out has none yet. For the main line and the opening and closing prices use get_player_props; for how a player did against his main line use get_prop_history. 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",
"market"
],
"properties": {
"market": {
"enum": [
"player_pass_yds_alternate",
"player_pass_tds_alternate",
"player_rush_yds_alternate",
"player_receptions_alternate",
"player_reception_yds_alternate"
],
"type": "string",
"description": "The market: player_pass_yds_alternate (passing yards), player_pass_tds_alternate (passing touchdowns), player_rush_yds_alternate (rushing yards), player_receptions_alternate (receptions), player_reception_yds_alternate (receiving yards)"
},
"game_id": {
"type": "string",
"description": "Game id, e.g. 2025_01_KC_LAC."
},
"bookmaker": {
"type": "string",
"description": "One bookmaker key, e.g. draftkings, fanduel."
},
"player_id": {
"type": "string",
"description": "One player's GSIS id, e.g. 00-0034857 (from search_players). Default every player in the game."
},
"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",
"players",
"count"
],
"properties": {
"note": {
"type": "string"
},
"tool": {
"type": "string"
},
"count": {
"type": "number"
},
"label": {
"type": "string"
},
"market": {
"type": "string"
},
"credits": {
"type": "number"
},
"game_id": {
"type": "string"
},
"players": {
"type": "array",
"items": {
"type": "object",
"required": [
"player_name",
"player_id",
"books"
],
"properties": {
"books": {
"type": "array",
"items": {
"type": "object",
"required": [
"bookmaker",
"captured_at",
"ladder"
],
"properties": {
"ladder": {
"type": "array",
"items": {
"type": "object",
"required": [
"line",
"over_odds",
"under_odds"
],
"properties": {
"line": {
"type": "number"
},
"over_odds": {
"type": [
"number",
"null"
]
},
"under_odds": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"bookmaker": {
"type": "string"
},
"captured_at": {
"type": "string"
}
},
"additionalProperties": false
}
},
"player_id": {
"type": [
"string",
"null"
]
},
"player_name": {
"type": "string"
}
},
"additionalProperties": false
}
},
"estimate_only": {
"type": "boolean"
},
"scheduled_start": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Alt player props",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for the extra betting markets of a game as history: the 1st half and 1st quarter winner, point spread and total, the 2nd half total, and the 2nd, 3rd and 4th quarter 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 the 2023 season 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_h1 (1st half winner), spreads_h1 (1st half point spread), totals_h1 (1st half total points), h2h_q1 (1st quarter winner), spreads_q1 (1st quarter point spread), totals_q1 (1st quarter total points), totals_q2 (2nd quarter total points), totals_q3 (3rd quarter total points), totals_q4… |
| 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 1st half and 1st quarter winner, point spread and total, the 2nd half total, and the 2nd, 3rd and 4th quarter 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 the 2023 season 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_h1",
"spreads_h1",
"totals_h1",
"h2h_q1",
"spreads_q1",
"totals_q1",
"totals_q2",
"totals_q3",
"totals_q4",
"totals_h2"
],
"type": "string",
"description": "The market: h2h_h1 (1st half winner), spreads_h1 (1st half point spread), totals_h1 (1st half total points), h2h_q1 (1st quarter winner), spreads_q1 (1st quarter point spread), totals_q1 (1st quarter total points), totals_q2 (2nd quarter total points), totals_q3 (3rd quarter total points), totals_q4 (4th quarter total points), totals_h2 (2nd half total points)"
},
"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 spread 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 kickoff, 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. 2025_01_KC_LAC. |
| 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 spread 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 kickoff, 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. 2025_01_KC_LAC."
},
"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",
"kickoff",
"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"
},
"kickoff": {
"type": [
"string",
"null"
]
},
"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
},
"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"
}
},
"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 one-sided market such as anytime touchdown has no fair probability unless a book posts both sides. 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_pass_yds. Default every market. |
| game_id * | string | Game id, e.g. 2025_01_KC_LAC. |
| player_id | string | One player's GSIS id, e.g. 00-0033873 (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 one-sided market such as anytime touchdown has no fair probability unless a book posts both sides. 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_pass_yds",
"player_pass_tds",
"player_pass_completions",
"player_pass_attempts",
"player_pass_interceptions",
"player_rush_yds",
"player_rush_attempts",
"player_receptions",
"player_reception_yds",
"player_anytime_td",
"player_tds_over",
"player_1st_td",
"player_pass_longest_completion",
"player_rush_longest",
"player_reception_longest"
],
"type": "string",
"description": "One market, e.g. player_pass_yds. Default every market."
},
"game_id": {
"type": "string",
"description": "Game id, e.g. 2025_01_KC_LAC."
},
"player_id": {
"type": "string",
"description": "One player's GSIS id, e.g. 00-0033873 (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",
"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 since 2023 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, receiving yards overs for tight ends on home underdogs. 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 such as player_anytime_td have only over. |
| team | string | The player's team, e.g. KC. |
| market * | string | The market, e.g. player_reception_yds. |
| 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, e.g. BUF. |
| position | string | The player's position, e.g. QB, RB, WR, TE. |
| week_max | integer | Last week of the season. |
| week_min | integer | First week of the season. |
| game_type | string | Default both. |
| home_away | string | Whether his team was at home. |
| player_id | string | One player's GSIS id (from search_players). |
| team_role | string | Whether his team was favored, by the consensus closing spread. |
| to_season | integer | Last season. Default all held. |
| from_season | integer | First season, 2023 or later. Default all held. |
{
"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 since 2023 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, receiving yards overs for tight ends on home underdogs. 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 such as player_anytime_td have only over."
},
"team": {
"type": "string",
"description": "The player's team, e.g. KC."
},
"market": {
"enum": [
"player_pass_yds",
"player_pass_tds",
"player_pass_completions",
"player_pass_attempts",
"player_pass_interceptions",
"player_rush_yds",
"player_rush_attempts",
"player_receptions",
"player_reception_yds",
"player_anytime_td",
"player_tds_over"
],
"type": "string",
"description": "The market, e.g. player_reception_yds."
},
"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, e.g. BUF."
},
"position": {
"type": "string",
"description": "The player's position, e.g. QB, RB, WR, TE."
},
"week_max": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Last week of the season."
},
"week_min": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "First week of the season."
},
"game_type": {
"enum": [
"regular",
"postseason"
],
"type": "string",
"description": "Default both."
},
"home_away": {
"enum": [
"home",
"away"
],
"type": "string",
"description": "Whether his team was at home."
},
"player_id": {
"type": "string",
"description": "One player's GSIS id (from search_players)."
},
"team_role": {
"enum": [
"favorite",
"underdog"
],
"type": "string",
"description": "Whether his team was favored, by the consensus closing spread."
},
"to_season": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Last season. Default all held."
},
"from_season": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "First season, 2023 or later. Default all held."
}
}
},
"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"
},
"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
}
}EndzoneAPI -- 26 football data tools. Play-by-play, stats, schedules, injuries, and odds. ## First Steps 1. Call list_teams (1 cr) for the 32 team codes. Codes are standard abbreviations: LA for the Rams, WAS for Washington, LV, LAC, JAX. 2. Seasons are one year: the year the regular season starts (2025 = the 2025-26 season). 3. Game ids look like 2025_01_KC_BUF: season, week (two digits), away, home. Get them from get_games or get_schedule. 4. Player ids are GSIS ids (00-0033873). Get them from search_players. Snap counts use PFR ids (also returned by search_players). ## Tool Selection ### Teams - Team codes, colours, logos -> list_teams (1 cr) - Standings, records, streaks -> get_standings (2 cr) - One team's season totals + weekly lines + EPA -> get_team_stats (5 cr) - Two teams' history -> get_head_to_head (10 cr) ### Games - What's coming up -> get_schedule (2 cr) - Past/future games with filters and closing lines -> get_games (5 cr) - Everything about one game (box score, odds, officials, weather) -> get_game_detail (10 cr) ### Players - Find a player -> search_players (2 cr) - One player's bio + season totals + weekly lines -> get_player_stats (5 cr) - Rank players on any stat -> get_player_leaders (5 cr) - Injury report -> get_injuries (2 cr) - Depth chart -> get_depth_chart (2 cr) - Advanced team, player and game metrics -> get_advanced_stats (5 cr) - Playing time -> get_snap_counts (5 cr) ### Plays - Play-by-play with EPA/WPA/success and situation filters -> get_plays (10 cr) ### Odds - Lines for one game (consensus closing + per-book opening/closing/latest) -> get_odds (10 cr) - Player prop lines by sportsbook -> get_player_props (10 cr); how a player did against his line, game by game -> get_prop_history (10 cr); how a line moved before a game -> get_prop_movement (10 cr) - Alternate spreads and totals, the full ladder by sportsbook (2023 on, current season included) -> get_alt_lines (10 cr) - Alternate player prop ladders (250+ passing yards and the rest) by sportsbook, as history -> get_alt_player_props (10 cr) - 1st half, 1st quarter and quarter-total lines as history, opening and closing by sportsbook -> get_market_odds (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 ("tight end receiving overs on home 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 - Full line history -> get_line_movement (25 cr, most expensive) ## Common Workflows Game preview: get_schedule -> get_game_detail -> get_injuries (14 cr) Player deep dive: search_players -> get_player_stats -> get_snap_counts (12 cr) Leaderboard: get_player_leaders with stat=passing_epa, position=QB (5 cr) Situational analysis: get_plays with season, posteam, third_down=true (10 cr) Matchup: get_head_to_head -> get_odds (20 cr) ## Credit Costs | Credits | Tools | |---------|-------| | 1 | list_teams | | 2 | get_standings, get_schedule, search_players, get_injuries, get_depth_chart | | 5 | get_games, get_team_stats, get_player_stats, get_player_leaders, get_snap_counts, get_advanced_stats, get_game_probabilities | | 10 | get_plays, get_odds, get_game_detail, get_head_to_head, get_player_props, get_alt_lines, get_prop_history, get_prop_movement, get_alt_player_props, get_market_odds, get_prop_probabilities | | 25 | get_line_movement, get_prop_backtest | ## Data Coverage - Games and consensus closing lines: spread and total for every game since 1999; moneylines from 2006 (every game from 2010) - Weekly player and team stats (150 columns): 1999 onwards - Play-by-play with EPA and win probability: 1999 onwards - Injuries: 2009 onwards. Depth charts: 2001 onwards. Snap counts: 2013 onwards - Per-bookmaker od
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.