get_leaders

5 creditsStats + aggregationPOST /v1/get_leaders

Season leaders for any stat we compute or ESPN keeps

Use it when you want a season's leaders in one stat with each player's sample size.

Parameters

statenum: scoring_average | adj_vs_field | vs_field | birdies_per_round | bogey_avoidance | par3_average | par4_average | par5_average | earnings | cup_points | wins | top_tens | driving_distance | driving_accuracy | greens_in_regulation | putts_per_girrequired: The stat to rank.
seasonstring | numberrequired: Season year, e.g. 2025.
minintegeroptional: Minimum sample: rounds (default 40), starts (1) or tournaments with a stat line (8).
limitintegeroptional: Max players (default 25).

Notes

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

Response

json

{
  "stat": "adj_vs_field",
  "label": "Strokes versus the field per round, field-strength adjusted",
  "season": 2024,
  "minimum": 40,
  "minimum_of": "rounds",
  "leaders": [
    {
      "rank": 1,
      "player_id": "9478",
      "name": "Scottie Scheffler",
      "country": "USA",
      "value": 3.754,
      "sample": 79
    },
    {
      "rank": 2,
      "player_id": "10140",
      "name": "Xander Schauffele",
      "country": "USA",
      "value": 3.164,
      "sample": 83
    },
    {
      "rank": 3,
      "player_id": "10592",
      "name": "Collin Morikawa",
      "country": "USA",
      "value": 2.421,
      "sample": 79
    }
  ],
  "count": 3
}