StrikerAPI is an MCP server published by io.github.noahowsh, hosted at mcp.strikerapi.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 25 tools, including list_teams, list_games, get_schedule, get_game, get_lineups.
Premier League, MLS and European football: lineups, shot maps, xG, tables and odds. REST and MCP.
19 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 to find club ids and abbreviations for a season (default: the latest), with each club's colour, second colour, a readable text colour on it and logo. 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.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
| season | ["number","string"] | Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest. |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
{
"name": "list_teams",
"title": "List teams",
"description": "Use to find club ids and abbreviations for a season (default: the latest), with each club's colour, second colour, a readable text colour on it and logo. 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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
},
"season": {
"type": [
"number",
"string"
],
"description": "Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"season",
"teams",
"count"
],
"properties": {
"count": {
"type": "number"
},
"teams": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"season": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "List teams",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| to | string | To date, YYYY-MM-DD. |
| date | string | One date, YYYY-MM-DD (a UTC day unless timezone is given). |
| from | string | From date, YYYY-MM-DD. |
| team | string | Club id, abbreviation or name. |
| limit | integer | Max matches (default 50). |
| stage | string | league = league-table games (regular season, group stage, league phase); knockout = qualifying, knockout rounds and playoffs. |
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
| offset | integer | Page offset; use next_offset. |
| season | ["number","string"] | Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest. |
| status | string | one of ["scheduled","final"] |
| timezone | string | Read date, from and to as days in this IANA time zone (America/New_York, America/Mexico_City). Default UTC, where an evening kickoff in the Americas falls on the next day. |
{
"name": "list_games",
"title": "List games",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"to": {
"type": "string",
"description": "To date, YYYY-MM-DD."
},
"date": {
"type": "string",
"description": "One date, YYYY-MM-DD (a UTC day unless timezone is given)."
},
"from": {
"type": "string",
"description": "From date, YYYY-MM-DD."
},
"team": {
"type": "string",
"description": "Club id, abbreviation or name."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Max matches (default 50)."
},
"stage": {
"enum": [
"league",
"knockout"
],
"type": "string",
"description": "league = league-table games (regular season, group stage, league phase); knockout = qualifying, knockout rounds and playoffs."
},
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Page offset; use next_offset."
},
"season": {
"type": [
"number",
"string"
],
"description": "Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest."
},
"status": {
"enum": [
"scheduled",
"final"
],
"type": "string"
},
"timezone": {
"type": "string",
"description": "Read date, from and to as days in this IANA time zone (America/New_York, America/Mexico_City). Default UTC, where an evening kickoff in the Americas falls on the next day."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"games",
"count"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"games": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "List games",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Days ahead (default 7). |
| team | string | Club id, abbreviation or name. |
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
{
"name": "get_schedule",
"title": "Schedule",
"description": "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. 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 (default 7)."
},
"team": {
"type": "string",
"description": "Club id, abbreviation or name."
},
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"days",
"games",
"count"
],
"properties": {
"days": {
"type": "number"
},
"count": {
"type": "number"
},
"games": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Schedule",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
| game_id * | string | Match id, from list_games or get_schedule. |
{
"name": "get_game",
"title": "Game",
"description": "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. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id"
],
"properties": {
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
},
"game_id": {
"type": "string",
"description": "Match id, from list_games or get_schedule."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game",
"team_stats",
"players",
"key_events",
"odds"
],
"properties": {
"game": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"odds": {
"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": {}
}
},
"team_stats": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"box_score_note": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Game",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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. Before kick-off it returns the club-confirmed team sheet (source live) from about an hour before the match; until clubs publish, lineups is empty with a note and nothing is charged. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
| game_id * | string | Match id, from list_games or get_schedule. |
{
"name": "get_lineups",
"title": "Lineups",
"description": "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. Before kick-off it returns the club-confirmed team sheet (source live) from about an hour before the match; until clubs publish, lineups is empty with a note and nothing is charged. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id"
],
"properties": {
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
},
"game_id": {
"type": "string",
"description": "Match id, from list_games or get_schedule."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game",
"lineups"
],
"properties": {
"game": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"note": {
"type": "string"
},
"source": {
"enum": [
"live",
"none"
],
"type": "string"
},
"lineups": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Lineups",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, uel, uecl, eredivisie, primeira, scotland, brazil. |
| season | ["number","string"] | Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest. |
{
"name": "get_standings",
"title": "Standings",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, uel, uecl, eredivisie, primeira, scotland, brazil."
},
"season": {
"type": [
"number",
"string"
],
"description": "Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"season",
"source",
"standings",
"count",
"note"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"season": {
"type": [
"number",
"null"
]
},
"source": {
"type": "string"
},
"standings": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Standings",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| date | string | Ratings as of this day, YYYY-MM-DD (default: the latest). |
| limit | integer | Max clubs (default 50). |
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
{
"name": "get_ratings",
"title": "Ratings",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"date": {
"type": "string",
"description": "Ratings as of this day, YYYY-MM-DD (default: the latest)."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Max clubs (default 50)."
},
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"as_of",
"ratings",
"count",
"method"
],
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"count": {
"type": "number"
},
"method": {
"type": "string"
},
"ratings": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Ratings",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for two clubs' meetings in this competition in our data, which starts in 2001-02 in the oldest leagues: wins, draws and goals each, the first meeting we hold, and the results newest first. Costs 2 credits.
| Parameter | Type | Description |
|---|---|---|
| team * | string | Club id, abbreviation or name. |
| limit | integer | Max results listed (default 20); the summary counts every meeting. |
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
| opponent * | string | The other club. |
{
"name": "get_head_to_head",
"title": "Head to head",
"description": "Use for two clubs' meetings in this competition in our data, which starts in 2001-02 in the oldest leagues: wins, draws and goals each, the first meeting we hold, and the results newest first. Costs 2 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"team",
"opponent"
],
"properties": {
"team": {
"type": "string",
"description": "Club id, abbreviation or name."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max results listed (default 20); the summary counts every meeting."
},
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
},
"opponent": {
"type": "string",
"description": "The other club."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"teams",
"summary",
"games",
"count"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"games": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"teams": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"summary": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Head to head",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Full or partial name, e.g. Saka. |
| team | string | Club id, abbreviation or name. |
| limit | integer | |
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
{
"name": "search_players",
"title": "Search players",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Full or partial name, e.g. Saka."
},
"team": {
"type": "string",
"description": "Club id, abbreviation or name."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"players",
"count"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"players": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search players",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for a club's current squad, or every club's in the league when team is left out: every registered player with position, shirt number, date of birth, age, citizenship, height and weight, including players not yet named in a matchday squad (new signings, youth players), and how many of the club's matches each has played this season. Refreshed weekly. For the players in one match use get_lineups. Costs 2 credits for a club, 10 for the whole league.
| Parameter | Type | Description |
|---|---|---|
| team | string | Club id, abbreviation or name (list_teams). Leave out for every club in the league, with each player's team. |
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
| position | string | One position. |
{
"name": "get_squad",
"title": "Squad",
"description": "Use for a club's current squad, or every club's in the league when team is left out: every registered player with position, shirt number, date of birth, age, citizenship, height and weight, including players not yet named in a matchday squad (new signings, youth players), and how many of the club's matches each has played this season. Refreshed weekly. For the players in one match use get_lineups. Costs 2 credits for a club, 10 for the whole league.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"team": {
"type": "string",
"description": "Club id, abbreviation or name (list_teams). Leave out for every club in the league, with each player's team."
},
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
},
"position": {
"enum": [
"Goalkeeper",
"Defender",
"Midfielder",
"Forward"
],
"type": "string",
"description": "One position."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"team_id",
"team",
"team_name",
"season",
"updated_at",
"players",
"count"
],
"properties": {
"note": {
"type": "string"
},
"team": {
"type": [
"string",
"null"
]
},
"count": {
"type": "number"
},
"season": {
"type": [
"number",
"null"
]
},
"players": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"team_id": {
"type": [
"string",
"null"
]
},
"team_name": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Squad",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
| player_id * | string | Player id (search_players). |
{
"name": "get_player",
"title": "Player",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player_id"
],
"properties": {
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
},
"player_id": {
"type": "string",
"description": "Player id (search_players)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player",
"seasons",
"recent_games"
],
"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": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Player",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
| offset | integer | |
| season | ["number","string"] | One season (the year it starts). |
| player_id * | string | Player id. |
{
"name": "get_player_games",
"title": "Player games",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"season": {
"type": [
"number",
"string"
],
"description": "One season (the year it starts)."
},
"player_id": {
"type": "string",
"description": "Player id."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player_id",
"games",
"count"
],
"properties": {
"count": {
"type": "number"
},
"games": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"player_id": {
"type": "string"
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Player games",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| stat | string | Default goals. |
| limit | integer | |
| per90 | boolean | Rank by the rate per 90 minutes. |
| stage | string | league = league-table matches; knockout = qualifying, knockouts and playoffs; all. Default league, or all in the European cups. |
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
| season | ["number","string"] | Season by the year it starts (default: the latest). |
| min_games | integer | Minimum appearances. |
{
"name": "get_leaders",
"title": "Leaders",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"stat": {
"enum": [
"goals",
"assists",
"goal_contributions",
"shots",
"shots_on_target",
"xg",
"yellow_cards",
"red_cards",
"saves",
"clean_sheets"
],
"type": "string",
"description": "Default goals."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"per90": {
"type": "boolean",
"description": "Rank by the rate per 90 minutes."
},
"stage": {
"enum": [
"league",
"knockout",
"all"
],
"type": "string",
"description": "league = league-table matches; knockout = qualifying, knockouts and playoffs; all. Default league, or all in the European cups."
},
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
},
"season": {
"type": [
"number",
"string"
],
"description": "Season by the year it starts (default: the latest)."
},
"min_games": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Minimum appearances."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"stat",
"label",
"season",
"min_games",
"leaders",
"count"
],
"properties": {
"note": {
"type": "string"
},
"stat": {
"type": "string"
},
"count": {
"type": "number"
},
"label": {
"type": "string"
},
"stage": {
"type": "string"
},
"season": {
"type": [
"number",
"null"
]
},
"leaders": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"min_games": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Leaders",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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. Possession is missing for some leagues and seasons (for example the Eredivisie before 2020, the Scottish Premiership 2015 to 2023, the NWSL before 2025) and its average covers only matches that have it. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| team | string | One club. |
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
| season | ["number","string"] | Season by the year it starts (default: the latest). |
{
"name": "get_team_stats",
"title": "Team stats",
"description": "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. Possession is missing for some leagues and seasons (for example the Eredivisie before 2020, the Scottish Premiership 2015 to 2023, the NWSL before 2025) and its average covers only matches that have it. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"team": {
"type": "string",
"description": "One club."
},
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
},
"season": {
"type": [
"number",
"string"
],
"description": "Season by the year it starts (default: the latest)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"season",
"teams",
"count",
"method"
],
"properties": {
"count": {
"type": "number"
},
"teams": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"method": {
"type": "string"
},
"season": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Team stats",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| kind | string | goals, shots, cards, substitutions, set_pieces, fouls or all (default). |
| limit | integer | Max events (default 300). |
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
| offset | integer | Page offset; use next_offset. |
| game_id * | string | Match id. |
{
"name": "get_events",
"title": "Events",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id"
],
"properties": {
"kind": {
"enum": [
"goals",
"shots",
"cards",
"substitutions",
"set_pieces",
"fouls",
"all"
],
"type": "string",
"description": "goals, shots, cards, substitutions, set_pieces, fouls or all (default)."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max events (default 300)."
},
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Page offset; use next_offset."
},
"game_id": {
"type": "string",
"description": "Match id."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"events",
"count"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"events": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Events",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| team | string | Club id, abbreviation or name. |
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
| player | string | Player id (search_players). |
| season | ["number","string"] | Season by the year it starts (default: the latest). |
| against | boolean | With team: the shots it conceded. |
| game_id | string | One match instead of a season. |
| include_shots | boolean | false = totals and zones only. |
{
"name": "get_shot_map",
"title": "Shot map",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"team": {
"type": "string",
"description": "Club id, abbreviation or name."
},
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
},
"player": {
"type": "string",
"description": "Player id (search_players)."
},
"season": {
"type": [
"number",
"string"
],
"description": "Season by the year it starts (default: the latest)."
},
"against": {
"type": "boolean",
"description": "With team: the shots it conceded."
},
"game_id": {
"type": "string",
"description": "One match instead of a season."
},
"include_shots": {
"type": "boolean",
"description": "false = totals and zones only."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"season",
"zones",
"shots_total",
"totals"
],
"properties": {
"note": {
"type": "string"
},
"shots": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"zones": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"season": {
"type": [
"number",
"null"
]
},
"totals": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"goals_only": {
"type": "object",
"required": [
"goals",
"matches"
],
"properties": {
"goals": {
"type": "number"
},
"matches": {
"type": "number"
}
},
"additionalProperties": false
},
"shots_note": {
"type": "string"
},
"shots_total": {
"type": "number"
},
"goals_only_note": {
"type": "string"
},
"unlocated_shots": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Shot map",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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 and from 2024 for the rest; before that most books carry one final pre-match line), 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. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| date | string | A day's matches, YYYY-MM-DD (UTC). |
| team | string | With season: one club's matches. |
| limit | integer | With season: matches per page (default 50). |
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
| offset | integer | With season: page offset; use next_offset. |
| season | ["number","string"] | A season of priced matches, by the year it starts (2025 = 2025-26; MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year). |
| game_id | string | One match. |
{
"name": "get_odds",
"title": "Odds",
"description": "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 and from 2024 for the rest; before that most books carry one final pre-match line), 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. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"date": {
"type": "string",
"description": "A day's matches, YYYY-MM-DD (UTC)."
},
"team": {
"type": "string",
"description": "With season: one club's matches."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "With season: matches per page (default 50)."
},
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "With season: page offset; use next_offset."
},
"season": {
"type": [
"number",
"string"
],
"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)."
},
"game_id": {
"type": "string",
"description": "One match."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"note": {
"type": "string"
},
"tool": {
"type": "string"
},
"count": {
"type": "number"
},
"games": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"credits": {
"type": "number"
},
"next_offset": {
"type": [
"number",
"null"
]
},
"estimate_only": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Odds",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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 (captured once a day, and every hour for matches in the next four days). Costs 10 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
| game_id * | string | Match id. |
| provider | string | One sportsbook, e.g. DraftKings. |
| 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 match's line moved before kick-off: our pre-game snapshots of each sportsbook's three-way moneyline, handicap and total (captured once a day, and every hour for matches in the next four days). Costs 10 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id"
],
"properties": {
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
},
"game_id": {
"type": "string",
"description": "Match id."
},
"provider": {
"type": "string",
"description": "One sportsbook, e.g. DraftKings."
},
"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",
"movement",
"snapshots"
],
"properties": {
"game": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"note": {
"type": "string"
},
"movement": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"snapshots": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Line movement",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for player prop lines by sportsbook: the anytime goalscorer price (Yes in over_odds, No in under_odds where posted, no line) and, for the top five leagues, MLS and the Champions League, first and last goalscorer, to be carded, shots on target, shots and assists over/unders (most books post only the over), from DraftKings, FanDuel, William Hill and Pinnacle as the archive holds them. Pass game_id for every player's props in one game, or player_id with from_date (and to_date) for one player across games (up to 100). A game costs 10 credits before it starts and 20 once it has (accounts opened before October 30 2026 pay 10 for every game). Returns the closing line by default (the last before the game starts) or the opening line, with each book's over and under prices. Each row has captured_at, scheduled_start and minutes_before_scheduled_start (negative when captured after the scheduled start); a row is kept when it was captured before the sportsbooks' listed start, which in the NBA is usually about 10 minutes after the scheduled one, so filter on minutes_before_scheduled_start > 0 for a strictly before-schedule backtest. Outside football the archive mostly holds one pre-game capture per line, so the opening and closing lines are usually the same; the opening line differs only where a second capture was taken (live capture from October 2026, and wherever else it is held). Set estimate_only to get the price without being charged. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl. |
| market | string | One market: player_goal_scorer_anytime (anytime goalscorer (over = scores)), player_shots_on_target (shots on target), player_shots (shots), player_assists (assists), player_first_goal_scorer (first goalscorer (over = scores the match's first goal)), player_last_goal_scorer (last goalscorer (over = … |
| game_id | string | Game id: every player's props for that game. |
| to_date | string | With player_id: last date (default: no end), YYYY-MM-DD (the game's date). |
| bookmaker | string | Bookmaker key, e.g. draftkings, fanduel, pinnacle. |
| from_date | string | With player_id: first date, YYYY-MM-DD (the game's date). |
| player_id | string | Player id (e.g. 280555) from search_players. With from_date: that player's props across games. |
| estimate_only | boolean | Return what this call would cost, without charging or running it. |
| snapshot_type | string | closing (default): the last line before the game starts. opening: the first one captured, which is the same capture as the close wherever only one was taken. |
{
"name": "get_player_props",
"title": "Player props",
"description": "Use for player prop lines by sportsbook: the anytime goalscorer price (Yes in over_odds, No in under_odds where posted, no line) and, for the top five leagues, MLS and the Champions League, first and last goalscorer, to be carded, shots on target, shots and assists over/unders (most books post only the over), from DraftKings, FanDuel, William Hill and Pinnacle as the archive holds them. Pass game_id for every player's props in one game, or player_id with from_date (and to_date) for one player across games (up to 100). A game costs 10 credits before it starts and 20 once it has (accounts opened before October 30 2026 pay 10 for every game). Returns the closing line by default (the last before the game starts) or the opening line, with each book's over and under prices. Each row has captured_at, scheduled_start and minutes_before_scheduled_start (negative when captured after the scheduled start); a row is kept when it was captured before the sportsbooks' listed start, which in the NBA is usually about 10 minutes after the scheduled one, so filter on minutes_before_scheduled_start > 0 for a strictly before-schedule backtest. Outside football the archive mostly holds one pre-game capture per line, so the opening and closing lines are usually the same; the opening line differs only where a second capture was taken (live capture from October 2026, and wherever else it is held). Set estimate_only to get the price without being charged. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl."
},
"market": {
"enum": [
"player_goal_scorer_anytime",
"player_shots_on_target",
"player_shots",
"player_assists",
"player_first_goal_scorer",
"player_last_goal_scorer",
"player_to_receive_card"
],
"type": "string",
"description": "One market: player_goal_scorer_anytime (anytime goalscorer (over = scores)), player_shots_on_target (shots on target), player_shots (shots), player_assists (assists), player_first_goal_scorer (first goalscorer (over = scores the match's first goal)), player_last_goal_scorer (last goalscorer (over = scores the match's last goal)), player_to_receive_card (to be carded (over = shown a yellow or red card))"
},
"game_id": {
"type": "string",
"description": "Game id: every player's props for that game."
},
"to_date": {
"type": "string",
"description": "With player_id: last date (default: no end), YYYY-MM-DD (the game's date)."
},
"bookmaker": {
"type": "string",
"description": "Bookmaker key, e.g. draftkings, fanduel, pinnacle."
},
"from_date": {
"type": "string",
"description": "With player_id: first date, YYYY-MM-DD (the game's date)."
},
"player_id": {
"type": "string",
"description": "Player id (e.g. 280555) from search_players. With from_date: that player's props across games."
},
"estimate_only": {
"type": "boolean",
"description": "Return what this call would cost, without charging or running it."
},
"snapshot_type": {
"enum": [
"opening",
"closing"
],
"type": "string",
"description": "closing (default): the last line before the game starts. opening: the first one captured, which is the same capture as the close wherever only one was taken."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"note": {
"type": "string"
},
"tool": {
"type": "string"
},
"count": {
"type": "number"
},
"games": {
"type": "number"
},
"props": {
"type": "array",
"items": {
"type": "object",
"required": [
"game_id",
"game_date",
"player_name",
"player_id",
"market",
"bookmaker",
"line",
"over_odds",
"under_odds",
"captured_at",
"source"
],
"properties": {
"line": {
"type": [
"number",
"null"
]
},
"market": {
"type": "string"
},
"source": {
"type": "string"
},
"game_id": {
"type": "string"
},
"bookmaker": {
"type": "string"
},
"game_date": {
"type": [
"string",
"null"
]
},
"over_odds": {
"type": [
"number",
"null"
]
},
"player_id": {
"type": [
"string",
"number",
"null"
]
},
"under_odds": {
"type": [
"number",
"null"
]
},
"captured_at": {
"type": "string"
},
"player_name": {
"type": "string"
},
"scheduled_start": {
"type": [
"string",
"null"
]
},
"minutes_before_scheduled_start": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"credits": {
"type": "number"
},
"estimate_only": {
"type": "boolean"
},
"snapshot_type": {
"type": "string"
},
"next_from_date": {
"type": [
"string",
"null"
]
},
"credits_per_game": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Player props",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use to see how a player did against his prop line over time: for one market (anytime, first or last goalscorer, to be carded, shots on target, shots or assists: one row per match with the closing price and what he recorded), 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. 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). 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. |
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl. |
| market * | string | The market: player_goal_scorer_anytime (anytime goalscorer (over = scores)), player_shots_on_target (shots on target), player_shots (shots), player_assists (assists), player_first_goal_scorer (first goalscorer (over = scores the match's first goal)), player_last_goal_scorer (last goalscorer (over = … |
| 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 (e.g. 280555) 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 (anytime, first or last goalscorer, to be carded, shots on target, shots or assists: one row per match with the closing price and what he recorded), 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. 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). 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."
},
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl."
},
"market": {
"enum": [
"player_goal_scorer_anytime",
"player_shots_on_target",
"player_shots",
"player_assists",
"player_first_goal_scorer",
"player_last_goal_scorer",
"player_to_receive_card"
],
"type": "string",
"description": "The market: player_goal_scorer_anytime (anytime goalscorer (over = scores)), player_shots_on_target (shots on target), player_shots (shots), player_assists (assists), player_first_goal_scorer (first goalscorer (over = scores the match's first goal)), player_last_goal_scorer (last goalscorer (over = scores the match's last goal)), player_to_receive_card (to be carded (over = shown a yellow or red card))"
},
"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 (e.g. 280555) 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 |
|---|---|---|
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl. |
| market * | string | The market: player_goal_scorer_anytime (anytime goalscorer (over = scores)), player_shots_on_target (shots on target), player_shots (shots), player_assists (assists), player_first_goal_scorer (first goalscorer (over = scores the match's first goal)), player_last_goal_scorer (last goalscorer (over = … |
| game_id * | string | Game id. |
| bookmaker | string | One book's captures, e.g. draftkings. |
| player_id * | string | Player id (e.g. 280555) 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": {
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl."
},
"market": {
"enum": [
"player_goal_scorer_anytime",
"player_shots_on_target",
"player_shots",
"player_assists",
"player_first_goal_scorer",
"player_last_goal_scorer",
"player_to_receive_card"
],
"type": "string",
"description": "The market: player_goal_scorer_anytime (anytime goalscorer (over = scores)), player_shots_on_target (shots on target), player_shots (shots), player_assists (assists), player_first_goal_scorer (first goalscorer (over = scores the match's first goal)), player_last_goal_scorer (last goalscorer (over = scores the match's last goal)), player_to_receive_card (to be carded (over = shown a yellow or red card))"
},
"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 (e.g. 280555) from search_players."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id",
"player_id",
"player_name",
"market",
"books",
"count"
],
"properties": {
"note": {
"type": "string"
},
"tool": {
"type": "string"
},
"books": {
"type": "array",
"items": {
"type": "object",
"required": [
"bookmaker",
"snapshots",
"line_change"
],
"properties": {
"bookmaker": {
"type": "string"
},
"snapshots": {
"type": "array",
"items": {
"type": "object",
"required": [
"captured_at",
"minutes_before_scheduled_start",
"line",
"over_odds",
"under_odds"
],
"properties": {
"line": {
"type": [
"number",
"null"
]
},
"over_odds": {
"type": [
"number",
"null"
]
},
"under_odds": {
"type": [
"number",
"null"
]
},
"captured_at": {
"type": "string"
},
"minutes_before_scheduled_start": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"line_change": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"market": {
"type": "string"
},
"credits": {
"type": "number"
},
"game_id": {
"type": "string"
},
"player_id": {
"type": [
"string",
"number"
]
},
"player_name": {
"type": [
"string",
"null"
]
},
"estimate_only": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Prop movement",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for the extra betting markets of a game as history: both teams to score, draw no bet, double chance, and the 1st half result, total and goal handicap, for the Premier League, La Liga, Serie A, the Bundesliga, Ligue 1, MLS and the Champions League. Pass game_id (from get_schedule or list_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 for the larger sportsbooks only: both teams to score from May 2023, the other markets from August 2023 (later in some leagues); not every match has every market. Each match'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 |
|---|---|---|
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl. |
| market * | string | The market: btts (both teams to score: Yes or No), draw_no_bet (draw no bet: home or away, a draw voids it), double_chance (double chance: two of home, draw and away (e.g. Arsenal or Draw)), h2h_h1 (1st half result: home, draw or away), totals_h1 (1st half total goals), spreads_h1 (1st half goal han… |
| game_id * | string | Game id from get_schedule or list_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: both teams to score, draw no bet, double chance, and the 1st half result, total and goal handicap, for the Premier League, La Liga, Serie A, the Bundesliga, Ligue 1, MLS and the Champions League. Pass game_id (from get_schedule or list_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 for the larger sportsbooks only: both teams to score from May 2023, the other markets from August 2023 (later in some leagues); not every match has every market. Each match'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": {
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl."
},
"market": {
"enum": [
"btts",
"draw_no_bet",
"double_chance",
"h2h_h1",
"totals_h1",
"spreads_h1"
],
"type": "string",
"description": "The market: btts (both teams to score: Yes or No), draw_no_bet (draw no bet: home or away, a draw voids it), double_chance (double chance: two of home, draw and away (e.g. Arsenal or Draw)), h2h_h1 (1st half result: home, draw or away), totals_h1 (1st half total goals), spreads_h1 (1st half goal handicap)"
},
"game_id": {
"type": "string",
"description": "Game id from get_schedule or list_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 (home, draw and away), each handicap and each total, with how many books each rests on. Only identical lines are combined. Each book's last pre-game prices by default (snapshot_type reads latest until the start, closing after it); opening on request. For each book's prices use get_odds. Costs 5 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. |
| game_id * | string | Game id, e.g. 401879246. |
| 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 (home, draw and away), each handicap and each total, with how many books each rests on. Only identical lines are combined. Each book's last pre-game prices by default (snapshot_type reads latest until the start, closing after it); opening on request. For each book's prices use get_odds. Costs 5 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id"
],
"properties": {
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl",
"championship",
"nwsl",
"ligamx",
"uel",
"uecl",
"eredivisie",
"primeira",
"scotland",
"brazil",
"argentina"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
},
"game_id": {
"type": "string",
"description": "Game id, e.g. 401879246."
},
"snapshot_type": {
"enum": [
"opening",
"closing"
],
"type": "string",
"description": "closing (default): each book's last pre-game price so far. opening: each book's first."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id",
"home_team",
"away_team",
"scheduled_start",
"snapshot_type",
"moneyline",
"spreads",
"totals",
"count",
"method"
],
"properties": {
"note": {
"type": "string"
},
"tool": {
"type": "string"
},
"count": {
"type": "number"
},
"method": {
"type": "string"
},
"totals": {
"type": "array",
"items": {
"type": "object",
"required": [
"line",
"books_used",
"fair_books",
"over",
"under"
],
"properties": {
"line": {
"type": "number"
},
"over": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"under": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"books_used": {
"type": "number"
},
"fair_books": {
"type": "number"
}
},
"additionalProperties": false
}
},
"credits": {
"type": "number"
},
"game_id": {
"type": "string"
},
"spreads": {
"type": "array",
"items": {
"type": "object",
"required": [
"home_line",
"books_used",
"fair_books",
"home",
"away"
],
"properties": {
"away": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"home": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"home_line": {
"type": "number"
},
"books_used": {
"type": "number"
},
"fair_books": {
"type": "number"
}
},
"additionalProperties": false
}
},
"away_team": {
"type": [
"string",
"null"
]
},
"home_team": {
"type": [
"string",
"null"
]
},
"moneyline": {
"anyOf": [
{
"type": "object",
"required": [
"books_used",
"fair_books",
"home",
"away"
],
"properties": {
"away": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"draw": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"home": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"books_used": {
"type": "number"
},
"fair_books": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"estimate_only": {
"type": "boolean"
},
"snapshot_type": {
"type": "string"
},
"scheduled_start": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Game probabilities",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for what the market thinks of the player props in one game, not any one book's price: for each player and each line, the average implied probability (margin in) and the fair probability (margin out), with how many books each rests on. Only identical lines are combined, and a yes/no market whose books post only the yes price has no fair probability. Latest pre-game prices. For each book's prices use get_player_props. Costs 10 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl. |
| market | string | One market, e.g. player_goal_scorer_anytime. Default every market. |
| game_id * | string | Game id, e.g. 401879246. |
| player_id | string | One player's id (e.g. 280555, from search_players). Default every player. |
{
"name": "get_prop_probabilities",
"title": "Prop probabilities",
"description": "Use for what the market thinks of the player props in one game, not any one book's price: for each player and each line, the average implied probability (margin in) and the fair probability (margin out), with how many books each rests on. Only identical lines are combined, and a yes/no market whose books post only the yes price has no fair probability. Latest pre-game prices. For each book's prices use get_player_props. Costs 10 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id"
],
"properties": {
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl."
},
"market": {
"enum": [
"player_goal_scorer_anytime",
"player_shots_on_target",
"player_shots",
"player_assists",
"player_first_goal_scorer",
"player_last_goal_scorer",
"player_to_receive_card"
],
"type": "string",
"description": "One market, e.g. player_goal_scorer_anytime. Default every market."
},
"game_id": {
"type": "string",
"description": "Game id, e.g. 401879246."
},
"player_id": {
"type": "string",
"description": "One player's id (e.g. 280555, from search_players). Default every player."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"game_id",
"scheduled_start",
"props",
"count",
"method"
],
"properties": {
"note": {
"type": "string"
},
"tool": {
"type": "string"
},
"count": {
"type": "number"
},
"props": {
"type": "array",
"items": {
"type": "object",
"required": [
"player_id",
"player_name",
"market",
"label",
"consensus_line",
"lines"
],
"properties": {
"label": {
"type": "string"
},
"lines": {
"type": "array",
"items": {
"type": "object",
"required": [
"line",
"books_used",
"fair_books",
"over",
"under"
],
"properties": {
"line": {
"type": [
"number",
"null"
]
},
"over": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"under": {
"type": "object",
"required": [
"avg_implied_prob",
"fair_prob"
],
"properties": {
"fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"books_used": {
"type": "number"
},
"fair_books": {
"type": "number"
}
},
"additionalProperties": false
}
},
"market": {
"type": "string"
},
"player_id": {
"type": [
"string",
"number",
"null"
]
},
"player_name": {
"type": "string"
},
"consensus_line": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"method": {
"type": "string"
},
"credits": {
"type": "number"
},
"game_id": {
"type": "string"
},
"estimate_only": {
"type": "boolean"
},
"scheduled_start": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Prop probabilities",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use to test an idea about player props without pulling every row: how often a kind of prop went over or under against what the market implied, across every finished game we hold prices for that fits your filters. Returns the hit rate, its 95% interval, the average implied and fair probabilities, and each season on its own. For example, anytime goalscorer prices for players whose team was the home favorite. One result per player per game at the median closing line. It describes the past and recommends nothing. For one player game by game use get_prop_history. Costs 25 credits.
| Parameter | Type | Description |
|---|---|---|
| side | string | over (default) or under. Yes/no markets are graded on the yes price: over only. |
| team | string | The player's team, e.g. ARS. |
| league | string | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl. |
| market * | string | The market, e.g. player_goal_scorer_anytime. |
| to_date | string | Last game date, YYYY-MM-DD. Default all held. |
| fair_max | number | Highest fair probability of this side to include, 0 to 1. |
| fair_min | number | Lowest fair probability of this side to include, 0 to 1. |
| line_max | number | Highest median closing line to include. |
| line_min | number | Lowest median closing line to include. |
| opponent | string | The team he played. |
| from_date | string | First game date, YYYY-MM-DD. Default all held. |
| home_away | string | Whether his team was at home. |
| player_id | string | One player's id (e.g. 280555, from search_players). |
| team_role | string | Whether his team was favored, by the books' closing moneylines. |
{
"name": "get_prop_backtest",
"title": "Prop backtest",
"description": "Use to test an idea about player props without pulling every row: how often a kind of prop went over or under against what the market implied, across every finished game we hold prices for that fits your filters. Returns the hit rate, its 95% interval, the average implied and fair probabilities, and each season on its own. For example, anytime goalscorer prices for players whose team was the home favorite. One result per player per game at the median closing line. It describes the past and recommends nothing. For one player game by game use get_prop_history. Costs 25 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market"
],
"properties": {
"side": {
"enum": [
"over",
"under"
],
"type": "string",
"description": "over (default) or under. Yes/no markets are graded on the yes price: over only."
},
"team": {
"type": "string",
"description": "The player's team, e.g. ARS."
},
"league": {
"enum": [
"soccer",
"mls",
"laliga",
"seriea",
"bundesliga",
"ligue1",
"ucl"
],
"type": "string",
"description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl."
},
"market": {
"enum": [
"player_goal_scorer_anytime",
"player_to_receive_card",
"player_shots_on_target",
"player_shots",
"player_assists"
],
"type": "string",
"description": "The market, e.g. player_goal_scorer_anytime."
},
"to_date": {
"type": "string",
"description": "Last game date, YYYY-MM-DD. Default all held."
},
"fair_max": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Highest fair probability of this side to include, 0 to 1."
},
"fair_min": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Lowest fair probability of this side to include, 0 to 1."
},
"line_max": {
"type": "number",
"description": "Highest median closing line to include."
},
"line_min": {
"type": "number",
"description": "Lowest median closing line to include."
},
"opponent": {
"type": "string",
"description": "The team he played."
},
"from_date": {
"type": "string",
"description": "First game date, YYYY-MM-DD. Default all held."
},
"home_away": {
"enum": [
"home",
"away"
],
"type": "string",
"description": "Whether his team was at home."
},
"player_id": {
"type": "string",
"description": "One player's id (e.g. 280555, from search_players)."
},
"team_role": {
"enum": [
"favorite",
"underdog"
],
"type": "string",
"description": "Whether his team was favored, by the books' closing moneylines."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"label",
"side",
"filters",
"results",
"hits",
"misses",
"pushes",
"hit_rate",
"avg_implied_prob",
"avg_fair_prob",
"no_result",
"no_price",
"games",
"players",
"avg_books",
"avg_line",
"avg_actual",
"hit_rate_minus_implied",
"hit_rate_minus_fair",
"hit_rate_interval_95",
"market_inside_interval",
"by_season",
"method",
"caution"
],
"properties": {
"hits": {
"type": "number"
},
"note": {
"type": "string"
},
"side": {
"type": "string"
},
"tool": {
"type": "string"
},
"games": {
"type": "number"
},
"label": {
"type": "string"
},
"market": {
"type": "string"
},
"method": {
"type": "string"
},
"misses": {
"type": "number"
},
"pushes": {
"type": "number"
},
"caution": {
"type": "string"
},
"credits": {
"type": "number"
},
"filters": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"players": {
"type": "number"
},
"results": {
"type": "number"
},
"avg_line": {
"type": [
"number",
"null"
]
},
"hit_rate": {
"type": [
"number",
"null"
]
},
"no_price": {
"type": "number"
},
"avg_books": {
"type": [
"number",
"null"
]
},
"by_season": {
"type": "array",
"items": {
"type": "object",
"required": [
"season",
"results",
"hits",
"misses",
"pushes",
"hit_rate",
"avg_implied_prob",
"avg_fair_prob"
],
"properties": {
"hits": {
"type": "number"
},
"misses": {
"type": "number"
},
"pushes": {
"type": "number"
},
"season": {
"type": [
"number",
"string"
]
},
"results": {
"type": "number"
},
"hit_rate": {
"type": [
"number",
"null"
]
},
"avg_fair_prob": {
"type": [
"number",
"null"
]
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"no_result": {
"type": "number"
},
"avg_actual": {
"type": [
"number",
"null"
]
},
"avg_fair_prob": {
"type": [
"number",
"null"
]
},
"estimate_only": {
"type": "boolean"
},
"avg_implied_prob": {
"type": [
"number",
"null"
]
},
"hit_rate_minus_fair": {
"type": [
"number",
"null"
]
},
"hit_rate_interval_95": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
{
"type": "null"
}
]
},
"hit_rate_minus_implied": {
"type": [
"number",
"null"
]
},
"market_inside_interval": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Prop backtest",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}StrikerAPI -- 25 soccer (football) data tools. The Premier League, MLS, La Liga, Serie A, the Bundesliga, Ligue 1, the UEFA Champions League, the EFL Championship, the NWSL, Liga MX, the Europa League, the Conference League, the Eredivisie, the Primeira Liga, the Scottish Premiership, Brazil's Serie A and Argentina's Liga Profesional: fixtures and results, lineups, box scores, match events with shot locations and our xG, league tables, Elo ratings and sportsbook lines. ## First Steps 1. Leagues: every tool takes league. soccer (the default) is the Premier League; mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. 2. Find ids: clubs with list_teams (1 cr), players with search_players (1 cr), matches with list_games (2 cr) or get_schedule (2 cr). Clubs can also be passed by abbreviation or name. 3. Seasons are named by the year they start: 2025 = 2025-26. MLS, NWSL, Liga MX, Brazil and Argentina seasons are calendar years. ## Tool Selection - Club ids -> list_teams (1 cr); a player id from a name -> search_players (1 cr) - Results for a date, club or season; knockout rounds -> list_games (2 cr, stage=knockout) - Upcoming fixtures with the three-way line -> get_schedule (2 cr) - The league table, with deductions, home/away and form -> get_standings (2 cr) - Our club ratings -> get_ratings (2 cr); two clubs' history -> get_head_to_head (2 cr) - One match: box scores, players, key events, each book's line -> get_game (5 cr) - A club's current squad, players not yet in a matchday squad included, or every club's in the league -> get_squad (2 cr; 10 for a whole league) - Formations, XIs and substitutions -> get_lineups (5 cr) - A player's seasons and per-90s -> get_player (5 cr); every match -> get_player_games (5 cr) - Season leaders (goals, assists, xG, cards, saves) -> get_leaders (5 cr); club averages for and against -> get_team_stats (5 cr) - Every event in a match (shots with x/y and xG where the league has them, cards, subs) -> get_events (10 cr) - Where a club or player shoots from, or concedes from -> get_shot_map (10 cr) - Each sportsbook's moneylines, handicap and total -> get_odds (5 cr a match, 10 a day) - How a line moved before kick-off -> get_line_movement (10 cr) - Player props by sportsbook: anytime goalscorer, and for the top five leagues, MLS and the Champions League shots, shots on target, assists, first and last goalscorer and to be carded -> get_player_props (10 cr); a player's price against what he did, match by match -> get_prop_history (10 cr); how a price moved before kick-off -> get_prop_movement (10 cr). Only the leagues that hold prices offer them (see each tool's league list). - Both teams to score, draw no bet, double chance and first-half lines as history, opening and closing by sportsbook (Premier League, La Liga, Serie A, Bundesliga, Ligue 1, MLS, Champions League) -> get_market_odds (10 cr) - What the market thinks of a match, one number across books: average implied and fair (no-margin) probability of home, draw and away, each handicap and each total -> get_game_probabilities (5 cr); the same for a match's player props -> get_prop_probabilities (10 cr) - How often a kind of prop hit against the market ("anytime goalscorer for home favorites"), 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 ## Notes - Pitch frame: x is the distance from the goal line as a share of half the pitch (the penalty spot is 0.23, about 11 m); y runs across the pitch, 0.5 = the centre. Shots also carry where they ended (end_x, end_y). - xg is our location model: the league's goal rate for shots from the same distance and angle, header or not; penalties at the league's conversion rate. It does not see defenders or the pass. - Located shots (x/y and xG) start by league: the Premier League, La Liga, Serie A, the Bundesli
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.