Most Often Guarded By & Defensive Assignments
player_matchupsUse this when the user asks who guards an NBA player most often, how a player scored against a given defender, or whom a defender was matched up on and how those players scored against him. Returns, for a player_id and a season (2020-21 on), his most frequent defenders and, as a defender, the players he guarded most, each pair as season sums: games, minutes matched, share of his matched time, points, points per 100 possessions and the difference from the scorer's own rate (only from five matched minutes), field goals and threes made and attempted; last season beside it early in a season. Not for how a team defends a position: use defense_vs_position; not for his own averages: use player_profile.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"player_id": "<player_id>"
},
"name": "player_matchups"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| league | No | League: "nba" (defensive matchups are tracked for the NBA). | nba |
| season | No | Optional season year (2026 = 2025-26; from 2021). Defaults to the current season. | |
| player_id | Yes | Numeric player ID from search. |