Skip to content

get_team_stats

5 creditsStats + aggregationPOST /v1/get_team_stats

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).

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": 2024,
  "team": "BOS"
}'

Response

json
{
  "season": 2024,
  "teams": [
    {
      "team_id": "2",
      "abbrev": "BOS",
      "display_name": "Boston Celtics",
      "games": 82,
      "wins": 64,
      "losses": 18,
      "pts": 120.6,
      "opp_pts": 109.2,
      "pace": 100.3,
      "off_rating": 120.2,
      "def_rating": 108.9,
      "efg_pct": 0.578,
      "tov_pct": 0.119,
      "oreb_pct": 0.249,
      "ft_rate": 0.224,
      "three_rate": 0.471,
      "opp_efg_pct": 0.523,
      "ast": 26.9,
      "reb": 46.3,
      "tov": 11.9,
      "net_rating": 11.3
    }
  ],
  "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

Related endpoints

Try it

500 credits free on signup: 100 calls to get_team_stats, and no card.