get_pitch_mix

5 creditsStats + aggregationPOST /v1/get_pitch_mix

A pitcher's arsenal: usage, velocity, whiff rate per pitch type

Use it when you want a pitcher's arsenal for a season: usage, velocity, whiff rate and ball rate per pitch type.

Parameters

pitcher_idstringrequired: ESPN athlete id.
seasonnumber | stringoptional: Season (a year; default: the latest; ignored with game_id).

Notes

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

Response

json

{
  "pitcher": {
    "id": "31864",
    "name": "Taijuan Walker"
  },
  "season": 2024,
  "pitches": 1435,
  "mix": [
    {
      "pitch_type": "SI",
      "name": "Sinker",
      "pitches": 389,
      "usage": 0.271,
      "avg_velocity": 90.7,
      "max_velocity": 93,
      "whiff_rate": 0.084,
      "ball_rate": 0.347,
      "in_play": 78
    },
    {
      "pitch_type": "FS",
      "name": "Splitter",
      "pitches": 313,
      "usage": 0.218,
      "avg_velocity": 86.2,
      "max_velocity": 89,
      "whiff_rate": 0.164,
      "ball_rate": 0.371,
      "in_play": 82
    },
    {
      "pitch_type": "ST",
      "name": "Sweeper",
      "pitches": 236,
      "usage": 0.164,
      "avg_velocity": 84.7,
      "max_velocity": 88,
      "whiff_rate": 0.287,
      "ball_rate": 0.364,
      "in_play": 57
    }
  ],
  "count": 6
}