nba

NBA player per-season cap hit and salary (Edge and above)

Changed on

The per-season breakdown behind /contracts: cap hit, total cash, base salary and the league salary rank for that season. Money is whole US dollars.

EDGE AND ABOVE, same refusal as /contracts.

MORE THAN ONE ROW PER SEASON IS REAL DATA. A player traded mid-deal, or signed to a second contract inside one league year, has two rows for that season and both figures are true, so nothing here is deduplicated.

Coverage: 3,586 contract-seasons across 456 players, seasons 2011 through 2031.

get/v1/nba/players/{id}/contract-seasons

Request

  • Base URL: https://api.bigballsdata.com
  • URL: https://api.bigballsdata.com/v1/nba/players/{id}/contract-seasons
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

idstring uuid required

BigBalls player id (UUID from /v1/players)

Query parameters

seasoninteger

Season LABEL, not a calendar year.

limitinteger
offsetinteger
pageinteger

Alias for offset: page=2 means offset=limit. An explicit offset wins.

Response

ok

Example response

{
  "meta": {
    "currency": "USD"
  }
}

Changes