Plate appearances
get_plate_appearancesUse for plate-appearance play-by-play: a whole game in order, or a batter's, pitcher's or team's season, with the base-out state before, the result, the batted ball (trajectory and location), runs, the home win probability after (our model, every plate appearance since 2015) and our run value (RE24). Filter by result, inning or runners in scoring position. Costs 10 credits.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_plate_appearances"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| risp | No | Runners in scoring position only. | |
| team | No | Batting team (id or abbreviation). | |
| limit | No | Max rows (default 200). | |
| inning | No | ||
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. | |
| offset | No | ||
| result | No | e.g. home-run, strikeout, walk, single, double, ground-out. | |
| season | No | Season (a year; default: the latest; ignored with game_id). | |
| game_id | No | ||
| batter_id | No | ||
| pitcher_id | No | ||
| season_type | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| next_offset | No | ||
| plate_appearances | Yes |