Push Clock

Syntax

https://api.sportradar.us/nbdl/{access_level}/stream/{language_code}/clock/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`).
`locale`	Locale expressed as 2 letter code: locale={language_code} Example: `locale=en`
`your_api_key`	Your API key.

Optional Query String Parameters

In addition to the URL parameters listed above, you can filter the clock 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
`match`	Match id expressed as: sd:match:{match_id}. Example: `match=sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56`
`locale`	Locale expressed as 2 letter code: locale={language_code} Example: `locale=en`
`status`	Status type expressed as: inprogress or created. Example: `status=inprogress`

Code Samples

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

url = URI("https://api.sportradar.us/nbdl/trial/stream/en/clock/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/nbdl/trial/stream/en/clock/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/nbdl/trial/stream/en/clock/subscribe?api_key={your_api_key}'

Samples with Query String Params

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

url = URI("https://api.sportradar.us/nbdl/trial/stream/en/clock/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56")

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/nbdl/trial/stream/en/clock/subscribe",
    params = {'api_key': 'your_api_key', 'status': 'inprogress', 'match': 'sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56'},
    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/nbdl/trial/stream/en/clock/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56'

Response Sample

The above commands return json like this.

Data Points

Game:

Attribute	Parent Element	Type	Description
`coverage`	`game`	String	Coverage level of a game `full`, `extended_boxscore`
`id`	`game`	GUID	Unique ID of a game ex. `1f730a9a-8221-48ff-a259-ac2103fb58b0`
`reference`	`game`	String	League reference ID of a game ex. `1610612758`
`status`	`game`	String	The status of a game `scheduled`, `created`, `inprogress`, `halftime`, `complete`, `closed`, `cancelled`, `delayed`, `postponed`, `time-tbd`, `if-necessary`, `unnecessary` Please see our FAQ section for a list of game status definitions
`title`	`game`	String	Title of a game ex. `Game 3`
`scheduled`	`game`	dateTime	Scheduled date and time of a game ex. `2022-09-25T20:10:00+00:00`
`away`	`game` - `time_zones`	String	Time zone of the away team ex. `US/Pacific`
`home`	`game` - `time_zones`	String	Time zone of the home team ex. `US/Eastern`
`venue`	`game` - `time_zones`	String	Time zone of the venue ex. `US/Eastern`

Metadata:

Attribute	Parent Element	Type	Description
`league`	`metadata`	String	Alias of a league ex. `NBDL`
`locale`	`metadata`	String	Language code ex. `en` (English)
`match`	`metadata`	GUID	Unique ID of a game ex. `sd:match:0c2d1f82-a3de-4754-987e-4c1158ba2969`
`operation`	`metadata`	String	Operation of an update `update`, `delete`
`status`	`metadata`	String	The status of a game `scheduled`, `created`, `inprogress`, `halftime`, `complete`, `closed`, `cancelled`, `delayed`, `postponed`, `time-tbd`, `if-necessary`, `unnecessary` Please see our FAQ section for a list of game status definitions
`version`	`metadata`	String	Version of the API ex. `v7`

Play-by-Play:

Attribute	Parent Element	Type	Description
`bonus`	`game` - `away`	Boolean	Signifies a team is in the bonus
`points`	`game` - `away`	Integer	Total points for the away team
`id`	`game` - `away`	GUID	Unique ID of the away team ex. `67a79348-041a-45f6-bb12-722d38dc8dbf`
`market`	`game` - `away`	String	Market name of the away team ex. `Delaware`
`name`	`game` - `away`	String	Away team name ex. `Kings`
`remaining_timeouts`	`game` - `away`	Integer	Remaining timeouts for the away team
`bonus`	`game` - `home`	Boolean	Signifies a team is in the bonus
`points`	`game` - `home`	Integer	Total points for the home team
`id`	`game` - `home`	GUID	Unique ID of the home team ex. `67a79348-041a-45f6-bb12-722d38dc8dbf`
`market`	`game` - `home`	String	Market name of the home team ex. `Delaware`
`name`	`game` - `home`	String	Home team name ex. `Kings`
`remaining_timeouts`	`game` - `home`	Integer	Remaining timeouts for the home team

Clock:

Attribute	Parent Element	Type	Description
`game_decimal`	`clocks`	String	Clock value in decimal form when the game clock is under 1:00. Otherwise it displays the same value as `clock` ex. `00:21.70`
`game`	`clocks`	String	Game clock value for an event ex. `1157`
`running`	`clocks`	Boolean	Signifies the game clock was running when a message was sent
`shot`	`clocks`	String	Shot clock value for an event ex. `11.00`

Quarter:

Attribute	Parent Element	Type	Description
`number`	`period`	Integer	Number of a quarter
`sequence`	`period`	Integer	Sequential number of a quarter
`type`	`period`	GUID	Type of period `REG`, `OT`