Push Draft Trades

Syntax

https://api.sportradar.com/draft/nfl/{access_level}/stream/en/trades/subscribe?api_key={your_api_key}

Replace placeholders with the following query parameters:

Parameter	Description
`access_level`	Defines the access level of your API key as Production (production), or Trial (trial).
`your_api_key`	Your API key.

Optional Query String Parameters

In addition to the URL parameters listed above, you can filter the Trades information with one or more of the following optional query string parameters.

📘
Optional query string parameters must be added after your API key with an ampersand (&). If you are filtering for more than one result, separate the results with a comma (,) and no spaces.

Replace placeholders with the following query parameters:

Parameter	Description
`draft`	Draft id expressed as: sd:draft:{draft_id}. Example: draft=sd:draft:04b11293-240e-4340-8f4f-ded6c6281fe9

Code Samples

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.us/draft/nfl/trial/stream/en/trades/subscribe?api_key={your_api_key}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

import requests
import json

r = requests.get("https://api.sportradar.com/draft/nfl/trial/stream/en/trades/subscribe",
    params = {'api_key': 'your_api_key'},
    allow_redirects=False)

redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True)

for line in r.iter_lines():
    # filter out keep-alive new lines
    if line:
        decoded_line = line.decode('utf-8')
        print(json.loads(decoded_line))

curl -L GET 'api.sportradar.us/draft/nfl/trial/stream/en/trades/subscribe?api_key={your_api_key}'

Samples with Query String Params

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.us/draft/nfl/trial/stream/en/trades/subscribe?api_key={your_api_key}&draft=sd:draft:04b11293-240e-4340-8f4f-ded6c6281fe9&league=NFL")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

import requests
import json

r = requests.get("https://api.sportradar.com/draft/nfl/trial/stream/en/trades/subscribe",
    params = {'api_key': 'your_api_key', 'draft': 'sd:draft:04b11293-240e-4340-8f4f-ded6c6281fe9', 'league': 'NFL'},
    allow_redirects=False)

redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True)

for line in r.iter_lines():
    # filter out keep-alive new lines
    if line:
        decoded_line = line.decode('utf-8')
        print(json.loads(decoded_line))

curl -L GET 'api.sportradar.us/draft/nfl/trial/stream/en/trades/subscribe?api_key={your_api_key}&draft=sd:draft:04b11293-240e-4340-8f4f-ded6c6281fe9&league=NFL'

Response Sample

The above commands return json like this.

Data Points

Draft Info:

Attribute	Parent Element	Type	Description
`end_date`	`draft`	Date	End date of a draft ex. `2022-04-30`
`id`	`draft`	GUID	Unique ID of a draft ex. `01c63362-299c-48a0-b725-63fa18fca261`
`start_date`	`draft`	Date	Start date of a draft ex. `2022-04-30`
`status`	`draft`	String	Status of a draft ex. `closed`
`year`	`draft`	Integer	Year of a draft

Trade Info:

Attribute	Parent Element	Type	Description
`id`	`trade`	GUID	Unique ID of a trade ex. `3fc4ffa0-fe54-4d9a-bf53-e85df0e2cefd`
`sequence`	`trade`	Integer	Sequence number of a trade ex. `1648829953213`
`complete`	`trade`	Boolean	Signifies a trade is complete
`alias`	`transactions`-`to_team`/`from_team`	String	Trade team alias ex. `MIN` (Minnesota)
`id`	`transactions`	GUID	Unique ID of a trade ex. `88db5bd9-f8ef-4ddc-a4fc-0de7a04b2d56`
`id`	`transactions`-`to_team`/`from_team`	GUID	Unique ID of a trade team ex. `82d2d380-3834-4938-835f-aec541e5ece7`
`market`	`transactions`-`to_team`/`from_team`	String	Trade team market name ex. `Minnesota`
`name`	`transactions`-`to_team`/`from_team`	String	Trade team name ex. `Vikings`

Pick Info:

Attribute	Parent Element	Type	Description
`amount`	`items`	String	Amount of trade compensation
`id`	`items`	String	Unique ID of a draft item
`type`	`items`	String	Type of a draft item ex. `future_pick` or `player`
`round`	`item`-`future_pick`	Integer	Future pick round number
`year`	`item`-`future_pick`	Integer	Future pick draft year
`compensatory`	`item`-`pick`	Boolean	Signifies a compensatory draft pick
`id`	`item`-`pick`	GUID	Unique ID of a draft pick ex. `ca6b8dae-e835-49e4-9638-b30cdd3969a8`
`number`	`item`-`pick`	Integer	Number of a draft pick within a round
`supplemental`	`item`-`pick`	Boolean	Signifies a supplemental draft pick
`overall`	`item`-`pick`	Integer	Overall number of a draft pick

Round Info:

Attribute	Parent Element	Type	Description
`end_date`	`round`	Date	End date of a round ex. `2022-04-30`
`id`	`round`	GUID	Unique ID of a round ex. `2e9eee59-fdc4-4dbf-bafa-b1cc80976fdb`
`number`	`round`	Integer	Number of a round
`start_date`	`round`	Date	Start date of a round ex. `2022-04-30`

League:

Attribute	Parent Element	Type	Description
`alias`	`league`	String	Alias of a league ex. `NFL`
`id`	`league`	GUID	Unique ID of a league ex. `3c6d318a-6164-4290-9bbc-bf9bb21cc4b8`
`name`	`league`	String	Name of a league ex. `National Football League`

Players:

Attribute	Parent Element	Type	Description
`first_name`	`player`	String	First name of a player ex. `Patrick`
`id`	`player`	GUID	Unique ID of a player ex. `11cad59d-90dd-449c-a839-dddaba4fe16c`
`last_name`	`player`	String	Last name of a player ex. `Mahomes`
`position`	`player`	String	Position of a player See our FAQ for a list of valid positions
`source_id`	`player`	GUID	Unique ID of a player's source team ex. `9fe7c9f9-5830-4e22-953d-054a44342323`
`sr_id`	`player`	GUID	Unique Sportradar ID of a player ex. `sr:player:1234416`

Coaches:

Attribute	Parent Element	Type	Description
`first_name`	`coach`	String	First name of a coach ex. `Dennis`
`id`	`coach`	GUID	Unique ID of a coach ex. `ef1b4704-0ce4-4977-a882-2b14413dd2d2`
`last_name`	`coach`	String	Last name of a coach ex. `Allen`
`source_id`	`coach`	GUID	Unique ID of a player's source team ex. `9fe7c9f9-5830-4e22-953d-054a44342323`

Metadata:

Attribute	Parent Element	Type	Description
`league`	`metadata`	String	Alias of a league ex. `NFL`
`draft`	`metadata`	String	Unique ID of a draft ex. `sd:draft:04b11293-240e-4340-8f4f-ded6c6281fe9`
`locale`	`metadata`	String	Language code ex. `en` (English)
`operation`	`metadata`	String	Operation of an update `update`,`delete`
`version`	`metadata`	String	Version of the API ex. `v1`