get_leaders

5 creditsStats + aggregationPOST /v1/get_leaders

Season leaders per game, by percentage or in total

Use it when you want who leads a stat in a season, per game, by percentage with a volume floor, or in total.

Parameters

statenum: pts | reb | ast | stl | blk | tpm | min | plus_minus | fg_pct | tp_pct | ft_pct | ts_pct | total_ptsrequired: Stat to rank by.
seasonnumber | stringoptional: Season by the year it ends: 2025 = 2024-25 (default: the latest).
season_typeenum: regular | postseason | play_in | preseasonoptional: Default regular.
min_gamesintegeroptional: Minimum games played (default: a quarter of the season).
limitintegeroptional

Notes

Over MCP, ask for it in plain English and the client calls get_leaders itself. Point any MCP client at https://mcp.dunkapi.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.dunkapi.com/v1/get_leaders \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "stat": "ts_pct",
  "season": 2024,
  "limit": 3
}'

Response

json

{
  "stat": "ts_pct",
  "label": "True shooting %",
  "season": 2024,
  "min_games": 20,
  "leaders": [
    {
      "player_id": "4278049",
      "name": "Daniel Gafford",
      "team": "DAL/WSH",
      "games": 74,
      "value": 0.731
    },
    {
      "player_id": "4683688",
      "name": "Dereck Lively II",
      "team": "DAL",
      "games": 55,
      "value": 0.728
    },
    {
      "player_id": "4278076",
      "name": "Nick Richards",
      "team": "CHA",
      "games": 67,
      "value": 0.717
    }
  ],
  "count": 3
}