---
updatedAt: 2026-08-24T01:34:37.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/basketball/llms.txt
---

# Synergy Basketball Change Log

## Advanced Endpoint Package

:spiral\_calendar: **Release Date** 09/24/2025

We’ve expanded our <Anchor label="Synergy Basketball API" target="_blank" href="https://developer.sportradar.com/basketball/reference/synergy-basketball-overview">Synergy Basketball API</Anchor> with a new set of advanced endpoints designed to power deeper analysis, smarter comparisons, and more forward-looking basketball insights.

Advanced features provide context-adjusted, predictive analytics that go beyond box scores, including Shot Quality, Offensive Player Roles, Player Comps, Adjusted Team Stats, Player Projections, and Player Impact metrics. Some outputs rely on a Stat Comparison Group to ensure results are normalized within the appropriate league or competition.

The advanced endpoints are available in all leagues covered in the Synergy Basketball API. Reach out to our support team or your account representative for trial access.

See below for details on each new endpoint.

🧠 **<Anchor label="Player Roles" target="_blank" href="https://developer.sportradar.com/basketball/reference/get_advanced-basketball-league-playerroles">Player Roles</Anchor>**

Classifies players into one primary offensive role based on usage patterns and Synergy play-type data.

* Assigns one primary offensive role using Synergy play-type and usage data
* Covers 11 core offensive roles (e.g., playmaking ball handler, spot-up wing, rim-finishing big)
* Role assignments are data-driven, not position-based.
* Enables role-normalized comparisons across players.

Outputs:

* Player
* Offensive Role

🔍 **<Anchor label="Player Comparables" target="_blank" href="https://developer.sportradar.com/basketball/reference/get_advanced-basketball-league-playercomps">Player Comparables</Anchor>**

Identifies statistically similar players using a composite similarity model.

* Similarity scoring based on volume, play style, and efficiency
* Supports:
  * In-league comps
  * Transfer-specific comps
* Cross-level comps (e.g., college → NBA “role model”)
* Returns ranked comparable players with similarity scores
* Requires a minimum data threshold to generate valid comps.
* Primary output fields:
  * Player Comp
  * Similarity Score

📊 **<Anchor label="Team Adjusted Stats" target="_blank" href="https://developer.sportradar.com/basketball/reference/get_advanced-basketball-league-teamadjustedstats">Team Adjusted Stats</Anchor>**

Produces context-adjusted team performance metrics.

* Adjustments applied for:
  * Strength of opponent
  * Game location (home / away)
  * Rest and travel schedule
  * Garbage-time possessions
  * Recent performance weighting
* Designed for forward-looking evaluation, not raw results.
* Required input:
  * Stat Comparison Group
* Outputs include adjusted efficient metrics such as:
  * PPP, FG%, eFG%
  * Shot Quality
  * 3PT%, TO%, FT%

🔮 **<Anchor label="Player Projections" target="_blank" href="https://developer.sportradar.com/basketball/reference/get_advanced-basketball-league-playerprojections">Player Projections</Anchor>**

Generates forward-looking per-game player predictions.

* Updates daily as new data becomes available
* Combines historical performance, recent trends, and role-based context
* Outputs include:
  * Box score stats (points, rebounds, assists, etc.)
  * Usage and minute expectations
  * Efficiency projections
* Projection logic blends:
  * Historical performance
  * Recent trends
  * Contextual and role-based signals
* Primary output fields:
  * Projected per-game stats

📈 **<Anchor label="Player Impact Stats" target="_blank" href="https://developer.sportradar.com/basketball/reference/get_advanced-basketball-league-playerimpactstats">Player Impact Stats</Anchor>**

An all-in-one adjusted plus-minus metric capturing on-court impact.

* Measures whether a team outperforms opponents while the player is on the floor.
* Controls for teammates, opponents, and lineup context
* Captures non-box score contributions
* Requires a Stat Comparison Group
* Outputs:
  * Games Played, Total Possessions
  * Offensive Impact, Defensive Impact
  * Wins Added

🧩 **<Anchor label="Stat Comparison Groups" target="_blank" href="https://developer.sportradar.com/basketball/reference/get_advanced-basketball-league-statcomparisongroups">Stat Comparison Groups</Anchor>**

Returns stat comparison groups for a specified league.

* Defines the league-specific comparison population
* Required for:
  * Adjusted Team Stats
  * Player Impact Stat
* Includes:
  * StatComparisonGroupID
  * Comparison Group Name
  * League

<br />

## Shot Quality (SSQ) Now in Events

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Release Date
      </th>

      <th>
        Benefit
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        2/20/2026
      </td>

      <td>
        Shot Quality data is now available within the Events endpoints, including season-level aggregates.

        * Quantifies the likelihood a league-average shooter makes a shot given identical context
        * Built from defender proximity, shot type, location, movement, play type, and more
        * Normalized to isolate shot quality independent of shooter skill
        * Includes:
          * Shot Quality value
          * Shot Quality level: High (Good Looks), Medium, Low (Bad Looks)
      </td>
    </tr>
  </tbody>
</Table>

<br />

## Heave Shot Support

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Release Date
      </th>

      <th>
        Benefit
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        12/17/2025
      </td>

      <td>
        We've added a boolean flag to support heave shots.

        This `heave` attribute is present in all **Possession Events** and **Play by Plays** endpoints. When `true` it signifies a shot attempt is a <Anchor label="heave" target="_blank" href="https://developer.sportradar.com/basketball/reference/nba-change-log#heave-shot-event-type">heave</Anchor>.
      </td>
    </tr>
  </tbody>
</Table>

```json
        {
            "data": {
                "possessionId": "6940c88e1c3e0bebed0048a5",
                "game": {
                    "awayTeam": {
                        "fullName": "Detroit Pistons",
                        "conference": {
                            "name": "Eastern Conference",
                            "abbr": "EC",
                            "id": "54457dce300969b132fcfb48"
                        },
                        "division": {
                            "name": "Central Division",
                            "abbr": "CD",
                            "id": "54457dd0300969b132fcfba0"
                        },
                        "name": "Detroit",
                        "abbr": "DET",
                        "id": "54457dd3300969b132fcfe4d"
                    },
                    "competition": {
                        "name": "Regular Season excl. NBA Cup",
                        "id": "560100ac8dc7a24394b955ee"
                    },
                    "date": "2025-12-15T00:00:00Z",
                    "homeTeam": {
                        "fullName": "Boston Celtics",
                        "conference": {
                            "name": "Eastern Conference",
                            "abbr": "EC",
                            "id": "54457dce300969b132fcfb48"
                        },
                        "division": {
                            "name": "Atlantic Division",
                            "abbr": "AD",
                            "id": "54457dd0300969b132fcfb9f"
                        },
                        "name": "Boston",
                        "abbr": "BOS",
                        "id": "54457dd3300969b132fcfe3b"
                    },
                    "league": {
                        "name": "NBA",
                        "abbr": "N",
                        "id": "54457dce300969b132fcfb34"
                    },
                    "season": {
                        "name": "2025-2026",
                        "id": "68dbe5272504f23a6da2cc00"
                    },
                    "id": "68dc3ea230534aff780d9fd4"
                },
                "oPlayer": {
                    "name": "Anfernee Simons",
                    "id": "68e6fa96c30064507f31210c"
                },
                "prPlayer": {
                    "name": "Anfernee Simons",
                    "id": "68e6fa96c30064507f31210c"
                },
                "zone": false,
                "period": 4,
                "clock": 199,
                "shotClock": false,
                "homeEvent": true,
                "sob": false,
                "eob": false,
                "ato": false,
                "turnover": false,
                "possessionUpdated": "2025-12-16T04:50:50.523Z",
                "playByPlayUpdated": "2025-12-16T03:18:13.231Z",
                "offensiveString": "4 Anfernee Simons > Transition > Left Wing > Dribble Jumper > Long/3pt > Miss 3 Pts",
                "defensiveString": "Shot > Anfernee Simons > Jumper > 3 Point Attempt > Miss 3 Pts No Foul",
                "shot": "Jumper",
                "ftAttempt": 0,
                "ftMade": 0,
                "offensiveLineup": [
                    {
                        "firstName": "Jaylen",
                        "lastName": "Brown",
                        "name": "Jaylen Brown",
                        "id": "5776bc715762021398fe3f18"
                    },
                    {
                        "firstName": "Derrick",
                        "lastName": "White",
                        "name": "Derrick White",
                        "id": "6207231107c7bd5c29e1e6a8"
                    },
                    {
                        "firstName": "Neemias",
                        "lastName": "Queta",
                        "name": "Neemias Queta",
                        "id": "65234b16c0dd46415a936e1d"
                    },
                    {
                        "firstName": "Payton",
                        "lastName": "Pritchard",
                        "name": "Payton Pritchard",
                        "id": "5fd979f65fe05a0e9f63ab6b"
                    },
                    {
                        "firstName": "Anfernee",
                        "lastName": "Simons",
                        "name": "Anfernee Simons",
                        "id": "68e6fa96c30064507f31210c"
                    }
                ],
                "defensiveLineup": [
                    {
                        "firstName": "Duncan",
                        "lastName": "Robinson",
                        "name": "Duncan Robinson",
                        "id": "68e451b944d7b26aa63fe977"
                    },
                    {
                        "firstName": "Cade",
                        "lastName": "Cunningham",
                        "name": "Cade Cunningham",
                        "id": "615e4bcfe771e94fc0e9eab4"
                    },
                    {
                        "firstName": "Javonte",
                        "lastName": "Green",
                        "name": "Javonte Green",
                        "id": "68e451b944d7b26aa63fe973"
                    },
                    {
                        "firstName": "Tobias",
                        "lastName": "Harris",
                        "name": "Tobias Harris",
                        "id": "670325baff56573c7c99e0e3"
                    },
                    {
                        "firstName": "Jalen",
                        "lastName": "Duren",
                        "name": "Jalen Duren",
                        "id": "633d608040bed2399d804905"
                    }
                ],
                "external": {
                    "idsEventID": "705"
                },
                "playByPlayId": "6940c88a1c3e0bebed004727",
                "homeScore": 105,
                "awayScore": 112,
                "heave": false
            }
        },
```

***

<br />

## Sportradar ID Mapping

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Release Date
      </th>

      <th>
        Benefit
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        11/18/2025
      </td>

      <td>
        Synergy Basketball APIs now have SR IDs (`sportradarId`) included.

        For example, the <Anchor label="Teams" target="_blank" href="https://developer.sportradar.com/basketball/reference/g-league-teams">Teams</Anchor> endpoint now includes the SR IDs for each team, allowing you to connect Synergy data with Sportradar's broader ecosystem.

        For some endpoints, you can even query by SR IDs directly: `https://api.sportradar.com/synergy/basketball/nba/games?teamId=sr:competitor:3411`
      </td>
    </tr>
  </tbody>
</Table>

```json
    {
      "data": {
        "id": "54457dd3300969b132fcfe4b",
        "idsTeam": 1610612741,
        "name": "Chicago",
        "fullName": "Chicago Bulls",
        "abbr": "CHI",
        "conference": {
          "name": "Eastern Conference",
          "abbr": "EC",
          "id": "54457dce300969b132fcfb48"
        },
        "division": {
          "name": "Central Division",
          "abbr": "CD",
          "id": "54457dd0300969b132fcfba0"
        },
        "league": {
          "name": "NBA",
          "abbr": "N",
          "id": "54457dce300969b132fcfb34"
        },
        "sportradarId": "sr:competitor:3409"
      }
    },
```

***

<br />

## Synergy Basketball API Release

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Release Date
      </th>

      <th>
        Announcement
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        09/23/2025
      </td>

      <td>
        We've launched six unique Synergy Basketball APIs. These cover the **NBA**, **WNBA**, **NBA G League**, **NCAA D1 Men**, **NCAA D1 Women**, and **International** competitions.

        These APIs deliver rich, structured data on every possession of every game, including:

        * Granular metadata: play types, lineups, defensive matchups, shot coordinates, and more.
        * Career endpoints for tracking a player's journey across leagues & seasons.
        * Millions of plays and advanced metrics, helping analysts, developers, and media partners understand the game at a deeper level.
      </td>
    </tr>
  </tbody>
</Table>

<br />