Skip to content

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 | preseasonoptional
teamstringoptional
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_stats itself. Point any MCP client at https://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

seasonnumber
teams[]array
List of objects
teams[].team_idstring
teams[].abbrevstring
teams[].display_namestring
teams[].gamesnumber
teams[].winsnumber
teams[].lossesnumber
teams[].ptsnumber
teams[].opp_ptsnumber
teams[].pacenumber
teams[].off_ratingnumber
teams[].def_ratingnumber
teams[].efg_pctnumber
teams[].tov_pctnumber
teams[].oreb_pctnumber
teams[].ft_ratenumber
teams[].three_ratenumber
teams[].opp_efg_pctnumber
teams[].astnumber
teams[].rebnumber
teams[].tovnumber
teams[].net_ratingnumber
countnumber
methodstring

Used in

Related endpoints

Try it

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