DunkAPI
NBA, WNBA and college basketball data: play-by-play, shot locations, box scores, odds. REST and MCP.
使うべきか
品質と安全性
A
検出事項（3）
- LOWTool 'get_leaders' description lacks action verbget_leaders 内
- LOWTool 'get_team_stats' description lacks action verbget_team_stats 内
- LOWTool 'get_ratings' description lacks action verbget_ratings 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~6,847トークン数（ツール定義）
~3.3 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 5.35%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"dunkapi": {
"url": "https://mcp.dunkapi.com/mcp"
}
}
}リモートエンドポイント
https://mcp.dunkapi.com/mcpstreamable-httpできること
ツール一覧
ツール（18）
🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢list_teams(season, league)
Use to find team ids and abbreviations for a season (default: the latest). Every other tool takes a team as an id or abbreviation. Pass league for the WNBA (wnba) or college (ncaam, ncaaw); default NBA. Costs 1 credit.
入力スキーマ
{
"type": "object",
"properties": {
"season": {
"description": "Season by the year it ends: 2025 = 2024-25. WNBA: the calendar year.",
"type": [
"number",
"string"
]
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam",
"ncaaw"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"season": {
"type": [
"number",
"null"
]
},
"teams": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
}
},
"required": [
"season",
"teams",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_games(season, season_type, team, date, from, ...)
Use to list games with scores by season, date, date range or team, newest first. For upcoming games with lines use get_schedule; for one game's box score use get_game. Costs 2 credits.
入力スキーマ
{
"type": "object",
"properties": {
"season": {
"description": "Season by the year it ends: 2025 = 2024-25.",
"type": [
"number",
"string"
]
},
"season_type": {
"description": "regular, postseason, play_in or preseason.",
"type": "string",
"enum": [
"regular",
"postseason",
"play_in",
"preseason"
]
},
"team": {
"description": "Team id or abbreviation.",
"type": "string"
},
"date": {
"description": "One date, YYYY-MM-DD (US Eastern).",
"type": "string"
},
"from": {
"description": "From date, YYYY-MM-DD.",
"type": "string"
},
"to": {
"description": "To date, YYYY-MM-DD.",
"type": "string"
},
"status": {
"type": "string",
"enum": [
"scheduled",
"final"
]
},
"limit": {
"description": "Max games (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"description": "Page offset; use next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam",
"ncaaw"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"games": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"required": [
"games",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_schedule(days, team, league)
Use for upcoming games (next 1-30 days, default 7) with the median line across posted sportsbooks: spread, total and moneylines. For every book's line use get_odds. Costs 2 credits.
入力スキーマ
{
"type": "object",
"properties": {
"days": {
"description": "Days ahead (default 7).",
"type": "integer",
"minimum": 1,
"maximum": 30
},
"team": {
"description": "Team id or abbreviation.",
"type": "string"
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam",
"ncaaw"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"days": {
"type": "number"
},
"games": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
}
},
"required": [
"days",
"games",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_game(game_id, league)
Use for one game in full: score, both teams' box scores, every player's line, each sportsbook's opening and closing line, and the win-probability range. For the play-by-play use get_plays. Costs 5 credits.
入力スキーマ
{
"type": "object",
"properties": {
"game_id": {
"type": "string",
"description": "ESPN game id, from list_games or get_schedule."
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam",
"ncaaw"
]
}
},
"required": [
"game_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"game": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"team_stats": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"players": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"odds": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"win_probability": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"plays": {
"type": "number"
},
"box_score_note": {
"type": "string"
}
},
"required": [
"game",
"team_stats",
"players",
"odds",
"win_probability",
"plays"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_standings(season, league)
Use for a season's regular-season standings computed from every final game: overall, conference, home and away records, points for and against, margin and last 10. Costs 2 credits.
入力スキーマ
{
"type": "object",
"properties": {
"season": {
"description": "Season by the year it ends (default: the latest).",
"type": [
"number",
"string"
]
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam",
"ncaaw"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"season": {
"type": [
"number",
"null"
]
},
"standings": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"season",
"standings",
"count",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_injuries(team, date, league)
Use for the injury report: every listed player's status (out, day-to-day), injury and expected return, as captured on the latest day (or the latest on or before date). NBA and WNBA. Costs 2 credits.
入力スキーマ
{
"type": "object",
"properties": {
"team": {
"description": "One team (id or abbreviation).",
"type": "string"
},
"date": {
"description": "The report as of this day, YYYY-MM-DD (default: the latest).",
"type": "string"
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba.",
"type": "string",
"enum": [
"nba",
"wnba"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"date": {
"type": [
"string",
"null"
]
},
"injuries": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"date",
"injuries",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢search_players(name, limit, league)
Use to find a player's id by name (partial names work), most recent players first. Pass league for the WNBA (wnba) or college (ncaam, ncaaw); default NBA. Costs 1 credit.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Full or partial name."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam",
"ncaaw"
]
}
},
"required": [
"name"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"players": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
}
},
"required": [
"players",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_player(player_id, league)
Use for a player's profile, per-season averages and shooting splits (regular season and postseason separately) and last 10 games. For every game use get_player_games. Costs 5 credits.
入力スキーマ
{
"type": "object",
"properties": {
"player_id": {
"type": "string",
"description": "ESPN athlete id, from search_players."
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam",
"ncaaw"
]
}
},
"required": [
"player_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"player": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"seasons": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"recent_games": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"player",
"seasons",
"recent_games"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_player_games(player_id, season, season_type, limit, offset, ...)
Use for a player's game log: every game's box-score line with opponent and result, newest first, optionally one season. Costs 5 credits.
入力スキーマ
{
"type": "object",
"properties": {
"player_id": {
"type": "string",
"description": "ESPN athlete id."
},
"season": {
"description": "Season by the year it ends: 2025 = 2024-25 (default: the latest).",
"type": [
"number",
"string"
]
},
"season_type": {
"type": "string",
"enum": [
"regular",
"postseason",
"play_in",
"preseason"
]
},
"limit": {
"description": "Max games (default 100).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam",
"ncaaw"
]
}
},
"required": [
"player_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"player_id": {
"type": "string"
},
"games": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"required": [
"player_id",
"games",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_leaders(stat, season, season_type, min_games, limit, ...)
Use for a season's statistical leaders (per game, shooting percentages with a volume floor, or totals) from every box score. Costs 5 credits.
入力スキーマ
{
"type": "object",
"properties": {
"stat": {
"type": "string",
"enum": [
"pts",
"reb",
"ast",
"stl",
"blk",
"tpm",
"min",
"plus_minus",
"fg_pct",
"tp_pct",
"ft_pct",
"ts_pct",
"total_pts"
],
"description": "Stat to rank by."
},
"season": {
"description": "Season by the year it ends: 2025 = 2024-25 (default: the latest).",
"type": [
"number",
"string"
]
},
"season_type": {
"description": "Default regular.",
"type": "string",
"enum": [
"regular",
"postseason",
"play_in",
"preseason"
]
},
"min_games": {
"description": "Minimum games played (default: a quarter of the season).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam",
"ncaaw"
]
}
},
"required": [
"stat"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"stat": {
"type": "string"
},
"label": {
"type": "string"
},
"season": {
"type": [
"number",
"null"
]
},
"min_games": {
"type": "number"
},
"leaders": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
}
},
"required": [
"stat",
"label",
"season",
"min_games",
"leaders",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_team_stats(season, season_type, team, league)
Use for team efficiency for a season: pace, offensive, defensive and net rating per 100 possessions, the four factors (eFG%, turnover %, offensive rebound %, free throw rate) and three-point rate, from every box score. Costs 5 credits.
入力スキーマ
{
"type": "object",
"properties": {
"season": {
"description": "Season by the year it ends: 2025 = 2024-25 (default: the latest).",
"type": [
"number",
"string"
]
},
"season_type": {
"type": "string",
"enum": [
"regular",
"postseason",
"play_in",
"preseason"
]
},
"team": {
"description": "One team (id or abbreviation).",
"type": "string"
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam",
"ncaaw"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"season": {
"type": [
"number",
"null"
]
},
"teams": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"method": {
"type": "string"
}
},
"required": [
"season",
"teams",
"count",
"method"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_plays(game_id, player_id, team, season, season_type, ...)
Use for play-by-play: every event of a game, or a player's or team's plays across a season, with shot location (feet), zone, our expected points, the score and the home win probability after each play (2018 on). Filter to shots, makes or misses, a zone, a period or clutch time. Pass league for the WNBA (wnba) or college (ncaam, ncaaw); default NBA. Costs 10 credits.
入力スキーマ
{
"type": "object",
"properties": {
"game_id": {
"description": "One game: every play in order.",
"type": "string"
},
"player_id": {
"description": "A player's plays (with season).",
"type": "string"
},
"team": {
"description": "A team's plays (id or abbreviation).",
"type": "string"
},
"season": {
"description": "Season by the year it ends (default: the latest; ignored with game_id).",
"type": [
"number",
"string"
]
},
"season_type": {
"type": "string",
"enum": [
"regular",
"postseason",
"play_in",
"preseason"
]
},
"shots_only": {
"description": "Field goal and free throw attempts only.",
"type": "boolean"
},
"made": {
"description": "Only made (true) or missed (false) shots.",
"type": "boolean"
},
"zone": {
"description": "One shot zone.",
"type": "string",
"enum": [
"restricted_area",
"paint",
"midrange",
"corner_3",
"above_break_3",
"free_throw"
]
},
"period": {
"type": "integer",
"minimum": 1,
"maximum": 10
},
"clutch": {
"description": "Last 5 minutes of the 4th quarter (college men: 2nd half) or overtime, score within 5.",
"type": "boolean"
},
"limit": {
"description": "Max plays (default 200).",
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam",
"ncaaw"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"plays": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"required": [
"plays",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_shot_chart(player_id, team, opponent, game_id, season, ...)
Use for a shot profile: attempts, makes, percentage, points per shot and expected points per shot in each zone (restricted area, paint, midrange, corner three, above-the-break three, free throws) for a player, a team, a team's opponents or one game. include_shots adds every located shot's x/y and result for drawing a chart. Costs 10 credits.
入力スキーマ
{
"type": "object",
"properties": {
"player_id": {
"type": "string"
},
"team": {
"description": "Team id or abbreviation.",
"type": "string"
},
"opponent": {
"description": "With team: the shots its opponents took (its defence).",
"type": "boolean"
},
"game_id": {
"type": "string"
},
"season": {
"description": "Season by the year it ends (default: the latest).",
"type": [
"number",
"string"
]
},
"season_type": {
"type": "string",
"enum": [
"regular",
"postseason",
"play_in",
"preseason"
]
},
"include_shots": {
"description": "Add each shot's x, y and result (up to 3,000).",
"type": "boolean"
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba.",
"type": "string",
"enum": [
"nba",
"wnba"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"season": {
"type": [
"number",
"null"
]
},
"zones": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"field_goal_attempts": {
"type": "number"
},
"share": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"number",
"null"
]
}
},
"shots": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"shots_note": {
"type": "string"
},
"note": {
"type": "string"
},
"unlocated_attempts": {
"type": "number"
},
"unlocated_note": {
"type": "string"
}
},
"required": [
"season",
"zones",
"field_goal_attempts"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_odds(game_id, date, league)
Use for betting lines: each sportsbook's moneyline, spread and total for a game (opening and closing per book from July 2020 from The Odds API, and from 2023-24 from ESPN; ESPN's final line only before that), with implied probabilities and, for finished games, whether the home side covered and the total went over against the median close. Pass game_id for one game (5 credits) or date for a day's games (10 credits).
入力スキーマ
{
"type": "object",
"properties": {
"game_id": {
"description": "One game.",
"type": "string"
},
"date": {
"description": "A day's games, YYYY-MM-DD (US Eastern).",
"type": "string"
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam",
"ncaaw"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"games": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"note": {
"type": "string"
},
"estimate_only": {
"type": "boolean"
},
"tool": {
"type": "string"
},
"credits": {
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_line_movement(game_id, provider, league)
Use to see how a game's line moved before tip-off: our pre-game snapshots of each sportsbook's moneyline, spread and total (ESPN's once a day, The Odds API's every hour for games in the next two days). Costs 10 credits.
入力スキーマ
{
"type": "object",
"properties": {
"game_id": {
"type": "string",
"description": "Game id."
},
"provider": {
"description": "One sportsbook, e.g. DraftKings.",
"type": "string"
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam",
"ncaaw"
]
}
},
"required": [
"game_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"game": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"movement": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"snapshots": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"game",
"movement",
"snapshots"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_ratings(season, league)
Use for our team power ratings (Elo from every final game in our data), ranked, as of the end of a season or today. Costs 2 credits.
入力スキーマ
{
"type": "object",
"properties": {
"season": {
"description": "Season by the year it ends (default: the latest).",
"type": [
"number",
"string"
]
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam",
"ncaaw"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"season": {
"type": [
"number",
"null"
]
},
"ratings": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"method": {
"type": "string"
}
},
"required": [
"season",
"ratings",
"count",
"method"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_player_props(game_id, player_id, from_date, to_date, market, ...)
Use for player prop lines by sportsbook: over/under on points, rebounds, assists, threes, points + rebounds + assists, blocks and steals, from May 2023 for the NBA and WNBA and the 2023-24 season for men's college basketball (DraftKings, FanDuel, BetMGM, ESPN BET, Pinnacle and others). Pass game_id for every player's props in one game (10 credits), or player_id with from_date (and to_date) for one player across games (10 credits per game returned, up to 100). Returns the closing line by default (the last before the game starts) or the opening line, with each book's over and under prices. Set estimate_only to get the price without being charged.
入力スキーマ
{
"type": "object",
"properties": {
"game_id": {
"description": "Game id: every player's props for that game.",
"type": "string"
},
"player_id": {
"description": "Player id (e.g. 3945274) from search_players. With from_date: that player's props across games.",
"type": "string"
},
"from_date": {
"description": "With player_id: first date, YYYY-MM-DD (the game's date).",
"type": "string"
},
"to_date": {
"description": "With player_id: last date (default: no end), YYYY-MM-DD (the game's date).",
"type": "string"
},
"market": {
"description": "One market: player_points (points), player_rebounds (rebounds), player_assists (assists), player_threes (three-pointers made), player_points_rebounds_assists (points + rebounds + assists), player_blocks (blocks), player_steals (steals)",
"type": "string",
"enum": [
"player_points",
"player_rebounds",
"player_assists",
"player_threes",
"player_points_rebounds_assists",
"player_blocks",
"player_steals"
]
},
"bookmaker": {
"description": "Bookmaker key, e.g. draftkings, fanduel, pinnacle.",
"type": "string"
},
"snapshot_type": {
"description": "closing (default): the last line before the game starts. opening: the first one captured.",
"type": "string",
"enum": [
"opening",
"closing"
]
},
"estimate_only": {
"description": "Return what this call would cost, without charging or running it.",
"type": "boolean"
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"snapshot_type": {
"type": "string"
},
"games": {
"type": "number"
},
"props": {
"type": "array",
"items": {
"type": "object",
"properties": {
"game_id": {
"type": "string"
},
"game_date": {
"type": [
"string",
"null"
]
},
"player_name": {
"type": "string"
},
"player_id": {
"type": [
"string",
"number",
"null"
]
},
"market": {
"type": "string"
},
"bookmaker": {
"type": "string"
},
"line": {
"type": [
"number",
"null"
]
},
"over_odds": {
"type": [
"number",
"null"
]
},
"under_odds": {
"type": [
"number",
"null"
]
},
"captured_at": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"game_id",
"game_date",
"player_name",
"player_id",
"market",
"bookmaker",
"line",
"over_odds",
"under_odds",
"captured_at",
"source"
],
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"credits_per_game": {
"type": "number"
},
"next_from_date": {
"type": [
"string",
"null"
]
},
"note": {
"type": "string"
},
"estimate_only": {
"type": "boolean"
},
"tool": {
"type": "string"
},
"credits": {
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_prop_history(player_id, market, from_date, to_date, bookmaker, ...)
Use to see how a player did against his prop line over time: for one market (points, rebounds, assists, threes, points + rebounds + assists, blocks or steals), one row per game with the closing line (the median across books, or one book's), the opening line, the prices, what the player actually recorded from our box scores and the result against the line, plus the over rate. Costs 10 credits for up to 200 games.
入力スキーマ
{
"type": "object",
"properties": {
"player_id": {
"type": "string",
"description": "Player id (e.g. 3945274) from search_players."
},
"market": {
"type": "string",
"enum": [
"player_points",
"player_rebounds",
"player_assists",
"player_threes",
"player_points_rebounds_assists",
"player_blocks",
"player_steals"
],
"description": "The market: player_points (points), player_rebounds (rebounds), player_assists (assists), player_threes (three-pointers made), player_points_rebounds_assists (points + rebounds + assists), player_blocks (blocks), player_steals (steals)"
},
"from_date": {
"description": "First date, YYYY-MM-DD (the game's date).",
"type": "string"
},
"to_date": {
"description": "Last date, YYYY-MM-DD (the game's date).",
"type": "string"
},
"bookmaker": {
"description": "One book's closing line instead of the median across books, e.g. draftkings.",
"type": "string"
},
"limit": {
"description": "Games to return, oldest first (default 50, max 200). next_from_date says where to continue.",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"league": {
"description": "League. Defaults to nba. One of: nba, wnba, ncaam.",
"type": "string",
"enum": [
"nba",
"wnba",
"ncaam"
]
}
},
"required": [
"player_id",
"market"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"player_id": {
"type": [
"string",
"number"
]
},
"player_name": {
"type": [
"string",
"null"
]
},
"market": {
"type": "string"
},
"stat": {
"type": "string"
},
"bookmaker": {
"type": [
"string",
"null"
]
},
"games": {
"type": "array",
"items": {
"type": "object",
"properties": {
"game_id": {
"type": "string"
},
"game_date": {
"type": [
"string",
"null"
]
},
"line": {
"type": [
"number",
"null"
]
},
"open_line": {
"type": [
"number",
"null"
]
},
"over_odds": {
"type": [
"number",
"null"
]
},
"under_odds": {
"type": [
"number",
"null"
]
},
"books": {
"type": "number"
},
"actual": {
"type": [
"number",
"null"
]
},
"result": {
"anyOf": [
{
"type": "string",
"enum": [
"over",
"under",
"push"
]
},
{
"type": "null"
}
]
},
"margin": {
"type": [
"number",
"null"
]
}
},
"required": [
"game_id",
"game_date",
"line",
"open_line",
"over_odds",
"under_odds",
"books",
"actual",
"result",
"margin"
],
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"summary": {
"type": "object",
"properties": {
"games": {
"type": "number"
},
"graded": {
"type": "number"
},
"overs": {
"type": "number"
},
"unders": {
"type": "number"
},
"pushes": {
"type": "number"
},
"over_rate": {
"type": [
"number",
"null"
]
},
"avg_line": {
"type": [
"number",
"null"
]
},
"avg_actual": {
"type": [
"number",
"null"
]
}
},
"required": [
"games",
"graded",
"overs",
"unders",
"pushes",
"over_rate",
"avg_line",
"avg_actual"
],
"additionalProperties": false
},
"truncated": {
"type": "boolean"
},
"next_from_date": {
"type": [
"string",
"null"
]
},
"note": {
"type": "string"
},
"estimate_only": {
"type": "boolean"
},
"tool": {
"type": "string"
},
"credits": {
"type": "number"
}
},
"required": [
"player_id",
"player_name",
"market",
"stat",
"bookmaker",
"games",
"count",
"summary"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 18 件