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_mixitself. Point any MCP client athttps://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
pitcherobjectpitcher.idstringpitcher.namestringseasonnumberpitchesnumbermix[]array- List of objects
mix[].pitch_typestringmix[].namestringmix[].pitchesnumbermix[].usagenumbermix[].avg_velocitynumbermix[].max_velocitynumbermix[].whiff_ratenumbermix[].ball_ratenumbermix[].in_playnumbercountnumber
Used in
- MLB pitch-by-pitch data: MLB pitch-by-pitch since 2015 (about 98% of games to 2017, all from 2018): pitch type, velocity, location and the count, with the plate appearance. REST or MCP.
- Guide: How do I get a pitcher's pitch mix and whiff rate in Python?
Related endpoints
list_teams1 cr
Filters by the same season.
Team ids, abbreviations and colours for a season
get_games2 cr
Filters by the same season and season_type.
Games with runs, hits and errors by season, date, range or team
get_plate_appearances10 cr
Filters by the same pitcher_id and season.
Plate-appearance play-by-play with base-out state, batted ball, win probability, RE24
get_pitches10 cr
Filters by the same pitcher_id and season.
Pitch-by-pitch: count, type, velocity, location, result
Try it
500 free credits every month: 100 calls to get_pitch_mix, and no card.