YorkerAPI is an MCP server published by io.github.noahowsh, hosted at mcp.yorkerapi.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 18 tools, including get_schedule, list_competitions, list_teams, get_matches, get_match.
Cricket ball by ball in every format, men's and women's, joined to sportsbook match-winner prices.
11 connections through 4 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Use for upcoming and live matches in every competition, soonest first: start time, teams, venue, status, each side's current rating where we rate it, and the favourite at the median sportsbook price where one is posted. A fixture keeps its match id once played, so get_match takes it then. Costs 2 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Days ahead (default 7). |
| gender | string | one of ["male","female"] |
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| team_id | string | Team id from list_teams. |
| competition |
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.
| string |
| Competition key, e.g. bbl, ipl, test, t20i. |
| include_live | boolean | Include matches in progress (default true). |
{
"name": "get_schedule",
"title": "Schedule",
"description": "Use for upcoming and live matches in every competition, soonest first: start time, teams, venue, status, each side's current rating where we rate it, and the favourite at the median sportsbook price where one is posted. A fixture keeps its match id once played, so get_match takes it then. 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": 45,
"minimum": 1,
"description": "Days ahead (default 7)."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"team_id": {
"type": "string",
"description": "Team id from list_teams."
},
"competition": {
"type": "string",
"description": "Competition key, e.g. bbl, ipl, test, t20i."
},
"include_live": {
"type": "boolean",
"description": "Include matches in progress (default true)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"days",
"matches",
"count"
],
"properties": {
"days": {
"type": "number"
},
"count": {
"type": "number"
},
"matches": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Schedule",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use to see every competition we hold and its key: format, men's or women's, international or club, match count, first and last match, seasons. Costs 1 credit.
| Parameter | Type | Description |
|---|---|---|
| format | string | test, odi, t20 (T20Is and T20 leagues), first_class, list_a. |
| gender | string | one of ["male","female"] |
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
{
"name": "list_competitions",
"title": "List competitions",
"description": "Use to see every competition we hold and its key: format, men's or women's, international or club, match count, first and last match, seasons. Costs 1 credit.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"format": {
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string",
"description": "test, odi, t20 (T20Is and T20 leagues), first_class, list_a."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"competitions",
"count"
],
"properties": {
"count": {
"type": "number"
},
"competitions": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "List competitions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for team ids: international sides and franchises, most matches first. Women's sides end in -women (india-women). A renamed side lists its current id in now_plays_as, and filtering on either finds both. Filter by competition, season, gender or part of a name. Costs 1 credit.
| Parameter | Type | Description |
|---|---|---|
| gender | string | one of ["male","female"] |
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| search | string | Part of the team name. |
| season | string | Season: a year (2024) or a split season (2024/25); a year also finds the split season that starts in it. |
| competition | string | Competition key from list_competitions (ipl, bbl, psl, blast, hundred, county, test, odi, t20i, ...). |
{
"name": "list_teams",
"title": "List teams",
"description": "Use for team ids: international sides and franchises, most matches first. Women's sides end in -women (india-women). A renamed side lists its current id in now_plays_as, and filtering on either finds both. Filter by competition, season, gender or part of a name. Costs 1 credit.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"search": {
"type": "string",
"description": "Part of the team name."
},
"season": {
"type": "string",
"description": "Season: a year (2024) or a split season (2024/25); a year also finds the split season that starts in it."
},
"competition": {
"type": "string",
"description": "Competition key from list_competitions (ipl, bbl, psl, blast, hundred, county, test, odi, t20i, ...)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"teams",
"count"
],
"properties": {
"count": {
"type": "number"
},
"teams": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "List teams",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for results: matches newest first with both scores, toss, result and margin. Filter by competition, season, team, opponent, venue, date or a date range. Costs 2 credits.
| Parameter | Type | Description |
|---|---|---|
| to | string | Start date on or before (YYYY-MM-DD). |
| date | string | A day the match was played (YYYY-MM-DD); multi-day matches match on any day. |
| from | string | Start date on or after (YYYY-MM-DD). |
| limit | integer | Max matches (default 50). |
| venue | string | Part of the ground or city name. |
| format | string | one of ["test","odi","t20","first_class","list_a"] |
| gender | string | one of ["male","female"] |
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| offset | integer | |
| season | string | Season: a year (2024) or a split season (2024/25); a year also finds the split season that starts in it. |
| team_id | string | Team id from list_teams. |
| competition | string | Competition key from list_competitions (ipl, bbl, psl, blast, hundred, county, test, odi, t20i, ...). |
| opponent_id | string | Only matches against this team too. |
{
"name": "get_matches",
"title": "Matches",
"description": "Use for results: matches newest first with both scores, toss, result and margin. Filter by competition, season, team, opponent, venue, date or a date range. Costs 2 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"to": {
"type": "string",
"description": "Start date on or before (YYYY-MM-DD)."
},
"date": {
"type": "string",
"description": "A day the match was played (YYYY-MM-DD); multi-day matches match on any day."
},
"from": {
"type": "string",
"description": "Start date on or after (YYYY-MM-DD)."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max matches (default 50)."
},
"venue": {
"type": "string",
"description": "Part of the ground or city name."
},
"format": {
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string"
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"season": {
"type": "string",
"description": "Season: a year (2024) or a split season (2024/25); a year also finds the split season that starts in it."
},
"team_id": {
"type": "string",
"description": "Team id from list_teams."
},
"competition": {
"type": "string",
"description": "Competition key from list_competitions (ipl, bbl, psl, blast, hundred, county, test, odi, t20i, ...)."
},
"opponent_id": {
"type": "string",
"description": "Only matches against this team too."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"matches",
"count"
],
"properties": {
"count": {
"type": "number"
},
"matches": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Matches",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for one match in full: result, toss, venue, player of the match, every innings with its batting card (runs, balls, fours, sixes, strike rate, how out, fall of wicket) and bowling card (overs, maidens, runs, wickets, economy), our team ratings before and after, and each sportsbook's opening and closing match-winner price. Costs 5 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| match_id * | string | Match id from get_matches or get_schedule. |
{
"name": "get_match",
"title": "Match",
"description": "Use for one match in full: result, toss, venue, player of the match, every innings with its batting card (runs, balls, fours, sixes, strike rate, how out, fall of wicket) and bowling card (overs, maidens, runs, wickets, economy), our team ratings before and after, and each sportsbook's opening and closing match-winner price. 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": [
"match_id"
],
"properties": {
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"match_id": {
"type": "string",
"description": "Match id from get_matches or get_schedule."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"match",
"innings",
"ratings",
"odds"
],
"properties": {
"odds": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"match": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"innings": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"ratings": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Match",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for ball-by-ball rows: every delivery of a match (or one innings), or a batter's or bowler's balls across matches (filter by competition, season, overs, wickets only or boundaries only). Each ball has runs, extras, the wicket and fielders, the score after it and our win probability for the batting side (limited-overs matches). Costs 10 credits.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max balls (default 600 for a match, 200 otherwise). |
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| offset | integer | |
| season | string | Season: a year (2024) or a split season (2024/25); a year also finds the split season that starts in it. |
| innings | integer | |
| over_to | integer | Last over, 0-based. |
| match_id | string | Match id from get_matches. |
| batter_id | string | Player id from search_players. |
| bowler_id | string | Player id from search_players. |
| over_from | integer | First over, 0-based as scorers count (0 is the first over). |
| competition | string | Competition key from list_competitions (ipl, bbl, psl, blast, hundred, county, test, odi, t20i, ...). |
| wickets_only | boolean | |
| boundaries_only | boolean |
{
"name": "get_deliveries",
"title": "Deliveries",
"description": "Use for ball-by-ball rows: every delivery of a match (or one innings), or a batter's or bowler's balls across matches (filter by competition, season, overs, wickets only or boundaries only). Each ball has runs, extras, the wicket and fielders, the score after it and our win probability for the batting side (limited-overs matches). Costs 10 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 3000,
"minimum": 1,
"description": "Max balls (default 600 for a match, 200 otherwise)."
},
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"season": {
"type": "string",
"description": "Season: a year (2024) or a split season (2024/25); a year also finds the split season that starts in it."
},
"innings": {
"type": "integer",
"maximum": 8,
"minimum": 1
},
"over_to": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Last over, 0-based."
},
"match_id": {
"type": "string",
"description": "Match id from get_matches."
},
"batter_id": {
"type": "string",
"description": "Player id from search_players."
},
"bowler_id": {
"type": "string",
"description": "Player id from search_players."
},
"over_from": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "First over, 0-based as scorers count (0 is the first over)."
},
"competition": {
"type": "string",
"description": "Competition key from list_competitions (ipl, bbl, psl, blast, hundred, county, test, odi, t20i, ...)."
},
"wickets_only": {
"type": "boolean"
},
"boundaries_only": {
"type": "boolean"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"deliveries",
"count"
],
"properties": {
"count": {
"type": "number"
},
"deliveries": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Deliveries",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use to find a player's id by name (the scorecard short form, "V Kohli", or the full name), most matches first and their last team. Or list a team's players with team_id. Costs 1 credit.
| Parameter | Type | Description |
|---|---|---|
| name | string | Part of the name, e.g. "kohli". |
| limit | integer | |
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| team_id | string | Team id from list_teams. |
{
"name": "search_players",
"title": "Search players",
"description": "Use to find a player's id by name (the scorecard short form, \"V Kohli\", or the full name), most matches first and their last team. Or list a team's players with team_id. Costs 1 credit.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"name": {
"type": "string",
"description": "Part of the name, e.g. \"kohli\"."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"team_id": {
"type": "string",
"description": "Team id from list_teams."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"players",
"count"
],
"properties": {
"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 player's career: teams played for, and batting (runs, balls, average, strike rate, fours, sixes, hundreds, fifties, highest score) and bowling (overs, wickets, average, economy, strike rate, five-wicket hauls, best) by format, all counted from the ball-by-ball record, which starts in December 2001, so an earlier career shows only the part since. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| player_id * | string | Player id from search_players. |
{
"name": "get_player",
"title": "Player",
"description": "Use for a player's career: teams played for, and batting (runs, balls, average, strike rate, fours, sixes, hundreds, fifties, highest score) and bowling (overs, wickets, average, economy, strike rate, five-wicket hauls, best) by format, all counted from the ball-by-ball record, which starts in December 2001, so an earlier career shows only the part since. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player_id"
],
"properties": {
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"player_id": {
"type": "string",
"description": "Player id from search_players."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player",
"teams",
"batting_by_format",
"bowling_by_format"
],
"properties": {
"teams": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"player": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"batting_by_format": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"bowling_by_format": {
"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 batting and bowling split by season, competition, phase of the innings (powerplay, middle, death) or format, optionally inside one format, competition or season. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| by | string | How to split (default format). |
| format | string | one of ["test","odi","t20","first_class","list_a"] |
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| season | string | Season: a year (2024) or a split season (2024/25). |
| player_id * | string | Player id from search_players. |
| competition | string | Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...). |
{
"name": "get_player_stats",
"title": "Player stats",
"description": "Use for a player's batting and bowling split by season, competition, phase of the innings (powerplay, middle, death) or format, optionally inside one format, competition or season. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player_id"
],
"properties": {
"by": {
"enum": [
"season",
"competition",
"phase",
"format"
],
"type": "string",
"description": "How to split (default format)."
},
"format": {
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string"
},
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"season": {
"type": "string",
"description": "Season: a year (2024) or a split season (2024/25)."
},
"player_id": {
"type": "string",
"description": "Player id from search_players."
},
"competition": {
"type": "string",
"description": "Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player_id",
"name",
"grouped_by",
"batting",
"bowling",
"count"
],
"properties": {
"name": {
"type": "string"
},
"count": {
"type": "number"
},
"batting": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"bowling": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"player_id": {
"type": "string"
},
"grouped_by": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Player stats",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for a player's matches, newest first: team, opponent, result, and the player's batting (runs, balls, fours, sixes, out) and bowling (balls, runs, wickets) in each innings. Filter by format, competition or season. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max matches (default 50). |
| format | string | one of ["test","odi","t20","first_class","list_a"] |
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| offset | integer | |
| season | string | Season: a year (2024) or a split season (2024/25). |
| player_id * | string | Player id from search_players. |
| competition | string | Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...). |
{
"name": "get_player_matches",
"title": "Player matches",
"description": "Use for a player's matches, newest first: team, opponent, result, and the player's batting (runs, balls, fours, sixes, out) and bowling (balls, runs, wickets) in each innings. Filter by format, competition or season. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max matches (default 50)."
},
"format": {
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string"
},
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"season": {
"type": "string",
"description": "Season: a year (2024) or a split season (2024/25)."
},
"player_id": {
"type": "string",
"description": "Player id from search_players."
},
"competition": {
"type": "string",
"description": "Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"player_id",
"name",
"matches",
"count"
],
"properties": {
"name": {
"type": "string"
},
"count": {
"type": "number"
},
"matches": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"player_id": {
"type": "string"
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Player matches",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for a batter against a bowler: balls, runs, strike rate, dots, fours, sixes and every dismissal, overall and by format. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| format | string | one of ["test","odi","t20","first_class","list_a"] |
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| batter_id * | string | Batter's player id. |
| bowler_id * | string | Bowler's player id. |
| competition | string | Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...). |
{
"name": "get_matchup",
"title": "Matchup",
"description": "Use for a batter against a bowler: balls, runs, strike rate, dots, fours, sixes and every dismissal, overall and by format. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"batter_id",
"bowler_id"
],
"properties": {
"format": {
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string"
},
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"batter_id": {
"type": "string",
"description": "Batter's player id."
},
"bowler_id": {
"type": "string",
"description": "Bowler's player id."
},
"competition": {
"type": "string",
"description": "Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"batter",
"bowler",
"summary",
"by_format",
"dismissals",
"count"
],
"properties": {
"count": {
"type": "number"
},
"batter": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"bowler": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"summary": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"by_format": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"dismissals": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Matchup",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for the leaders in a stat (runs, batting_average, strike_rate, sixes, wickets, economy, bowling_average) in a competition, season or format. Rate stats need min_balls faced or bowled (default 120). Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| stat * | string | one of ["runs","batting_average","strike_rate","sixes","wickets","economy","bowling_average"] |
| limit | integer | |
| format | string | one of ["test","odi","t20","first_class","list_a"] |
| gender | string | one of ["male","female"] |
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| season | string | Season: a year (2024) or a split season (2024/25). |
| min_balls | integer | |
| competition | string | Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...). |
{
"name": "get_leaders",
"title": "Leaders",
"description": "Use for the leaders in a stat (runs, batting_average, strike_rate, sixes, wickets, economy, bowling_average) in a competition, season or format. Rate stats need min_balls faced or bowled (default 120). Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"stat"
],
"properties": {
"stat": {
"enum": [
"runs",
"batting_average",
"strike_rate",
"sixes",
"wickets",
"economy",
"bowling_average"
],
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"format": {
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string"
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"season": {
"type": "string",
"description": "Season: a year (2024) or a split season (2024/25)."
},
"min_balls": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"competition": {
"type": "string",
"description": "Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"stat",
"min_balls",
"leaders",
"count"
],
"properties": {
"stat": {
"type": "string"
},
"count": {
"type": "number"
},
"leaders": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"min_balls": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Leaders",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for our team ratings (Elo) in one format, best first: international sides and franchises, men's or women's, active in the last two years by default. Costs 2 credits.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| format * | string | one of ["test","odi","t20","first_class","list_a"] |
| gender | string | one of ["male","female"] |
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| team_type | string | one of ["international","club"] |
| active_since | string | Only teams with a match since this date (YYYY-MM-DD; default two years ago). |
{
"name": "get_ratings",
"title": "Ratings",
"description": "Use for our team ratings (Elo) in one format, best first: international sides and franchises, men's or women's, active in the last two years by default. Costs 2 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"format"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 300,
"minimum": 1
},
"format": {
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string"
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"team_type": {
"enum": [
"international",
"club"
],
"type": "string"
},
"active_since": {
"type": "string",
"description": "Only teams with a match since this date (YYYY-MM-DD; default two years ago)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"format",
"active_since",
"ratings",
"count",
"method"
],
"properties": {
"count": {
"type": "number"
},
"format": {
"type": "string"
},
"method": {
"type": "string"
},
"ratings": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"active_since": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Ratings",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for how a ground plays, by format: average first- and second-innings totals, how often the side batting first wins, how often the toss winner wins and what captains choose, and draws. Match by part of the ground or city name. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| since | string | Only matches from this date (YYYY-MM-DD). |
| venue * | string | Part of the ground or city, e.g. "wankhede" or "adelaide". |
| format | string | one of ["test","odi","t20","first_class","list_a"] |
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| competition | string | Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...). |
{
"name": "get_venue",
"title": "Venue",
"description": "Use for how a ground plays, by format: average first- and second-innings totals, how often the side batting first wins, how often the toss winner wins and what captains choose, and draws. Match by part of the ground or city name. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"venue"
],
"properties": {
"since": {
"type": "string",
"description": "Only matches from this date (YYYY-MM-DD)."
},
"venue": {
"type": "string",
"description": "Part of the ground or city, e.g. \"wankhede\" or \"adelaide\"."
},
"format": {
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string"
},
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"competition": {
"type": "string",
"description": "Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"venues",
"by_format",
"count",
"note"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"venues": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"by_format": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Venue",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for a limited-overs match's win-probability worm: our chance the batting side wins at the end of every over (and from team 1's side), with the ten balls that moved it most. Costs 10 credits.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| match_id * | string | Match id from get_matches. |
{
"name": "get_win_probability",
"title": "Win probability",
"description": "Use for a limited-overs match's win-probability worm: our chance the batting side wins at the end of every over (and from team 1's side), with the ten balls that moved it most. Costs 10 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"match_id"
],
"properties": {
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"match_id": {
"type": "string",
"description": "Match id from get_matches."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"match_id",
"team1_id",
"team2_id",
"winner_id",
"overs",
"biggest_swings",
"count",
"method"
],
"properties": {
"count": {
"type": "number"
},
"overs": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"method": {
"type": "string"
},
"match_id": {
"type": "string"
},
"team1_id": {
"type": "string"
},
"team2_id": {
"type": "string"
},
"winner_id": {
"type": [
"string",
"null"
]
},
"biggest_swings": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Win probability",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use to see a limited-overs match's in-play market beside our model, on the exact ball: at each in-play price snapshot, the median margin-free price on team 1, our win probability after the last ball bowled before it, the score at that moment and the gap. Costs 10 credits.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| match_id * | string | Match id from get_matches. |
{
"name": "get_market_vs_model",
"title": "Market vs model",
"description": "Use to see a limited-overs match's in-play market beside our model, on the exact ball: at each in-play price snapshot, the median margin-free price on team 1, our win probability after the last ball bowled before it, the score at that moment and the gap. Costs 10 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"match_id"
],
"properties": {
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"match_id": {
"type": "string",
"description": "Match id from get_matches."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"match_id",
"team1_id",
"team2_id",
"winner_id",
"snapshots",
"widest_gap",
"count",
"method"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"method": {
"type": "string"
},
"match_id": {
"type": "string"
},
"team1_id": {
"type": "string"
},
"team2_id": {
"type": "string"
},
"snapshots": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"winner_id": {
"type": [
"string",
"null"
]
},
"widest_gap": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Market vs model",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for match-winner prices by sportsbook (mid-2020 on, upcoming matches included): each book's opening and latest pregame decimal price, the American price and how many snapshots we hold. For one match, or a competition, season or date. Costs 5 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| date | string | A day of the match (YYYY-MM-DD). |
| limit | integer | Max matches (default 20). |
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| season | string | |
| match_id | string | Match id from get_matches. |
| competition | string | Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...). |
{
"name": "get_odds",
"title": "Odds",
"description": "Use for match-winner prices by sportsbook (mid-2020 on, upcoming matches included): each book's opening and latest pregame decimal price, the American price and how many snapshots we hold. For one match, or a competition, season or date. Costs 5 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"date": {
"type": "string",
"description": "A day of the match (YYYY-MM-DD)."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max matches (default 20)."
},
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"season": {
"type": "string"
},
"match_id": {
"type": "string",
"description": "Match id from get_matches."
},
"competition": {
"type": "string",
"description": "Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"matches",
"count"
],
"properties": {
"count": {
"type": "number"
},
"matches": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Odds",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for how one match's market moved: every pregame snapshot by sportsbook (decimal and American), the median margin-free probability per snapshot, and with include_in_play the prices taken during the match. Costs 10 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women. |
| match_id * | string | Match id from get_matches. |
| bookmaker | string | One book's key, e.g. "pinnacle". |
| include_in_play | boolean |
{
"name": "get_line_movement",
"title": "Line movement",
"description": "Use for how one match's market moved: every pregame snapshot by sportsbook (decimal and American), the median margin-free probability per snapshot, and with include_in_play the prices taken during the match. 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": [
"match_id"
],
"properties": {
"league": {
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string",
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women."
},
"match_id": {
"type": "string",
"description": "Match id from get_matches."
},
"bookmaker": {
"type": "string",
"description": "One book's key, e.g. \"pinnacle\"."
},
"include_in_play": {
"type": "boolean"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"match_id",
"pregame",
"consensus",
"in_play",
"count"
],
"properties": {
"count": {
"type": "number"
},
"in_play": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"pregame": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"match_id": {
"type": "string"
},
"consensus": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Line movement",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}YorkerAPI -- 18 cricket data tools. Ball-by-ball for every format, men's and women's, Tests to T20 leagues, with players, venues, our Elo and per-ball win probability, and sportsbook match-winner prices from mid-2020. ## First Steps 1. Find a player's id with search_players (1 cr), a team's id with list_teams (1 cr), a competition's key with list_competitions (1 cr). 2. Find matches with get_matches (2 cr) or get_schedule (2 cr). Match ids are numbers ("1422119"); a fixture keeps its id once played. 3. Seasons are as the competition writes them: a year ("2024") or a split season ("2024/25"); a year also finds the split season that starts in it. ## Tool Selection - Competition keys -> list_competitions (1 cr); team ids -> list_teams (1 cr); a player's id -> search_players (1 cr) - Upcoming and live matches -> get_schedule (2 cr); results -> get_matches (2 cr) - One match: batting and bowling cards, ratings, every book's price -> get_match (5 cr) - Every ball of a match, or a batter's or bowler's balls -> get_deliveries (10 cr) - A career by format -> get_player (5 cr); split by season, competition or phase -> get_player_stats (5 cr); match by match -> get_player_matches (5 cr) - Batter against bowler -> get_matchup (5 cr); leaders in a stat -> get_leaders (5 cr) - How a ground plays -> get_venue (5 cr); our team ratings -> get_ratings (2 cr) - A match's win-probability worm -> get_win_probability (10 cr) - Match-winner prices -> get_odds (5 cr); how a market moved, and in-play prices -> get_line_movement (10 cr) - The in-play market beside our model on the exact ball -> get_market_vs_model (10 cr) ## Notes - Competitions are filters on one dataset: test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women and more (list_competitions). Women's sides are separate teams (ids end -women). - Overs are 0-based as scorers count them: over 0 is the first over. A ball's "ball" counts wides and no-balls; "legal" says whether it counted. - Batting and bowling figures are counted from the balls we hold, so a career that began before the record (December 2001; thin until 2003 and about half of men's Tests and ODIs in 2003-05, near complete from 2006) shows only the part inside it. Super overs are left out of player figures. Bowlers are charged wides and no-balls, not byes or leg byes; balls faced exclude wides. - Ratings are ours: Elo per format from results. Win probability is our model's chance the batting side wins after each ball (limited overs only). - Prices are match-winner only, decimal and American. Prices taken after the first ball are in-play and kept apart from the pregame lines. - A player has one id across every format and competition. ## Credit costs | Credits | Tools | |---|---| | 1 | list_competitions, list_teams, search_players | | 2 | get_schedule, get_matches, get_ratings | | 5 | get_match, get_player, get_player_stats, get_player_matches, get_matchup, get_leaders, get_venue, get_odds | | 10 | get_deliveries, get_win_probability, get_market_vs_model, get_line_movement | Data credits: Ball-by-ball cricket data from Cricsheet (cricsheet.org), licensed under the Open Data Commons Attribution License (ODC-BY), combined with our own models. ## Data timing and rights - Odds and props are pre-game only. captured_at is when a line was captured (the page says exactly what it means for each kind of row); where props are held, rows also carry scheduled_start and minutes_before_scheduled_start (negative when captured after the scheduled start). - Records are overwritten when sources correct them; no revision history is kept. - You may store the data, train models, backtest, and build commercial products that show your users what you derive. You may not redistribute the data, or odds as a raw feed, as a dataset or API of its own. After an account closes, stored data is for internal use only. - YorkerAPI is independent, not an official league partner, and grants no league rights. - F
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.