---
updatedAt: 2025-08-18T20:29:53.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/basketball/v5/llms.txt
---

# Trades

**NBA Trades** Provides summary details of all in-draft trades.

<Callout icon="⏱️" theme="default">
  ### Update Frequency

  2s Time To Live / Cache
</Callout>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "draft",
    "version": "5"
  },
  "servers": [
    {
      "url": "https://api.sportradar.com/draft/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/nba/{access_level}/v1/en/{year}/trades.{format}": {
      "get": {
        "summary": "Trades",
        "description": "**NBA Trades** Provides summary details of all in-draft trades.",
        "operationId": "nba-trades",
        "parameters": [
          {
            "name": "access_level",
            "in": "path",
            "description": "The access level of your API key",
            "schema": {
              "type": "string",
              "enum": [
                "trial",
                "production"
              ],
              "default": "trial"
            },
            "required": true
          },
          {
            "name": "year",
            "in": "path",
            "description": "Year in 4 digit format (YYYY)",
            "schema": {
              "type": "string",
              "enum": [
                "2019",
                "2020",
                "2021",
                "2022"
              ],
              "default": "2022"
            },
            "required": true
          },
          {
            "name": "format",
            "in": "path",
            "description": "Format returned",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "xml"
              ],
              "default": "json"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"draft\": {\n        \"id\": \"96517b43-ccff-428a-8906-07279b0c9922\",\n        \"year\": 2022,\n        \"start_date\": \"2022-06-23\",\n        \"end_date\": \"2022-06-23\",\n        \"status\": \"closed\",\n        \"league\": {\n            \"id\": \"4353138d-4c22-4396-95d8-5f587d2df25c\",\n            \"name\": \"NBA\",\n            \"alias\": \"NBA\"\n        },\n        \"broadcast\": {\n            \"channel\": \"206\",\n            \"network\": \"ABC, ESPN\"\n        },\n        \"venue\": {\n            \"name\": \"Barclays Center\",\n            \"address\": \"620 Atlantic Avenue\",\n            \"city\": \"Brooklyn\",\n            \"state\": \"NY\",\n            \"country\": \"USA\"\n        }\n    },\n    \"trades\": [\n        {\n            \"id\": \"bced26d2-2b01-41f8-8d1c-7db9e926f758\",\n            \"sequence\": 1652884083078,\n            \"complete\": true,\n            \"transactions\": [\n                {\n                    \"id\": \"72d9addc-c1fa-453b-8d31-fde408adbf7e\",\n                    \"to_team\": {\n                        \"id\": \"583ecae2-fb46-11e1-82cb-f4ce4684ea4c\",\n                        \"name\": \"Lakers\",\n                        \"market\": \"Los Angeles\",\n                        \"alias\": \"LAL\"\n                    },\n                    \"from_team\": {\n                        \"id\": \"583ecc9a-fb46-11e1-82cb-f4ce4684ea4c\",\n                        \"name\": \"Pelicans\",\n                        \"market\": \"New Orleans\",\n                        \"alias\": \"NOP\"\n                    },\n                    \"items\": []\n                },\n                {\n                    \"id\": \"7c805d32-d6bd-4462-8bb0-cf666a937152\",\n                    \"to_team\": {\n                        \"id\": \"583ecc9a-fb46-11e1-82cb-f4ce4684ea4c\",\n                        \"name\": \"Pelicans\",\n                        \"market\": \"New Orleans\",\n                        \"alias\": \"NOP\"\n                    },\n                    \"from_team\": {\n                        \"id\": \"583ecae2-fb46-11e1-82cb-f4ce4684ea4c\",\n                        \"name\": \"Lakers\",\n                        \"market\": \"Los Angeles\",\n                        \"alias\": \"LAL\"\n                    },\n                    \"items\": [\n                        {\n                            \"id\": \"1d4ff781-7e9f-4646-9bb1-285d413ab174\",\n                            \"type\": \"future_pick\",\n                            \"future_pick\": {\n                                \"year\": \"2024\",\n                                \"round\": \"1\"\n                            }\n                        },\n                        {\n                            \"id\": \"24152bc7-97e0-4506-965c-a9a74ad43082\",\n                            \"type\": \"money\",\n                            \"amount\": \"undefined\"\n                        },\n                        {\n                            \"id\": \"30b265c7-b24e-480f-9429-3d74de52f843\",\n                            \"type\": \"pick\",\n                            \"pick\": {\n                                \"id\": \"97a78186-f6cf-4774-b8a5-dc07eb020ebf\",\n                                \"number\": 8,\n                                \"overall\": 8,\n                                \"supplemental\": false,\n                                \"compensatory\": false,\n                                \"round\": {\n                                    \"id\": \"973714f3-4efa-4082-8cfe-f82240327cf5\",\n                                    \"number\": 1,\n                                    \"start_date\": \"2022-06-23\",\n                                    \"end_date\": \"2022-06-23\"\n                                }\n                            }\n                        },\n                        {\n                            \"id\": \"47b6dec4-8ff3-4163-a7ba-c2bc50f0002a\",\n                            \"type\": \"future_pick\",\n                            \"future_pick\": {\n                                \"year\": \"2023\",\n                                \"round\": \"1\"\n                            }\n                        }\n                    ]\n                }\n            ]\n        }\n    ],\n    \"_comment\": \"Generation started @ 2022-11-16 20:57:17 +0000 ended @ 2022-11-16 20:57:17 +0000\"\n}\n"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "draft": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "example": "96517b43-ccff-428a-8906-07279b0c9922"
                        },
                        "year": {
                          "type": "integer",
                          "example": 2022,
                          "default": 0
                        },
                        "start_date": {
                          "type": "string",
                          "example": "2022-06-23"
                        },
                        "end_date": {
                          "type": "string",
                          "example": "2022-06-23"
                        },
                        "status": {
                          "type": "string",
                          "example": "closed"
                        },
                        "league": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "example": "4353138d-4c22-4396-95d8-5f587d2df25c"
                            },
                            "name": {
                              "type": "string",
                              "example": "NBA"
                            },
                            "alias": {
                              "type": "string",
                              "example": "NBA"
                            }
                          }
                        },
                        "broadcast": {
                          "type": "object",
                          "properties": {
                            "channel": {
                              "type": "string",
                              "example": "206"
                            },
                            "network": {
                              "type": "string",
                              "example": "ABC, ESPN"
                            }
                          }
                        },
                        "venue": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "example": "Barclays Center"
                            },
                            "address": {
                              "type": "string",
                              "example": "620 Atlantic Avenue"
                            },
                            "city": {
                              "type": "string",
                              "example": "Brooklyn"
                            },
                            "state": {
                              "type": "string",
                              "example": "NY"
                            },
                            "country": {
                              "type": "string",
                              "example": "USA"
                            }
                          }
                        }
                      }
                    },
                    "trades": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "example": "bced26d2-2b01-41f8-8d1c-7db9e926f758"
                          },
                          "sequence": {
                            "type": "integer",
                            "example": 1652884083078,
                            "default": 0
                          },
                          "complete": {
                            "type": "boolean",
                            "example": true,
                            "default": true
                          },
                          "transactions": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "example": "72d9addc-c1fa-453b-8d31-fde408adbf7e"
                                },
                                "to_team": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string",
                                      "example": "583ecae2-fb46-11e1-82cb-f4ce4684ea4c"
                                    },
                                    "name": {
                                      "type": "string",
                                      "example": "Lakers"
                                    },
                                    "market": {
                                      "type": "string",
                                      "example": "Los Angeles"
                                    },
                                    "alias": {
                                      "type": "string",
                                      "example": "LAL"
                                    }
                                  }
                                },
                                "from_team": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string",
                                      "example": "583ecc9a-fb46-11e1-82cb-f4ce4684ea4c"
                                    },
                                    "name": {
                                      "type": "string",
                                      "example": "Pelicans"
                                    },
                                    "market": {
                                      "type": "string",
                                      "example": "New Orleans"
                                    },
                                    "alias": {
                                      "type": "string",
                                      "example": "NOP"
                                    }
                                  }
                                },
                                "items": {
                                  "type": "array"
                                }
                              }
                            }
                          }
                        }
                      }
                    },
                    "_comment": {
                      "type": "string",
                      "example": "Generation started @ 2022-11-16 20:57:17 +0000 ended @ 2022-11-16 20:57:17 +0000"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```