Skip to content

get_pitch_mix

5 creditsStats + aggregationPOST /v1/get_pitch_mix

Data refreshed · changelog

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
Player id.
seasonnumber | stringoptional
Season (a year; default: the latest; ignored with game_id).
season_typeenum: regular | postseason | alloptional
regular, postseason, or all (default): which games' pitches.

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": 2025
}'

Response

json
{
  "pitcher": {
    "id": "31864",
    "name": "Taijuan Walker"
  },
  "season": 2025,
  "pitches": 2079,
  "mix": [
    {
      "pitch_type": "FC",
      "name": "Cutter",
      "pitches": 634,
      "usage": 0.305,
      "avg_velocity": 86.6,
      "max_velocity": 90,
      "whiff_rate": 0.195,
      "ball_rate": 0.322,
      "in_play": 106
    },
    {
      "pitch_type": "FS",
      "name": "Splitter",
      "pitches": 466,
      "usage": 0.224,
      "avg_velocity": 86.9,
      "max_velocity": 90,
      "whiff_rate": 0.201,
      "ball_rate": 0.448,
      "in_play": 105
    },
    {
      "pitch_type": "SI",
      "name": "Sinker",
      "pitches": 420,
      "usage": 0.202,
      "avg_velocity": 91.6,
      "max_velocity": 95,
      "whiff_rate": 0.109,
      "ball_rate": 0.345,
      "in_play": 87
    }
  ],
  "count": 6
}

Response fields

pitcherobject
pitcher.idstring
pitcher.namestring
seasonnumber
pitchesnumber
mix[]array
List of objects
mix[].pitch_typestring
mix[].namestring
mix[].pitchesnumber
mix[].usagenumber
mix[].avg_velocitynumber
mix[].max_velocitynumber
mix[].whiff_ratenumber
mix[].ball_ratenumber
mix[].in_playnumber
countnumber

Used in

Related endpoints

Try it

500 free credits every month: 100 calls to get_pitch_mix, and no card.