Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Integration Guides

NBA Draft

This guide covers essential feeds to monitor draft picks and strategies for building an NBA Draft solution, ensuring you can effectively integrate and display draft data in your applications.

Understanding NBA Draft Picks and Player Selection

What is the NBA Draft?

The NBA Draft is an annual event where teams select eligible college and G-League players, shaping their rosters and providing a spectacle for fans. You can access NBA Draft Data using our Draft feeds.

📆

When Is the Draft Made Available in the API?

Draft data becomes available in the API after the NBA finalizes the draft order, typically following the NBA Draft Lottery in mid-May. NBA prospect information, however, after the NBA Early-Entrant deadline which happens a few weeks before the draft, providing details on potential draftable players. This feed includes a list of prospects, with each player’s source ID matching their college player ID for consistent tracking across datasets.


When should I expect to see prospect data in the Prospects endpoint?

College prospects will appear after the NCAA Early-Entrant withdrawal deadline has passed.

International prospects will appear after the the NBA Early-Entrant withdrawal deadline has passed.


When should I expect pre-draft trades to be reflected in Trades and Draft Summary endpoints?

The Trades and Draft Summary endpoints will reflect pre-draft trades after the NBA Draft Lottery has occurred.


What are the three different IDs in the Draft feeds?

The three different IDs in the Draft feeds typically include:

  • Player ID: A unique identifier for the player across the API.
  • Team ID: The ID representing the NBA team that selects the player.
  • Draft ID: A unique identifier for the specific draft event.

Note: For NCAAB players, their unique IDs do not follow them when they get drafted to the NBA. For more detailed information on ID handling, please refer to the ID Handling section.


How do teams determine how many draft picks they get?

  • Standard Picks: Each NBA team typically starts with two picks — one in the first round and one in the second round.

  • Draft Order: The draft order is determined by a combination of the NBA Draft Lottery and team standings. The teams that did not make the playoffs enter the lottery, where the odds of receiving a higher pick increase based on how poor their record was in the previous season. Teams that made the playoffs receive picks based on their regular-season finish, with the team with the best record picking last in each round. The draft order becomes available in our API once fully established.

  • Trading: NBA teams frequently trade their draft picks, both current and future, as part of deals involving players or other picks. Teams may trade up to secure a higher-ranked player or trade down to acquire more picks or assets for the future.


How is the draft data within the draft feeds populated?

Sportradar’s experts seed players from our NCAA database. We use a variety of sources to generate a comprehensive list of players who expect to be drafted. The list is typically 100+ players.


When are drafted players added to the core endpoints?

Drafted players will be available on their NBA team (Team Profile) after each completed round.


Can a player refuse to play for the team that drafts them?

  • While uncommon, a player can refuse to join the team that drafted them, though this can negatively impact their reputation and future opportunities within the NBA.


Prospects

Prospects refer to college basketball players who are eligible and considered potential selections for teams during the NBA Draft. The Prospects feed provides a list of upcoming or historical draft prospects for a given year.

🏀

When Do Prospects Receive Their League ID?

The league_id will appear once the player has been drafted and exported to the NBA API. Typically, it happens the day after they are drafted.


Recommended Pull Frequency:

  • Prospects are added to our API after the NCAA basketball season concludes and following their declaration by April.
  • International players can declare at any time, but most tend to enter the draft by April or May.
  • You can pull this feed on an as-needed basis before, during or after the draft.
  • The TTL/Cache is every two seconds.

👍

Tip - Monitor the Prospects Feed During the Draft

Pull the Prospects feed throughout the draft in case new players are created during the draft.


Example - Prospects:

{
  "draft": {
    "id": "8df66104-0151-49e9-9c35-a95f663a9d4a",
    "year": 2024,
    "start_date": "2024-06-26",
    "end_date": "2024-06-27",
    "status": "closed",
    "league": {
      "id": "4353138d-4c22-4396-95d8-5f587d2df25c",
      "name": "NBA",
      "alias": "NBA"
    },
    "broadcast": {
      "channel": "206",
      "network": "ABC, ESPN"
    },
    "venue": {
      "name": "Barclays Center",
      "address": "620 Atlantic Avenue",
      "city": "Brooklyn",
      "state": "NY",
      "country": "USA"
    }
  },
  "prospects": [
    {
      "id": "b34b913c-50f7-4551-a613-369b0038906d",
      "source_id": "034345a0-ca68-4d80-92ed-6968d03a4def",
      "first_name": "Nae'Qwan",
      "last_name": "Tomlin",
      "name": "Nae'Qwan Tomlin",
      "position": "F",
      "height": 82,
      "weight": 210,
      "experience": "SR",
      "birth_place": "Harlem, NY, USA",
      "team_name": "Kansas State",
      "conference": {
        "id": "2853cf4d-6d62-4ec6-8e2c-d69f7a01a557",
        "name": "Big 12",
        "alias": "BIG12"
      },
      "division": {
        "id": "c5a8d640-5093-4044-851d-2c562e929994",
        "name": "NCAA Division I",
        "alias": "D1"
      },
      "team": {
        "id": "d203f38a-a166-4258-bca2-e161b591ecfb",
        "name": "Wildcats",
        "market": "Kansas State",
        "alias": "KSU"
      }
    },
    {
      "id": "beea58cc-582a-4cf0-96b7-6ead1cc27b1e",
      "source_id": "2edc1da2-d5b3-4401-b4ff-84d2110564a9",
      "first_name": "Dylan",
      "last_name": "Disu",
      "name": "Dylan Disu",
      "position": "F",
      "height": 81,
      "weight": 225,
      "experience": "GR",
      "birth_place": "Pflugerville, TX, USA",
      "team_name": "Texas",
      "conference": {
        "id": "2853cf4d-6d62-4ec6-8e2c-d69f7a01a557",
        "name": "Big 12",
        "alias": "BIG12"
      },
      "division": {
        "id": "c5a8d640-5093-4044-851d-2c562e929994",
        "name": "NCAA Division I",
        "alias": "D1"
      },
      "team": {
        "id": "6ed15092-2670-450a-99c2-61d861e87644",
        "name": "Longhorns",
        "market": "Texas",
        "alias": "TEX"
      }
    },
    {
      "id": "1e9cabb7-4a22-4f65-a1b5-6df1f5835f65",
      "source_id": "0e14b146-b540-4958-a271-de8d31835691",
      "first_name": "Keshad",
      "last_name": "Johnson",
      "name": "Keshad Johnson",
      "position": "F",
      "height": 79,
      "weight": 225,
      "experience": "SR",
      "birth_place": "Oakland, CA, USA",
      "team_name": "Arizona",
      "conference": {
        "id": "04d5255d-b2dc-43df-9fa8-d296b0f8ccd7",
        "name": "Pacific 12",
        "alias": "PAC12"
      },
      "division": {
        "id": "c5a8d640-5093-4044-851d-2c562e929994",
        "name": "NCAA Division I",
        "alias": "D1"
      },
      "team": {
        "id": "9b166a3f-e64b-4825-bb6b-92c6f0418263",
        "name": "Wildcats",
        "market": "Arizona",
        "alias": "ARIZ"
      }
    }
  ]
}

This code example displays details for NBA draft prospects, including player ID, name, position, measurements, college team, and experience level. For instance, it lists Dylan Disu, a forward of for the Texas Longhorns, noting his height, weight, senior status, and team information.

Use Cases:

  1. Player Scouting and Analysis: Integrate this feed into your sports news site or app to enrich content with detailed profiles on each player’s background, college achievements, and physical stats.

  2. Fantasy Basketball Applications: Utilize the feed to provide deep insights and analytics, helping your users make more informed choices during fantasy draft seasons.

  3. Recruitment and Scouting Tools: Use the data to track former college players as they progress through the draft, offering a comprehensive view of their transition from college to the pros on your recruiting website.

  4. Sports Betting Platforms: Employ detailed prospect information to assist in setting odds for draft-related bets, giving bettors access to extensive data on each player’s potential and background.


Top Prospects

The Top Prospects feed provides a list of the top prospects for a given year, including players identified as having exceptional potential and performance in college basketball, making them highly anticipated draft selections.

🏀

What Is the Difference Between Top Prospects and Prospects?

Top Prospects is a higher-tier subset of Prospects, representing the most highly regarded or anticipated players expected to be drafted early. The use case for this is to allow users or applications to focus on the most notable players in the draft, offering more detailed scouting and tracking for these key athletes.

How is an NBA prospect specified as a top prospect?

Top prospects are subjective. We use the same sources for top prospects as we do when creating the initial draft pool.


Recommended Pull Frequency:

  • Prospects are added to our API after the NCAA basketball season concludes and following their declaration by April.
  • International players can declare at any time, but most tend to enter the draft by April or May.
  • Pull on an as-needed basis.
  • The TTL/Cache is every two seconds.

Example - Top Prospects:

{
  "draft": {
    "id": "8df66104-0151-49e9-9c35-a95f663a9d4a",
    "year": 2024,
    "start_date": "2024-06-26",
    "end_date": "2024-06-27",
    "status": "closed",
    "league": {
      "id": "4353138d-4c22-4396-95d8-5f587d2df25c",
      "name": "NBA",
      "alias": "NBA"
    },
    "broadcast": {
      "channel": "206",
      "network": "ABC, ESPN"
    },
    "venue": {
      "name": "Barclays Center",
      "address": "620 Atlantic Avenue",
      "city": "Brooklyn",
      "state": "NY",
      "country": "USA"
    }
  },
  "prospects": [
    {
      "id": "8fb1196f-f3c4-428e-8caf-ca086f16a79c",
      "league_id": "50e0c4e6-dfe4-42ca-bf18-aa2630be21c9",
      "first_name": "Tidjane",
      "last_name": "Salaun",
      "name": "Tidjane Salaun",
      "position": "F",
      "team_name": "Cholet Basket",
      "height": 81,
      "weight": 212,
      "birth_place": "Paris,, FRA",
      "top_prospect": true
    },
    {
      "id": "52fc615a-cfe6-4f0e-ae33-2f396c1dcdcf",
      "league_id": "bf6b4aed-c007-41eb-b4e5-08b99f292ec2",
      "first_name": "Nikola",
      "last_name": "Topic",
      "name": "Nikola Topic",
      "position": "G",
      "team_name": "KK Crvena Zvezda",
      "height": 78,
      "weight": 201,
      "birth_place": "Novi Sad,, SRB",
      "top_prospect": true
    },
    {
      "id": "05fb794e-dc10-4d3c-9125-5d043fb3b0b4",
      "league_id": "3f34ce93-c0ad-4868-bab4-c6d83909ff78",
      "first_name": "Zaccharie",
      "last_name": "Risacher",
      "name": "Zaccharie Risacher",
      "position": "F",
      "team_name": "JL Bourg-en-Bresse",
      "height": 82,
      "weight": 210,
      "birth_place": "Malaga,, ESP",
      "top_prospect": true
    },
    {
      "id": "87108871-05fb-420a-b701-b26b47051a7a",
      "league_id": "fe7a0b28-a8f9-42ad-b345-0f69d51d365f",
      "first_name": "Matas",
      "last_name": "Buzelis",
      "name": "Matas Buzelis",
      "position": "F",
      "high_school": "Sunrise Christian Academy (KS)",
      "team_name": "G-League Ignite",
      "height": 81,
      "weight": 209,
      "birth_place": "Chicago, IL, USA",
      "top_prospect": true
    },
    {
      "id": "c6d6e652-3031-4fe0-998c-7ca4ac1fff71",
      "league_id": "c0a19a3a-7327-4586-a58e-f7b5742ecae8",
      "first_name": "Bobi",
      "last_name": "Klintman",
      "name": "Bobi Klintman",
      "position": "F",
      "team_name": "Cairns",
      "height": 81,
      "weight": 212,
      "birth_place": "Malmo,, SWE",
      "top_prospect": true
    },
    {
      "id": "06123821-a875-431b-9716-8b72534994e6",
      "league_id": "fe4c4f99-5dfb-4e32-b69a-da8c5a779c27",
      "first_name": "Alex",
      "last_name": "Sarr",
      "name": "Alex Sarr",
      "position": "F",
      "team_name": "Overtime Elite",
      "height": 84,
      "weight": 224,
      "birth_place": "Bordeaux,, FRA",
      "top_prospect": true
    },
    {
      "id": "6275d826-d440-4a31-8966-a8a340edc74c",
      "league_id": "a2b3bc56-566e-443d-affe-7837a59a1ed7",
      "first_name": "Ron",
      "last_name": "Holland",
      "name": "Ron Holland",
      "position": "F",
      "high_school": "Duncanville (TX)",
      "team_name": "G-League Ignite",
      "height": 80,
      "weight": 206,
      "birth_place": "Duncanville, TX, USA",
      "top_prospect": true
    },
    {
      "id": "d5a3a8c0-dceb-4de7-b49c-f35e66258857",
      "league_id": "97a21ab1-02c7-4dc0-89f9-9d43aa04c008",
      "first_name": "Tyler",
      "last_name": "Smith",
      "name": "Tyler Smith",
      "position": "F",
      "high_school": "George Bush (TX)",
      "team_name": "G-League Ignite",
      "height": 81,
      "weight": 224,
      "birth_place": "New Orleans, LA, USA",
      "top_prospect": true
    }
  ]
}

The response provides a list of top prospects for the 2024 NBA Draft, offering detailed information for each player. This includes their full names, positions, teams (both international and G-League teams), physical stats such as height and weight, as well as their birthplaces. Players like Matas Buzelis (G-League Ignite) and Ron Holland (G-League Ignite) are highlighted as top prospects, demonstrating the variety of players entering the draft from various leagues worldwide. Additionally, it outlines the venue for the NBA Draft at the Barclays Center, taking place from June 26 to June 27, 2024.


Uses Cases:

  1. Enhance Sports Media Applications: Incorporate detailed profiles and analytics on top draft picks into your sports apps. This helps engage users by providing insights on how these high-profile players might impact team dynamics and league outcomes.
  2. Develop Team Strategy Tools: Use the data to build tools for coaching staffs or analysts that assess the strengths and weaknesses of top draft picks, aiding in the development of game strategies and preparations against teams with new key players.


Draft Summary

The Draft Summary feed provides pre-draft pick order with live pick selections during the draft. Displays information on draft rounds, picks, teams, and prospects for a given draft year.

Recommended Pull Frequency:

  • Updates are made in real-time as changes are made to pick selections.
  • The TTL/Cache is every two seconds.
  • Request as fast as every two seconds (matching the TTL) when the draft is live.
  • Summary and Trade feeds should be requested 10 minutes before the scheduled start.

Example - Draft Summary:

{
  "draft": {
    "id": "8df66104-0151-49e9-9c35-a95f663a9d4a",
    "year": 2024,
    "start_date": "2024-06-26",
    "end_date": "2024-06-27",
    "status": "closed",
    "league": {
      "id": "4353138d-4c22-4396-95d8-5f587d2df25c",
      "name": "NBA",
      "alias": "NBA"
    },
    "broadcast": {
      "channel": "206",
      "network": "ABC, ESPN"
    },
    "venue": {
      "name": "Barclays Center",
      "address": "620 Atlantic Avenue",
      "city": "Brooklyn",
      "state": "NY",
      "country": "USA"
    }
  },
  "rounds": [
    {
      "id": "43a70a28-42e7-4947-8705-223fe28ac2f0",
      "number": 1,
      "start_date": "2024-06-26",
      "end_date": "2024-06-26",
      "status": "closed",
      "picks": [
        {
          "id": "aad63756-24ca-4bee-80fa-4e57692cac45",
          "number": 1,
          "overall": 1,
          "team": {
            "id": "583ecb8f-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Hawks",
            "market": "Atlanta",
            "alias": "ATL"
          },
          "prospect": {
            "id": "05fb794e-dc10-4d3c-9125-5d043fb3b0b4",
            "league_id": "3f34ce93-c0ad-4868-bab4-c6d83909ff78",
            "first_name": "Zaccharie",
            "last_name": "Risacher",
            "name": "Zaccharie Risacher",
            "position": "F",
            "team_name": "JL Bourg-en-Bresse",
            "height": 82,
            "weight": 210,
            "birth_place": "Malaga,, ESP",
            "top_prospect": true
          }
        },
        {
          "id": "964af823-3574-44c6-a908-fcba2fe5594c",
          "number": 2,
          "overall": 2,
          "team": {
            "id": "583ec8d4-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Wizards",
            "market": "Washington",
            "alias": "WAS"
          },
          "prospect": {
            "id": "06123821-a875-431b-9716-8b72534994e6",
            "league_id": "fe4c4f99-5dfb-4e32-b69a-da8c5a779c27",
            "first_name": "Alex",
            "last_name": "Sarr",
            "name": "Alex Sarr",
            "position": "F",
            "team_name": "Overtime Elite",
            "height": 84,
            "weight": 224,
            "birth_place": "Bordeaux,, FRA",
            "top_prospect": true
          }
        },
        {
          "id": "e900281f-1129-49ed-910f-aaa75aa80e46",
          "number": 3,
          "overall": 3,
          "traded": true,
          "team": {
            "id": "583ecb3a-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Rockets",
            "market": "Houston",
            "alias": "HOU"
          },
          "prospect": {
            "id": "ae0af178-1331-4d04-aa82-ebe40b09567a",
            "source_id": "7c734f74-c801-4628-9582-eab3e33a8a89",
            "league_id": "af1ba5e5-3f34-4ada-aa9f-f818baf7706f",
            "first_name": "Reed",
            "last_name": "Sheppard",
            "name": "Reed Sheppard",
            "position": "G",
            "height": 75,
            "weight": 187,
            "experience": "FR",
            "birth_place": "London, KY, USA"
          },
          "trades": [
            {
              "id": "d9d54c89-ff03-4c7f-8133-25ca3cfd1254"
            }
          ]
        },
        {
          "id": "1f483861-f4b7-4859-8f50-1b5b2851ecb6",
          "number": 4,
          "overall": 4,
          "team": {
            "id": "583ecd4f-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Spurs",
            "market": "San Antonio",
            "alias": "SAS"
          },
          "prospect": {
            "id": "782bf72e-ba49-40d3-b8ed-10b365fcf4de",
            "source_id": "c2c42723-cc6c-420e-8202-070a4023c6ff",
            "league_id": "ddee4a31-2791-4339-bfc3-a058ce2d1397",
            "first_name": "Stephon",
            "last_name": "Castle",
            "name": "Stephon Castle",
            "position": "G",
            "height": 78,
            "weight": 215,
            "experience": "FR",
            "birth_place": "Covington, GA, USA"
          }
        },
        {
          "id": "76fd898b-9947-49f6-b9ed-e54c23213326",
          "number": 5,
          "overall": 5,
          "team": {
            "id": "583ec928-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Pistons",
            "market": "Detroit",
            "alias": "DET"
          },
          "prospect": {
            "id": "6275d826-d440-4a31-8966-a8a340edc74c",
            "league_id": "a2b3bc56-566e-443d-affe-7837a59a1ed7",
            "first_name": "Ron",
            "last_name": "Holland",
            "name": "Ron Holland",
            "position": "F",
            "high_school": "Duncanville (TX)",
            "team_name": "G-League Ignite",
            "height": 80,
            "weight": 206,
            "birth_place": "Duncanville, TX, USA",
            "top_prospect": true
          }
        },
        {
          "id": "728d9cbf-e0c3-4a17-9252-f5e4a52b2e3b",
          "number": 6,
          "overall": 6,
          "team": {
            "id": "583ec97e-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Hornets",
            "market": "Charlotte",
            "alias": "CHA"
          },
          "prospect": {
            "id": "8fb1196f-f3c4-428e-8caf-ca086f16a79c",
            "league_id": "50e0c4e6-dfe4-42ca-bf18-aa2630be21c9",
            "first_name": "Tidjane",
            "last_name": "Salaun",
            "name": "Tidjane Salaun",
            "position": "F",
            "team_name": "Cholet Basket",
            "height": 81,
            "weight": 212,
            "birth_place": "Paris,, FRA",
            "top_prospect": true
          }
        },
        {
          "id": "f1b6064a-f551-4cfa-a84c-dca904e26249",
          "number": 7,
          "overall": 7,
          "team": {
            "id": "583ed056-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Trail Blazers",
            "market": "Portland",
            "alias": "POR"
          },
          "prospect": {
            "id": "9ce28d9c-1b87-4b1f-955c-8de1a0e6c023",
            "source_id": "72d368c3-eacc-46e0-91ce-08e297f4c3d3",
            "league_id": "c76e8dae-58ad-4950-8929-5094036210c4",
            "first_name": "Donovan",
            "last_name": "Clingan",
            "name": "Donovan Clingan",
            "position": "C",
            "height": 86,
            "weight": 265,
            "experience": "SO",
            "birth_place": "Bristol, CT, USA"
          }
        },
        {
          "id": "1a2ae66c-8b64-40fa-8cbd-8173520c1c4c",
          "number": 8,
          "overall": 8,
          "traded": true,
          "team": {
            "id": "583eca2f-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Timberwolves",
            "market": "Minnesota",
            "alias": "MIN"
          },
          "prospect": {
            "id": "fd193961-8b7f-43d6-a0c1-ae76ead2b92c",
            "source_id": "c0f19cfb-4864-4b57-b548-3729ae880732",
            "league_id": "99dc3c11-03fc-4d15-9dd5-d8d1f41c569a",
            "first_name": "Robert",
            "last_name": "Dillingham",
            "name": "Robert Dillingham",
            "position": "G",
            "height": 75,
            "weight": 176,
            "experience": "FR",
            "birth_place": "Hickory, NC, USA"
          },
          "trades": [
            {
              "id": "aa9b9d2c-2c4c-4833-a09c-9170f6bbf08c"
            },
            {
              "id": "63f3216b-58e8-4f18-968b-42e3fc34b753"
            }
          ]
        },
        {
          "id": "ebea0fe3-a4d0-4e2e-a8fe-a1b84ca498ff",
          "number": 9,
          "overall": 9,
          "team": {
            "id": "583eca88-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Grizzlies",
            "market": "Memphis",
            "alias": "MEM"
          },
          "prospect": {
            "id": "e25acea5-7167-455e-8253-51771c051644",
            "source_id": "598a49f6-3c8f-4dab-bec0-77ebe8cef2a0",
            "league_id": "4ea56b9e-562d-4f19-a0e1-ea0e1da19688",
            "first_name": "Zach",
            "last_name": "Edey",
            "name": "Zach Edey",
            "position": "C",
            "height": 88,
            "weight": 300,
            "experience": "SR",
            "birth_place": "Toronto, ON, CAN"
          }
        },
        {
          "id": "33699db7-5376-4b78-94ed-bdc58856e2d6",
          "number": 10,
          "overall": 10,
          "team": {
            "id": "583ece50-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Jazz",
            "market": "Utah",
            "alias": "UTA"
          },
          "prospect": {
            "id": "5819beda-be10-4087-8faa-7da02da86642",
            "source_id": "45193d5d-3712-44ed-b37a-7f9cc0a46d4d",
            "league_id": "f6db8914-5cdd-48d6-ac19-b64133d688cf",
            "first_name": "Cody",
            "last_name": "Williams",
            "name": "Cody Williams",
            "position": "F",
            "height": 80,
            "weight": 190,
            "experience": "FR",
            "birth_place": "Gilbert, AZ, USA"
          }
        },
        {
          "id": "3bf364d9-8592-4dac-ae84-9505bbcd42d0",
          "number": 11,
          "overall": 11,
          "team": {
            "id": "583ec5fd-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Bulls",
            "market": "Chicago",
            "alias": "CHI"
          },
          "prospect": {
            "id": "87108871-05fb-420a-b701-b26b47051a7a",
            "league_id": "fe7a0b28-a8f9-42ad-b345-0f69d51d365f",
            "first_name": "Matas",
            "last_name": "Buzelis",
            "name": "Matas Buzelis",
            "position": "F",
            "high_school": "Sunrise Christian Academy (KS)",
            "team_name": "G-League Ignite",
            "height": 81,
            "weight": 209,
            "birth_place": "Chicago, IL, USA",
            "top_prospect": true
          }
        },
        {
          "id": "73069611-826d-4f4b-84b1-12e4754f35e4",
          "number": 12,
          "overall": 12,
          "traded": true,
          "team": {
            "id": "583ecfff-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Thunder",
            "market": "Oklahoma City",
            "alias": "OKC"
          },
          "prospect": {
            "id": "52fc615a-cfe6-4f0e-ae33-2f396c1dcdcf",
            "league_id": "bf6b4aed-c007-41eb-b4e5-08b99f292ec2",
            "first_name": "Nikola",
            "last_name": "Topic",
            "name": "Nikola Topic",
            "position": "G",
            "team_name": "KK Crvena Zvezda",
            "height": 78,
            "weight": 201,
            "birth_place": "Novi Sad,, SRB",
            "top_prospect": true
          },
          "trades": [
            {
              "id": "b30003c8-8b95-4923-b384-67e46b47a658"
            }
          ]
        },
        {
          "id": "1a70acaa-4fd0-485e-8203-3cff1ad583f0",
          "number": 13,
          "overall": 13,
          "team": {
            "id": "583ed0ac-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Kings",
            "market": "Sacramento",
            "alias": "SAC"
          },
          "prospect": {
            "id": "cb8660e4-2842-4b9b-8ea9-5ddb0ec2fcc7",
            "source_id": "ecc676e4-33a8-4e9d-9db9-22ddf7065abc",
            "league_id": "00080fe6-49ad-4685-a308-eb96b1f11ddf",
            "first_name": "Devin",
            "last_name": "Carter",
            "name": "Devin Carter",
            "position": "G",
            "height": 75,
            "weight": 195,
            "experience": "JR",
            "birth_place": "Miami, FL, USA"
          }
        },
        {
          "id": "41769d30-4424-4115-9257-a83eb5aaa652",
          "number": 14,
          "overall": 14,
          "traded": true,
          "team": {
            "id": "583ec8d4-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Wizards",
            "market": "Washington",
            "alias": "WAS"
          },
          "prospect": {
            "id": "d60a7644-d18d-441a-b68a-6eff96359cc6",
            "source_id": "cae0a81b-d11f-42b1-8422-b8e466d4682a",
            "league_id": "28f3e566-3174-4e87-81d0-4889569b6ef5",
            "first_name": "Carlton",
            "last_name": "Carrington",
            "name": "Carlton Carrington",
            "position": "G",
            "height": 77,
            "weight": 190,
            "experience": "FR",
            "birth_place": "Baltimore, MD, USA"
          },
          "trades": [
            {
              "id": "8c5337e8-eaf5-421c-83da-966e56d9fb47"
            },
            {
              "id": "51f1974a-3f41-4993-bc06-b77aa8369877"
            }
          ]
        },
        {
          "id": "565028ad-91d4-43e9-8c06-66512904f778",
          "number": 15,
          "overall": 15,
          "team": {
            "id": "583ecea6-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Heat",
            "market": "Miami",
            "alias": "MIA"
          },
          "prospect": {
            "id": "61aaff3f-5392-40c2-9ac0-4864a4a114d9",
            "source_id": "ed99e7c8-19e8-471d-9857-30dfd5744318",
            "league_id": "f1e4fcb7-01c7-479f-8883-c33ac438690e",
            "first_name": "Kel'el",
            "last_name": "Ware",
            "name": "Kel'el Ware",
            "position": "C",
            "height": 84,
            "weight": 242,
            "experience": "SO",
            "birth_place": "North Little Rock, AR, USA"
          }
        },
        {
          "id": "56840590-eb72-442d-acfb-3d1b152ce58a",
          "number": 16,
          "overall": 16,
          "team": {
            "id": "583ec87d-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "76ers",
            "market": "Philadelphia",
            "alias": "PHI"
          },
          "prospect": {
            "id": "d62e6faa-e263-4c3a-be31-29197f207c55",
            "source_id": "57efc12d-2074-423d-83d5-79d0b1184abc",
            "league_id": "2646b0b2-4aa8-40f8-ad9d-f0e97590c8d8",
            "first_name": "Jared",
            "last_name": "McCain",
            "name": "Jared McCain",
            "position": "G",
            "height": 75,
            "weight": 197,
            "experience": "FR",
            "birth_place": "Sacramento, CA, USA"
          }
        },
        {
          "id": "9f5896ce-8ede-4d0d-8b83-8ca0418614cd",
          "number": 17,
          "overall": 17,
          "team": {
            "id": "583ecae2-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Lakers",
            "market": "Los Angeles",
            "alias": "LAL"
          },
          "prospect": {
            "id": "bedd34fd-d5d2-47f7-a323-0e956941690c",
            "source_id": "7da65e96-cbf1-42b9-be46-7a7ece9fdd02",
            "league_id": "816ef930-8918-4b1d-9f0e-d0d867e6956a",
            "first_name": "Dalton",
            "last_name": "Knecht",
            "name": "Dalton Knecht",
            "position": "G",
            "height": 78,
            "weight": 213,
            "experience": "SR",
            "birth_place": "Thornton, CO, USA"
          }
        },
        {
          "id": "165f07ad-d7d0-4407-8920-3b119aff1816",
          "number": 18,
          "overall": 18,
          "team": {
            "id": "583ed157-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Magic",
            "market": "Orlando",
            "alias": "ORL"
          },
          "prospect": {
            "id": "f7a9f754-dbb6-4bca-8ba8-d5bef6ff8dbb",
            "source_id": "940dcf97-d4d2-4856-b3eb-d4e2b9c41a66",
            "league_id": "98fa75e7-a46f-4483-a15b-053c5ca52604",
            "first_name": "Tristan",
            "last_name": "da Silva",
            "name": "Tristan da Silva",
            "position": "F",
            "height": 81,
            "weight": 220,
            "experience": "SR",
            "birth_place": "Munich,, DEU"
          }
        },
        {
          "id": "57c5e78c-fade-4db1-a83d-a601942898cf",
          "number": 19,
          "overall": 19,
          "traded": true,
          "team": {
            "id": "583ecda6-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Raptors",
            "market": "Toronto",
            "alias": "TOR"
          },
          "prospect": {
            "id": "bdfa3d5f-81e1-4bc0-a0fe-0fa94fedbd9c",
            "source_id": "e640919f-a292-49a7-99ec-ad963cb6b14d",
            "league_id": "3d186345-1517-446d-b4bf-8707fc77f093",
            "first_name": "Ja'Kobe",
            "last_name": "Walter",
            "name": "Ja'Kobe Walter",
            "position": "G",
            "height": 77,
            "weight": 195,
            "experience": "FR",
            "birth_place": "McKinney, TX, USA"
          }
        }
      ]
    }
  ]
}

This response sample illustrates the draft summary for the first round of the 2024 NBA Draft. You can access detailed information about each pick, player, and trade. For example, explore how the Atlanta Hawks selected forward Zaccharie Risacher as the first overall pick, including details like his current team, position, and physical stats.


Use Cases:

  1. Interactive Draft History Timelines: Utilizing the start_date and end_date for each pick and round, you can create interactive timelines that allow fans to explore the draft's progression, focusing on when specific players were picked and trades occurred.

  2. Detailed Trade Analysis Tools: Integrating trade details from the trades node, you can offer in-depth trade analysis tools that break down each trade's impact on team composition and future draft capital.

  3. Enhanced Player Tracking: With detailed prospect information, applications can track a player's journey from draft day to their professional career, offering stats, growth comparisons, and performance forecasts based on historical draft data.


Utilizing the Push Draft Picks Feed

The Push Draft Picks feed delivers the same information as the Draft Summary feed, providing live updates through a single API call to optimize real-time data delivery and reduce API usage.


How to Pull the Push Draft Picks Feed:

  1. A few minutes before the draft starts, open a connection with a single call to the Push Draft Picks feed to receive real-time updates.

  2. Push feeds automatically deliver JSON payloads through a push service, minimizing the number of calls required.

  3. In the event of a disconnection from the Push Draft Picks feed, it's not possible to resume where you left off. To ensure continuous coverage, use multiple Push Feeds and supplement them with the Draft Summary feed as a fallback to retrieve any missed timeline information during the NBA draft.

For more information on push feeds, please see our section on push integration.


Team Draft Picks

The Team Draft Picks feed displays the preset draft order and live selections for a specific team during the draft. This is useful for tracking a team's draft strategy and changes to their lineup in real-time.


Accessing Team Draft Picks:

  1. Get a team ID: You can access a list of all active teams in the NBA API database with the Teams endpoint.
  2. Call the Team Draft Summary endpoint.

Recommended Pull Frequency:

  • Updates are made in real-time as changes are made to pick selections.
  • The TTL/Cache is every two seconds.
  • Request as fast as every two seconds (matching the TTL) when the draft is live.
  • Summary and Trade feeds should be requested 10 minutes before the scheduled start.

Example - Team Draft Picks:

{
  "draft": {
    "id": "96517b43-ccff-428a-8906-07279b0c9922",
    "year": 2022,
    "start_date": "2022-06-23",
    "end_date": "2022-06-23",
    "status": "closed",
    "league": {
      "id": "4353138d-4c22-4396-95d8-5f587d2df25c",
      "name": "NBA",
      "alias": "NBA"
    },
    "broadcast": {
      "channel": "206",
      "network": "ABC, ESPN"
    },
    "venue": {
      "name": "Barclays Center",
      "address": "620 Atlantic Avenue",
      "city": "Brooklyn",
      "state": "NY",
      "country": "USA"
    }
  },
  "team": {
    "id": "583eca88-fb46-11e1-82cb-f4ce4684ea4c",
    "name": "Grizzlies",
    "market": "Memphis",
    "alias": "MEM"
  },
  "rounds": [
    {
      "id": "973714f3-4efa-4082-8cfe-f82240327cf5",
      "number": 1,
      "start_date": "2022-06-23",
      "end_date": "2022-06-23",
      "status": "closed",
      "picks": [
        {
          "id": "38d8117d-e5d3-49ee-8da4-995109e270d1",
          "number": 19,
          "overall": 19,
          "traded": true,
          "team": {
            "id": "583eca88-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Grizzlies",
            "market": "Memphis",
            "alias": "MEM"
          },
          "prospect": {
            "id": "267362bd-e2b3-466d-9dcd-f270a94c78f2",
            "source_id": "91f09caa-184c-4a43-87b6-0902235a03ca",
            "league_id": "cbea1c03-1ac9-4afa-8fdc-2d7155ea5583",
            "first_name": "Jake",
            "last_name": "LaRavia",
            "name": "Jake LaRavia",
            "position": "G-F",
            "height": 80,
            "weight": 235,
            "experience": "JR",
            "birth_place": "Indianapolis, IN, USA"
          },
          "trades": [
            {
              "id": "dbc33c0c-9519-471b-8393-97dceedc69c4"
            }
          ]
        },
        {
          "id": "23699d64-9849-4e57-971f-92e71358d935",
          "number": 23,
          "overall": 23,
          "traded": true,
          "team": {
            "id": "583eca88-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Grizzlies",
            "market": "Memphis",
            "alias": "MEM"
          },
          "prospect": {
            "id": "2f481a39-a6a7-4821-83aa-8d44bf369d4e",
            "source_id": "ccc9c027-6daa-4ec8-abbd-19116d05cbb0",
            "league_id": "339eff07-4d8e-42c6-9a47-900e94b13654",
            "first_name": "David",
            "last_name": "Roddy",
            "name": "David Roddy",
            "position": "G-F",
            "height": 78,
            "weight": 255,
            "experience": "JR",
            "birth_place": "Minneapolis, MN, USA"
          },
          "trades": [
            {
              "id": "97a3222c-d5cb-44d2-bdc0-ce72bc87464e"
            }
          ]
        }
      ]
    },
    {
      "id": "27b93f2c-95fb-4ba6-80ea-d50c95f7d1a4",
      "number": 2,
      "start_date": "2022-06-23",
      "end_date": "2022-06-23",
      "status": "closed",
      "picks": [
        {
          "id": "fcb7576b-c334-4d76-828e-3d3d422569fb",
          "number": 8,
          "overall": 38,
          "traded": true,
          "team": {
            "id": "583eca88-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Grizzlies",
            "market": "Memphis",
            "alias": "MEM"
          },
          "prospect": {
            "id": "0b377ea2-a827-4501-8127-382c6168cca4",
            "source_id": "a11578e2-0e20-4924-9d9d-c475d5f16f4c",
            "league_id": "931f7ae2-4ce4-49e6-a3ad-e24790469fec",
            "first_name": "Kennedy",
            "last_name": "Chandler",
            "name": "Kennedy Chandler",
            "position": "G",
            "height": 72,
            "weight": 171,
            "experience": "FR",
            "birth_place": "Memphis, TN, USA"
          },
          "trades": [
            {
              "id": "66ee7fe9-163e-462e-b6d5-e7f655902c96"
            },
            {
              "id": "a72125a6-7b96-41f2-9034-902180cf075c"
            },
            {
              "id": "4f058f22-de24-4bb0-a1ff-f41130ee6d20"
            },
            {
              "id": "fa6ab0cb-fbf3-4263-a525-cbb308225583"
            }
          ]
        },
        {
          "id": "7818dc9e-3bde-4988-ac55-63437ae559a1",
          "number": 17,
          "overall": 47,
          "traded": true,
          "team": {
            "id": "583eca88-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Grizzlies",
            "market": "Memphis",
            "alias": "MEM"
          },
          "prospect": {
            "id": "612c8d29-e286-41fc-b238-7ad2b84e1b91",
            "source_id": "9c4129e1-1804-4384-bb59-6de6be6e406f",
            "league_id": "0e5eb37e-e112-4587-98d8-8a9b46254f28",
            "first_name": "Vince",
            "last_name": "Williams",
            "name": "Vince Williams Jr.",
            "position": "F",
            "height": 78,
            "weight": 205,
            "experience": "SR",
            "birth_place": "Toledo, OH, USA"
          },
          "trades": [
            {
              "id": "6965f139-bc02-4d56-ada6-6e95eed6a647"
            },
            {
              "id": "f05f7a79-47bd-4b16-88fa-ed20c8ba90b6"
            },
            {
              "id": "1e745f7b-3aff-46ad-8c3d-cd748a67cb71"
            }
          ]
        }
      ]
    }
  ]
}

This response sample provides the Team Draft Summary for the Memphis Grizzlies in the 2024 NBA Draft. It includes details about their draft picks, trades, and player profiles. For example, the Grizzlies selected Zach Edey, a center from Toronto, as their 9th overall pick in the first round, along with additional prospects like Jaylen Wells and Cam Spencer in later rounds.

Use Case - Fan Engagement: Sports apps can integrate this feed to create interactive experiences during the NBA draft, allowing fans to view detailed profiles of each player their team drafts, complete with career stats and draft analysis.



Trades

You can use the Trades feed to access detailed summaries of all in-draft trades, helping you analyze shifts in team strategies and update your applications with these key developments. This data is crucial for enhancing user engagement by showcasing strategic team moves during the draft.


Recommended Pull Frequency:

  • Updates are made in real-time as changes are made to pick selections.
  • The TTL/Cache is every two seconds.
  • Request as fast as every two seconds (matching the TTL) when the draft is live.
  • Summary and Trade feeds should be requested 10 minutes before the scheduled start.

Example - Trades:

{
  "draft": {
    "id": "8df66104-0151-49e9-9c35-a95f663a9d4a",
    "year": 2024,
    "start_date": "2024-06-26",
    "end_date": "2024-06-27",
    "status": "closed",
    "league": {
      "id": "4353138d-4c22-4396-95d8-5f587d2df25c",
      "name": "NBA",
      "alias": "NBA"
    },
    "broadcast": {
      "channel": "206",
      "network": "ABC, ESPN"
    },
    "venue": {
      "name": "Barclays Center",
      "address": "620 Atlantic Avenue",
      "city": "Brooklyn",
      "state": "NY",
      "country": "USA"
    }
  },
  "trades": [
    {
      "id": "d9d54c89-ff03-4c7f-8133-25ca3cfd1254",
      "sequence": 1716482088476,
      "complete": true,
      "transactions": [
        {
          "id": "12b0f3fb-3b93-4217-8428-c2b5c16963a0",
          "to_team": {
            "id": "583ec9d6-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Nets",
            "market": "Brooklyn",
            "alias": "BKN"
          },
          "from_team": {
            "id": "583ecb3a-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Rockets",
            "market": "Houston",
            "alias": "HOU"
          },
          "items": []
        },
        {
          "id": "21455a5b-d6e5-4ce7-a234-12ea863e65d0",
          "to_team": {
            "id": "583ecb3a-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Rockets",
            "market": "Houston",
            "alias": "HOU"
          },
          "from_team": {
            "id": "583ec9d6-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Nets",
            "market": "Brooklyn",
            "alias": "BKN"
          },
          "items": [
            {
              "id": "1c7904a3-888f-427f-964b-ed6f0ace5108",
              "type": "future_pick",
              "future_pick": {
                "year": "2026",
                "round": "1"
              }
            },
            {
              "id": "e5646258-726a-49b7-8231-caa8591c25d9",
              "type": "pick",
              "pick": {
                "id": "e900281f-1129-49ed-910f-aaa75aa80e46",
                "number": 3,
                "overall": 3,
                "supplemental": false,
                "compensatory": false,
                "round": {
                  "id": "43a70a28-42e7-4947-8705-223fe28ac2f0",
                  "number": 1,
                  "start_date": "2024-06-26",
                  "end_date": "2024-06-26"
                }
              }
            }
          ]
        }
      ]
    },
    {
      "id": "63f3216b-58e8-4f18-968b-42e3fc34b753",
      "sequence": 1716482339928,
      "complete": true,
      "transactions": [
        {
          "id": "0b40df4c-b250-42c7-9269-873a6a1bfb51",
          "to_team": {
            "id": "583ecda6-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Raptors",
            "market": "Toronto",
            "alias": "TOR"
          },
          "from_team": {
            "id": "583ecd4f-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Spurs",
            "market": "San Antonio",
            "alias": "SAS"
          },
          "items": []
        },
        {
          "id": "1f6f9fa2-cf2b-4307-b590-5ded5b4275af",
          "to_team": {
            "id": "583ecd4f-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Spurs",
            "market": "San Antonio",
            "alias": "SAS"
          },
          "from_team": {
            "id": "583ecda6-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Raptors",
            "market": "Toronto",
            "alias": "TOR"
          },
          "items": [
            {
              "id": "2b33593d-54c7-483a-83ec-0bb89ac58042",
              "type": "future_pick",
              "future_pick": {
                "year": "2025",
                "round": "2"
              }
            },
            {
              "id": "655ee893-e283-49d1-aa1b-0ecf15f9ec71",
              "type": "pick",
              "pick": {
                "id": "1a2ae66c-8b64-40fa-8cbd-8173520c1c4c",
                "number": 8,
                "overall": 8,
                "supplemental": false,
                "compensatory": false,
                "round": {
                  "id": "43a70a28-42e7-4947-8705-223fe28ac2f0",
                  "number": 1,
                  "start_date": "2024-06-26",
                  "end_date": "2024-06-26"
                }
              }
            }
          ]
        }
      ]
    },
    {
      "id": "b30003c8-8b95-4923-b384-67e46b47a658",
      "sequence": 1716482420088,
      "complete": true,
      "transactions": [
        {
          "id": "85a7bc3d-4bae-48a3-af20-d990a981ce7b",
          "to_team": {
            "id": "583ecfff-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Thunder",
            "market": "Oklahoma City",
            "alias": "OKC"
          },
          "from_team": {
            "id": "583ecb3a-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Rockets",
            "market": "Houston",
            "alias": "HOU"
          },
          "items": [
            {
              "id": "d8af078b-a50b-4fcf-ba8f-da740e027ca0",
              "type": "pick",
              "pick": {
                "id": "73069611-826d-4f4b-84b1-12e4754f35e4",
                "number": 12,
                "overall": 12,
                "supplemental": false,
                "compensatory": false,
                "round": {
                  "id": "43a70a28-42e7-4947-8705-223fe28ac2f0",
                  "number": 1,
                  "start_date": "2024-06-26",
                  "end_date": "2024-06-26"
                }
              }
            },
            {
              "id": "ea7c8b45-d86d-4410-8a67-2a62ce7276a4",
              "type": "future_pick",
              "future_pick": {
                "year": "2026",
                "round": "1"
              }
            }
          ]
        },
        {
          "id": "c8b46cdf-2de9-43d3-9874-15a6393f1bc5",
          "to_team": {
            "id": "583ecb3a-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Rockets",
            "market": "Houston",
            "alias": "HOU"
          },
          "from_team": {
            "id": "583ecfff-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Thunder",
            "market": "Oklahoma City",
            "alias": "OKC"
          },
          "items": []
        }
      ]
    },
    {
      "id": "51f1974a-3f41-4993-bc06-b77aa8369877",
      "sequence": 1716482597295,
      "complete": true,
      "transactions": [
        {
          "id": "0197a4e0-f232-4f67-813c-6ec157eebde4",
          "to_team": {
            "id": "583ec825-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Warriors",
            "market": "Golden State",
            "alias": "GSW"
          },
          "from_team": {
            "id": "583ed056-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Trail Blazers",
            "market": "Portland",
            "alias": "POR"
          },
          "items": []
        },
        {
          "id": "4579eb75-0a4d-4262-b1dc-783cb9276a6c",
          "to_team": {
            "id": "583ed056-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Trail Blazers",
            "market": "Portland",
            "alias": "POR"
          },
          "from_team": {
            "id": "583ec825-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Warriors",
            "market": "Golden State",
            "alias": "GSW"
          },
          "items": [
            {
              "id": "84a6bc9f-b5ba-4832-9783-da65e2dd7c56",
              "type": "pick",
              "pick": {
                "id": "41769d30-4424-4115-9257-a83eb5aaa652",
                "number": 14,
                "overall": 14,
                "supplemental": false,
                "compensatory": false,
                "round": {
                  "id": "43a70a28-42e7-4947-8705-223fe28ac2f0",
                  "number": 1,
                  "start_date": "2024-06-26",
                  "end_date": "2024-06-26"
                }
              }
            }
          ]
        }
      ]
    },
    {
      "id": "dd7bf3a8-8610-454c-8b63-af36e7449eed",
      "sequence": 1716482783965,
      "complete": true,
      "transactions": [
        {
          "id": "08639b76-eb53-4e0f-9bca-ee4f63353396",
          "to_team": {
            "id": "583ecda6-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Raptors",
            "market": "Toronto",
            "alias": "TOR"
          },
          "from_team": {
            "id": "583ec7cd-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Pacers",
            "market": "Indiana",
            "alias": "IND"
          },
          "items": [
            {
              "id": "c6761e2f-37a5-4263-8af5-277fd533f643",
              "type": "pick",
              "pick": {
                "id": "aa720449-7be8-43a5-9a5c-96698e18b00b",
                "number": 29,
                "overall": 29,
                "supplemental": false,
                "compensatory": false,
                "round": {
                  "id": "43a70a28-42e7-4947-8705-223fe28ac2f0",
                  "number": 1,
                  "start_date": "2024-06-26",
                  "end_date": "2024-06-26"
                }
              }
            },
            {
              "id": "d7f11a83-057e-4587-8ca8-470daef57374",
              "type": "pick",
              "pick": {
                "id": "57c5e78c-fade-4db1-a83d-a601942898cf",
                "number": 19,
                "overall": 19,
                "supplemental": false,
                "compensatory": false,
                "round": {
                  "id": "43a70a28-42e7-4947-8705-223fe28ac2f0",
                  "number": 1,
                  "start_date": "2024-06-26",
                  "end_date": "2024-06-26"
                }
              }
            },
            {
              "id": "e3c5a2e7-039e-4c9f-a8c2-e3519339c90a",
              "type": "future_pick",
              "future_pick": {
                "year": "2026",
                "round": "1"
              }
            }
          ]
        },
        {
          "id": "9f3e3b98-e130-45a7-a543-4ce7ec7737a4",
          "to_team": {
            "id": "583ec7cd-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Pacers",
            "market": "Indiana",
            "alias": "IND"
          },
          "from_team": {
            "id": "583ecc9a-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Pelicans",
            "market": "New Orleans",
            "alias": "NOP"
          },
          "items": [
            {
              "id": "dadcba55-7e49-4d9b-9156-f8fa6076d0bb",
              "type": "pick",
              "pick": {
                "id": "24534896-aa25-4198-85bc-2a620128ca74",
                "number": 20,
                "overall": 50,
                "supplemental": false,
                "compensatory": false,
                "round": {
                  "id": "cb63a7b5-3f36-4586-8103-0c551e38b2f3",
                  "number": 2,
                  "start_date": "2024-06-27",
                  "end_date": "2024-06-27"
                }
              }
            }
          ]
        },
        {
          "id": "a0ad08d8-67a1-4dca-bf77-1b58b08664d0",
          "to_team": {
            "id": "583ec7cd-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Pacers",
            "market": "Indiana",
            "alias": "IND"
          },
          "from_team": {
            "id": "583ecda6-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Raptors",
            "market": "Toronto",
            "alias": "TOR"
          },
          "items": []
        }
      ]
    },
    {
      "id": "7a03f47d-00f5-4cb0-b757-6699ff38627e",
      "sequence": 1716482949902,
      "complete": true,
      "transactions": [
        {
          "id": "411e26e7-3d49-45cc-9129-9520ed9b1df3",
          "to_team": {
            "id": "583ecc9a-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Pelicans",
            "market": "New Orleans",
            "alias": "NOP"
          },
          "from_team": {
            "id": "583ecefd-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Bucks",
            "market": "Milwaukee",
            "alias": "MIL"
          },
          "items": [
            {
              "id": "6cce70ee-0ad3-4d42-a535-51d4a2eed671",
              "type": "pick",
              "pick": {
                "id": "609311b1-c3a4-4887-84dd-c1ab1d8f471b",
                "number": 21,
                "overall": 21,
                "supplemental": false,
                "compensatory": false,
                "round": {
                  "id": "43a70a28-42e7-4947-8705-223fe28ac2f0",
                  "number": 1,
                  "start_date": "2024-06-26",
                  "end_date": "2024-06-26"
                }
              }
            }
          ]
        },
        {
          "id": "487c41fd-cbd2-42bb-aed9-8b54482e2f43",
          "to_team": {
            "id": "583ecefd-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Bucks",
            "market": "Milwaukee",
            "alias": "MIL"
          },
          "from_team": {
            "id": "583ecc9a-fb46-11e1-82cb-f4ce4684ea4c",
            "name": "Pelicans",
            "market": "New Orleans",
            "alias": "NOP"
          },
          "items": [
            {
              "id": "16f3d3dc-6866-4d89-a445-af54e48ef6bb",
              "type": "pick",
              "pick": {
                "id": "fd9a7cdc-795d-475e-b476-92e583e3f141",
                "number": 23,
                "overall": 23,
                "compensatory": false,
                "round": {
                  "id": "43a70a28-42e7-4947-8705-223fe28ac2f0",
                  "number": 1,
                  "start_date": "2024-06-26",
                  "end_date": "2024-06-26"
                }
              }
            }
          ]
        }
      ]
    }
  ]
}

This response sample provides details on trade transactions during the 2024 NBA Draft. It outlines how teams exchange draft picks, including future picks, with specifics on each transaction, such as the teams involved and the picks traded. For example, the Houston Rockets and Brooklyn Nets exchanged picks, with the Rockets receiving a first-round pick in 2026 and the Nets acquiring a first-round pick in 2024.


Use Cases:

  1. Draft Analysis Tools: Integrate this data into your sports analytics platform to provide users with insights into draft strategies and trade dynamics. You can highlight how teams maneuver to improve their roster through trades.

  2. Real-Time Draft Tracking Apps: Use the data to enhance user engagement by offering real-time updates on draft trades. This could be especially valuable for fantasy basketball apps where users need to make informed decisions quickly.

  3. Historical Trade Review: Incorporate this data into a feature that allows users to analyze past draft trades to evaluate their long-term impact on team compositions and performance, aiding deeper strategic discussions or content creation.


Utilizing the Push Draft Trades Feed

The Push Draft Trades feed delivers the same information as the Trades feed, providing live trade updates through a single API call to optimize real-time data delivery and reduce API usage.


How to Pull the Push Draft Picks Feed:

  1. A few minutes before the draft starts, open a connection with a single call to the Push Draft Trades feed to receive real-time updates.

  2. Push feeds automatically deliver JSON payloads through a push service, minimizing the number of calls required.

  3. In the event of a disconnection from the Push Draft Trades feed, it's not possible to resume where you left off. To ensure continuous coverage, use multiple push feeds and supplement them with the Trades feed as a fallback to retrieve any missed timeline information during the NBA draft.


Team Roster (NBA API) Updates

Drafted players will be available on their NBA team (Team Profile) after each completed round. This ensures that the information is updated in a timely manner as the draft progresses.


Workflow for Drafted Players Not Present in the Prospects Feed or NCAAMB API

  • If a player is drafted who is not in the Prospects feed, they are added to the feed as soon as possible, often immediately after being drafted. This ensures that all drafted players are captured in the API.
  • If a player is drafted who is not listed in the NCAAMB API, similar to the workflow for Prospects, they are added to the API after being drafted. This allows the system to maintain comprehensive data on all players entering the NBA, regardless of their prior listing status.