get_leaders

5 creditsStats + aggregationPOST /v1/get_leaders

Leaders in runs, average, strike rate, sixes, wickets, economy

Use it when you want the top run scorers, wicket takers or the best strike rates in a competition or season.

Parameters

statenum: runs | batting_average | strike_rate | sixes | wickets | economy | bowling_averagerequired
competitionstringoptional: Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).
seasonstringoptional: Season: a year (2024) or a split season (2024/25).
formatenum: test | odi | t20 | first_class | list_aoptional
genderenum: male | femaleoptional
min_ballsintegeroptional
limitintegeroptional
leagueenum: cricket | test | odi | t20i | ipl | bbl | psl | cpl | blast | hundred | sa20 | ilt20 | county | wbbl | wpl | hundred_womenoptional: League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.

Notes

Over MCP, ask for it in plain English and the client calls get_leaders itself. Point any MCP client at https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY.
Each call costs 5 credits, taken before it runs and refunded if the server errors.
Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.yorkerapi.com/v1/get_leaders \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "stat": "wickets",
  "competition": "ipl",
  "season": "2025",
  "limit": 5
}'

Response

json

{
  "stat": "wickets",
  "min_balls": 0,
  "leaders": [
    {
      "rank": 1,
      "player_id": "85e0cf10",
      "matches": 15,
      "balls": 354,
      "runs_conceded": 488,
      "wickets": 25,
      "dots": 135,
      "wides": 11,
      "noballs": 0,
      "name": "M Prasidh Krishna",
      "overs": "59",
      "average": 19.52,
      "economy": 8.27,
      "strike_rate": 14.2
    },
    {
      "rank": 2,
      "player_id": "efc04be7",
      "matches": 14,
      "balls": 300,
      "runs_conceded": 408,
      "wickets": 24,
      "dots": 102,
      "wides": 19,
      "noballs": 3,
      "name": "Noor Ahmad",
      "overs": "50",
      "average": 17,
      "economy": 8.16,
      "strike_rate": 12.5
    },
    {
      "rank": 3,
      "player_id": "03806cf8",
      "matches": 12,
      "balls": 264,
      "runs_conceded": 386,
      "wickets": 22,
      "dots": 117,
      "wides": 6,
      "noballs": 0,
      "name": "JR Hazlewood",
      "overs": "44",
      "average": 17.55,
      "economy": 8.77,
      "strike_rate": 12
    }
  ],
  "count": 5
}