StrikerAPI
Premier League, MLS and European football: lineups, shot maps, xG, tables and odds. REST and MCP.
我該用這個嗎
品質與安全性
A
根據工具定義與協定合規性的自動化分析。
上下文成本
~8,732Token（工具定義）
~3.9 KB典型回應大小
顯著的注意力影響（128k 上下文的 6.82%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"strikerapi": {
"url": "https://mcp.strikerapi.com/mcp"
}
}
}遠端端點
https://mcp.strikerapi.com/mcpstreamable-http它能做什麼
工具清單
工具（19）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢list_teams(season, league)
Use to find club ids and abbreviations for a season (default: the latest). Every other tool takes a club as an id, abbreviation or name. Pass league for MLS (mls), La Liga (laliga), Serie A (seriea), the Bundesliga (bundesliga), Ligue 1 (ligue1), the Champions League (ucl), the EFL Championship (championship), the NWSL (nwsl), Liga MX (ligamx), the Europa League (uel), the Conference League (uecl), the Eredivisie (eredivisie), the Primeira Liga (primeira), the Scottish Premiership (scotland), Brazil's Serie A (brazil) or Argentina's Liga Profesional (argentina); default: the Premier League. Costs 1 credit.
輸入結構描述
{
"type": "object",
"properties": {
"season": {
"description": "Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest.",
"type": [
"number",
"string"
]
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"$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, stage, team, date, from, ...)
Use to list fixtures and results by season, stage, date, date range or club, newest first. For upcoming fixtures with lines use get_schedule; for one match in full use get_game. Costs 2 credits.
輸入結構描述
{
"type": "object",
"properties": {
"season": {
"description": "Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest.",
"type": [
"number",
"string"
]
},
"stage": {
"description": "league = league-table games (regular season, group stage, league phase); knockout = qualifying, knockout rounds and playoffs.",
"type": "string",
"enum": [
"league",
"knockout"
]
},
"team": {
"description": "Club id, abbreviation or name.",
"type": "string"
},
"date": {
"description": "One date, YYYY-MM-DD (UTC).",
"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 matches (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 soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"$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 fixtures (next 1-30 days, default 7) with the median three-way line across posted sportsbooks (home, draw, away moneylines, goal total, handicap) and its implied probabilities. 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": "Club id, abbreviation or name.",
"type": "string"
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"$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 match in full: score (with shootout), both clubs' box scores (possession, shots, xG, passing, discipline), every player's line, the key events (goals, cards, substitutions, penalties, VAR) and each sportsbook's opening and closing line. For every event use get_events; for formations use get_lineups. Costs 5 credits.
輸入結構描述
{
"type": "object",
"properties": {
"game_id": {
"type": "string",
"description": "ESPN match id, from list_games or get_schedule."
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"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": {}
}
},
"key_events": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"odds": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"box_score_note": {
"type": "string"
}
},
"required": [
"game",
"team_stats",
"players",
"key_events",
"odds"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_lineups(game_id, league)
Use for a match's lineups: each club's formation, starting XI with positions and formation slots, the substitutes used with the minute they came on (and who went off when), and the unused bench. Costs 5 credits.
輸入結構描述
{
"type": "object",
"properties": {
"game_id": {
"type": "string",
"description": "ESPN match id, from list_games or get_schedule."
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"required": [
"game_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"game": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"lineups": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"game",
"lineups"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_standings(season, league)
Use for a season's league table: rank, played, won, drawn, lost, goals for and against, goal difference, points (official, with any deduction), qualification or relegation note, plus home and away records and recent form. Champions League: one table per group or the league phase. Costs 2 credits.
輸入結構描述
{
"type": "object",
"properties": {
"season": {
"description": "Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest.",
"type": [
"number",
"string"
]
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, uel, uecl, eredivisie, primeira, scotland, brazil.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"season": {
"type": [
"number",
"null"
]
},
"source": {
"type": "string"
},
"standings": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"season",
"source",
"standings",
"count",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_ratings(date, limit, league)
Use for our club Elo ratings, strongest first, as of the latest match (or as of date). A 100-point gap is about a 64% expected score for the stronger side at a neutral venue. Costs 2 credits.
輸入結構描述
{
"type": "object",
"properties": {
"date": {
"description": "Ratings as of this day, YYYY-MM-DD (default: the latest).",
"type": "string"
},
"limit": {
"description": "Max clubs (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"ratings": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"method": {
"type": "string"
}
},
"required": [
"as_of",
"ratings",
"count",
"method"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_head_to_head(team, opponent, limit, league)
Use for two clubs' meetings in this competition: wins, draws and goals each, the first meeting, and the results newest first. Costs 2 credits.
輸入結構描述
{
"type": "object",
"properties": {
"team": {
"type": "string",
"description": "Club id, abbreviation or name."
},
"opponent": {
"type": "string",
"description": "The other club."
},
"limit": {
"description": "Max results listed (default 20); the summary counts every meeting.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"required": [
"team",
"opponent"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"teams": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"summary": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"games": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
}
},
"required": [
"teams",
"summary",
"games",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢search_players(name, team, limit, league)
Use to find a player's id by name (accents optional), optionally within a club. Returns position, current club, last season and appearances. Costs 1 credit.
輸入結構描述
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Full or partial name, e.g. Saka."
},
"team": {
"description": "Club id, abbreviation or name.",
"type": "string"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"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 one player: profile, per-season appearances, starts, minutes, goals, assists, shots, our xG, cards and goalkeeping (saves, clean sheets) with per-90 rates, and the last 10 matches. Costs 5 credits.
輸入結構描述
{
"type": "object",
"properties": {
"player_id": {
"type": "string",
"description": "ESPN player id (search_players)."
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"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, limit, offset, league)
Use for a player's match log, newest first: opponent, score, minutes on and off, goals, assists, shots, xG, fouls, cards and goalkeeping. Costs 5 credits.
輸入結構描述
{
"type": "object",
"properties": {
"player_id": {
"type": "string",
"description": "ESPN player id."
},
"season": {
"description": "One season (the year it starts).",
"type": [
"number",
"string"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"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, per90, min_games, limit, ...)
Use for a season's leaders in goals, assists, goal contributions, shots, shots on target, our xG, cards, saves or clean sheets, as totals or per 90 minutes (per90, with a minimum of 10 matches by default). Costs 5 credits.
輸入結構描述
{
"type": "object",
"properties": {
"stat": {
"description": "Default goals.",
"type": "string",
"enum": [
"goals",
"assists",
"goal_contributions",
"shots",
"shots_on_target",
"xg",
"yellow_cards",
"red_cards",
"saves",
"clean_sheets"
]
},
"season": {
"description": "Season by the year it starts (default: the latest).",
"type": [
"number",
"string"
]
},
"per90": {
"description": "Rank by the rate per 90 minutes.",
"type": "boolean"
},
"min_games": {
"description": "Minimum appearances.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"$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"
},
"note": {
"type": "string"
}
},
"required": [
"stat",
"label",
"season",
"min_games",
"leaders",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_team_stats(season, team, league)
Use for clubs' per-match averages over a season, for and against: goals, our xG, shots, shots on target, possession, pass accuracy, corners, fouls, cards, tackles, clean sheets. Costs 5 credits.
輸入結構描述
{
"type": "object",
"properties": {
"season": {
"description": "Season by the year it starts (default: the latest).",
"type": [
"number",
"string"
]
},
"team": {
"description": "One club.",
"type": "string"
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"$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_events(game_id, kind, limit, offset, league)
Use for a match's events in order: goals (with assister, own goals, penalties), shots with location, outcome, body part and our xG, cards, substitutions, fouls, corners, offsides and VAR decisions. Filter with kind. Older matches carry goals, cards and substitutions only. Costs 10 credits.
輸入結構描述
{
"type": "object",
"properties": {
"game_id": {
"type": "string",
"description": "ESPN match id."
},
"kind": {
"description": "goals, shots, cards, substitutions, set_pieces, fouls or all (default).",
"type": "string",
"enum": [
"goals",
"shots",
"cards",
"substitutions",
"set_pieces",
"fouls",
"all"
]
},
"limit": {
"description": "Max events (default 300).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Page offset; use next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"required": [
"game_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"events": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"next_offset": {
"type": [
"number",
"null"
]
},
"note": {
"type": "string"
}
},
"required": [
"events",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_shot_map(team, player, against, season, game_id, ...)
Use for a shot map: a club's shots (or, with against, the shots it conceded), a player's, or one match's, for a season (default: the latest). Returns totals and zones (six-yard box, penalty area, outside the box, penalties) with goals, shots on target, xG and conversion, and every located shot with its x/y, end point, outcome and xG. Costs 10 credits.
輸入結構描述
{
"type": "object",
"properties": {
"team": {
"description": "Club id, abbreviation or name.",
"type": "string"
},
"player": {
"description": "Player id (search_players).",
"type": "string"
},
"against": {
"description": "With team: the shots it conceded.",
"type": "boolean"
},
"season": {
"description": "Season by the year it starts (default: the latest).",
"type": [
"number",
"string"
]
},
"game_id": {
"description": "One match instead of a season.",
"type": "string"
},
"include_shots": {
"description": "false = totals and zones only.",
"type": "boolean"
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"$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": {}
}
},
"shots_total": {
"type": "number"
},
"totals": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"shots": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"shots_note": {
"type": "string"
},
"unlocated_shots": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"season",
"zones",
"shots_total",
"totals"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_odds(game_id, date, season, team, limit, ...)
Use for betting lines: each sportsbook's three-way moneyline (home, draw, away), goal handicap and total (opening and closing from June 2020 for 16 competitions from The Odds API, and from 2024 from ESPN; ESPN's final pre-match line before that), the no-margin probabilities each book's prices imply, and for finished matches the result and whether the total went over against the median close. Pass game_id for one match (5 credits), date for a day's matches (10 credits), or season (optionally a team) for a season of priced matches, 2 credits per match returned, up to 100 a page.
輸入結構描述
{
"type": "object",
"properties": {
"game_id": {
"description": "One match.",
"type": "string"
},
"date": {
"description": "A day's matches, YYYY-MM-DD (UTC).",
"type": "string"
},
"season": {
"description": "A season of priced matches, by the year it starts (2025 = 2025-26; MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year).",
"type": [
"number",
"string"
]
},
"team": {
"description": "With season: one club's matches.",
"type": "string"
},
"limit": {
"description": "With season: matches per page (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "With season: page offset; use next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"$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"
]
},
"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 match's line moved before kick-off: our pre-game snapshots of each sportsbook's three-way moneyline, handicap and total (ESPN's once a day, The Odds API's every hour for matches in the next two days). Costs 10 credits.
輸入結構描述
{
"type": "object",
"properties": {
"game_id": {
"type": "string",
"description": "Match id."
},
"provider": {
"description": "One sportsbook, e.g. DraftKings.",
"type": "string"
},
"league": {
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
]
}
},
"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_player_props(game_id, player_id, from_date, to_date, market, ...)
Use for player prop lines by sportsbook: the anytime goalscorer price, Yes in over_odds (and No in under_odds where a book posts it), with no line, from DraftKings, FanDuel, William Hill and Pinnacle as the archive holds them. 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. 280555) 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_goal_scorer_anytime (anytime goalscorer (over = scores))",
"type": "string",
"enum": [
"player_goal_scorer_anytime"
]
},
"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 soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl"
]
}
},
"$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 (anytime goalscorer: one row per match with the closing price and whether he scored), 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. over_odds is the Yes price; result is over when he scored, under when he played and did not, and null when he was not in the squad or on the pitch (a void).
輸入結構描述
{
"type": "object",
"properties": {
"player_id": {
"type": "string",
"description": "Player id (e.g. 280555) from search_players."
},
"market": {
"type": "string",
"enum": [
"player_goal_scorer_anytime"
],
"description": "The market: player_goal_scorer_anytime (anytime goalscorer (over = scores))"
},
"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 soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl.",
"type": "string",
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl"
]
}
},
"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
}社群
證據
近期觀測
已驗證未記錄版本19 個工具