Trades (Team Roster Changes) Object

[
  {
    "id": "PLYR_8a0aa051ca4a42d3b2e9af90eb69224f",
    "sportsdataioId": "20003120",
    "oddsjamId": "26C122C3B220",
    "sportradarId": "39de0b5b-8cf5-41f7-baa3-9b19c71f8c14",
    "firstName": "Miles",
    "lastName": "Norris",
    "sportId": "SPRT_basketball",
    "fullName": "Miles Norris",
    "currentTeams": []
  },
  {
    "id": "PLYR_6e8c8f093550447c8f71203eae7d14b7",
    "sportsdataioId": "20001886",
    "oddsjamId": "C2F0D07AEE41",
    "sportradarId": "f01d5d8d-f949-437a-a23f-3835c0939ced",
    "firstName": "Chris",
    "lastName": "Boucher",
    "sportId": "SPRT_basketball",
    "fullName": "Chris Boucher",
    "currentTeams": [
      {
        "id": "TEAM_0bea24fff0ba45a6ba2f88b0217d224e",
        "fullName": "Boston Celtics"
      }
    ]
  },
  {
    "id": "PLYR_576e9291631f4e728e87678a4ffb5adb",
    "sportsdataioId": "20003517",
    "oddsjamId": null,
    "sportradarId": null,
    "firstName": "RJ",
    "lastName": "Luis Jr.",
    "sportId": "SPRT_basketball",
    "fullName": "RJ Luis Jr.",
    "currentTeams": [
      {
        "id": "TEAM_0bea24fff0ba45a6ba2f88b0217d224e",
        "fullName": "Boston Celtics"
      }
    ]
  },
  {
    "id": "PLYR_69c28a672e7245e9818e75b2f598a2bf",
    "sportsdataioId": "20001708",
    "oddsjamId": "BC330A541872",
    "sportradarId": "fae899bc-3fc7-43d9-b2c9-35721d11e438",
    "firstName": "Georges",
    "lastName": "Niang",
    "sportId": "SPRT_basketball",
    "fullName": "Georges Niang",
    "currentTeams": [
      {
        "id": "TEAM_76dd43110aff4b61bd62e0b66f75d264",
        "fullName": "Utah Jazz"
      }
    ]
  },
  {
    "id": "PLYR_c277f3e8153f4169882f6778c359e3c5",
    "sportsdataioId": "20002907",
    "oddsjamId": "0EAB71830651",
    "sportradarId": null,
    "firstName": "Ron",
    "lastName": "Harper Jr.",
    "sportId": "SPRT_basketball",
    "fullName": "Ron Harper Jr.",
    "currentTeams": [
      {
        "id": "TEAM_0bea24fff0ba45a6ba2f88b0217d224e",
        "fullName": "Boston Celtics"
      }
    ]
  },
  {
    "id": "PLYR_75026b81bead48aa958e3be62902fe37",
    "sportsdataioId": "20002902",
    "oddsjamId": "BB2866815B25",
    "sportradarId": "6e468041-8174-4161-8c1d-8ac620e0cbb0",
    "firstName": "JD",
    "lastName": "Davison",
    "sportId": "SPRT_basketball",
    "fullName": "JD Davison",
    "currentTeams": [
      {
        "id": "TEAM_076cff7808b04198b822a65b12d5fbd9",
        "fullName": "Houston Rockets"
      }
    ]
  },
  {
    "id": "PLYR_780667e860dc46c5ba3febdfc41cc7d7",
    "sportsdataioId": "20002653",
    "oddsjamId": "AC8DB4BD54F1",
    "sportradarId": "9fff97c3-676d-4c27-ab63-8d02540bb008",
    "firstName": "Jaden",
    "lastName": "Springer",
    "sportId": "SPRT_basketball",
    "fullName": "Jaden Springer",
    "currentTeams": [
      {
        "id": "TEAM_7ee261c80a394c59a36a965a6e70c2f4",
        "fullName": "New Orleans Pelicans"
      }
    ]
  }
]

Endpoints

📈 team roster changes (trades)

Note: This endpoint returns players who have joined or left a specific team within the last 30 days, not traditional trade transaction records.

Player Object Structure

Each item in the response array represents a player with recent roster changes for the specified team.

id (string)

Unique player identifier with format PLYR_*.

sportsdataioId (string)

External identifier from SportsData.io API for this player.

oddsjamId (string)

External identifier from OddsJam API for this player.

sportradarId (string)

External identifier from Sportradar API for this player.

firstName (string)

Player's first name.

lastName (string)

Player's last name.

sportId (string)

Sport identifier with format SPRT_* (e.g., "SPRT_basketball", "SPRT_americanfootball").

fullName (string)

Player's full display name (firstName + lastName).

currentTeams (array)

Array of teams the player is currently rostered on. May be empty if the player was recently released or is a free agent.

Team Object Structure

id (string): Unique team identifier with format TEAM_*
fullName (string): Team's full display name

injury (object|null)

Current injury information for the player. Only present if injuries=true query parameter is used and the player has an active injury. Contains injury details including status, body part, and description.

Roster Change Logic

The endpoint identifies "trades" by looking for players with roster changes in the last 30 days:

Players who joined the team: RosterSpot.startDate >= 30 days ago
Players who left the team: RosterSpot.endDate >= 30 days ago

Players in the currentTeams array are currently rostered, while players with empty currentTeams arrays have been released or are free agents.

Usage Examples

Get recent roster changes for Lakers:

GET /v1/trades/TEAM_4c55dc8e7a3b4b21b0509d93b49f8a33

Include injury information:

GET /v1/trades/TEAM_4c55dc8e7a3b4b21b0509d93b49f8a33?injuries=true

Limit to 5 most recent changes:

GET /v1/trades/TEAM_4c55dc8e7a3b4b21b0509d93b49f8a33?limit=5