get_team_stats
5 creditsStats + aggregationPOST /v1/get_team_stats
Data refreshed · changelog
Pace, offensive, defensive and net rating, and the four factors
Use it when you want team pace and efficiency: offensive, defensive and net rating per 100 possessions and the four factors.
Parameters
seasonnumber | stringoptional- Season by the year it ends: 2025 = 2024-25 (default: the latest).
season_typeenum: regular | postseason | play_in | preseasonoptionalteamstringoptional- One team (id or abbreviation).
beforestringoptional- YYYY-MM-DD: only games played before this date (point-in-time stats).
leagueenum: nba | wnba | ncaam | ncaaw | nbloptional- League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw, nbl.
Notes
- Over MCP, ask for it in plain English and the client calls
get_team_statsitself. Point any MCP client athttps://mcp.dunkapi.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.dunkapi.com/v1/get_team_stats \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"season": 2026,
"team": "BOS"
}'Response
json
{
"season": 2026,
"teams": [
{
"team_id": "2",
"abbrev": "BOS",
"display_name": "Boston Celtics",
"games": 82,
"wins": 56,
"losses": 26,
"pts": 114.9,
"opp_pts": 107.2,
"pace": 98,
"off_rating": 117.2,
"def_rating": 109.4,
"efg_pct": 0.553,
"tov_pct": 0.126,
"oreb_pct": 0.292,
"ft_rate": 0.207,
"three_rate": 0.467,
"opp_efg_pct": 0.523,
"ast": 24.6,
"reb": 46.4,
"tov": 12.3,
"net_rating": 7.8
}
],
"count": 1,
"method": "Possessions = FGA - OREB + TOV + 0.44 x FTA, averaged over both teams. Ratings are points per 100 possessions."
}Response fields
seasonnumberteams[]array- List of objects
teams[].team_idstringteams[].abbrevstringteams[].display_namestringteams[].gamesnumberteams[].winsnumberteams[].lossesnumberteams[].ptsnumberteams[].opp_ptsnumberteams[].pacenumberteams[].off_ratingnumberteams[].def_ratingnumberteams[].efg_pctnumberteams[].tov_pctnumberteams[].oreb_pctnumberteams[].ft_ratenumberteams[].three_ratenumberteams[].opp_efg_pctnumberteams[].astnumberteams[].rebnumberteams[].tovnumberteams[].net_ratingnumbercountnumbermethodstring
Used in
- NBA shot chart data: The x/y location of every NBA field goal attempt in the play-by-play since 2003-04, with distance, zone, result and expected points. REST or MCP.
- Guide: How do I compare NBA team pace and efficiency in pandas?
Related endpoints
list_teams1 cr
Returns the team this one takes.
Team ids, abbreviations and colours for a season
list_games2 cr
Takes the team this one returns.
Games with scores by season, date, range or team
get_schedule2 cr
Takes the team this one returns.
Upcoming games with the median line across sportsbooks
get_standings2 cr
Returns the team this one takes.
Standings from every final game: overall, conference, home, away, last 10
Try it
500 free credits every month: 100 calls to get_team_stats, and no card.