Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Push Clock

NBA G League Push Clock retrieves a game clock feed with high level scoring and possession information.

Syntax

https://api.sportradar.com/nbdl/{access_level}/stream/`{language_code}`/clock/subscribe

Parameters

Parameter

Description

access_level

Defines the access level of your API key

production, trial

language_code

Optional code for supported languages

en (English)

🔐

Authorization

Place your API key in the header for each request (x-api-key)


Optional Query String Parameters

By default, a Push feed will provide all data available for all in progress games. If needed, you can filter the data returned by including query strings.

Each query string parameter can be added with a preceding ampersand (&).

Parameter

Description

match

Match id

Example: match=sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56

locale

Language returned expressed as a 2-letter code

en (English)

Example: locale=en

status

Game status

inprogress, created

Example: status=inprogress



Code Samples

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

url = URI("https://api.sportradar.com/nbdl/trial/stream/en/clock/subscribe")

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)
request["x-api-key"] = "{your_api_key}"  # Replace with your actual key

response = http.request(request)
puts response.read_body
import requests
import json

headers = {
    'x-api-key': 'your_api_key'  # Replace with your actual key
}

r = requests.get(
    "https://api.sportradar.com/nbdl/trial/stream/en/clock/subscribe",
    headers=headers,
    allow_redirects=False
)

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

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 -X GET 'https://api.sportradar.com/nbdl/trial/stream/en/clock/subscribe' \
  -H 'x-api-key: {your_api_key}'

Samples with Query String Params

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

url = URI("https://api.sportradar.com/nbdl/trial/stream/en/clock/subscribe?&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)
request["x-api-key"] = "{your_api_key}"  # Replace with your actual key

response = http.request(request)
puts response.read_body
import requests
import json

headers = {
    'x-api-key': 'your_api_key'  # Replace with your actual key
}

r = requests.get("https://api.sportradar.com/nbdl/trial/stream/en/clock/subscribe",
    params = {'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 -X GET 'api.sportradar.com/nbdl/trial/stream/en/clock/subscribe?&status=inprogress&match=sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56'
  -H 'x-api-key: {your_api_key}'


Response Sample

The above commands return json like this.


Simulations

Check out our Simulations to replay actual games at any time, on your own schedule. Push simulations are available as well.



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:
AttributeParent ElementTypeDescription
bonusgame - awayBooleanSignifies a team is in the bonus
pointsgame - awayIntegerTotal points for the away team
idgame - awayGUIDUnique ID of the away team
ex. 67a79348-041a-45f6-bb12-722d38dc8dbf
marketgame - awayStringMarket name of the away team
ex. Delaware
namegame - awayStringAway team name
ex. Kings
remaining_timeoutsgame - awayIntegerRemaining timeouts for the away team
bonusgame - homeBooleanSignifies a team is in the bonus
pointsgame - homeIntegerTotal points for the home team
idgame - homeGUIDUnique ID of the home team
ex. 67a79348-041a-45f6-bb12-722d38dc8dbf
marketgame - homeStringMarket name of the home team
ex. Delaware
namegame - homeStringHome team name
ex. Kings
remaining_timeoutsgame - homeIntegerRemaining timeouts for the home team
Clock:
AttributeParent ElementTypeDescription
game_decimalclocksStringClock value in decimal form when the game clock is under 1:00. Otherwise it displays the same value as clock
ex. 00:21.70
gameclocksStringGame clock value for an event
ex. 1157
runningclocksBooleanSignifies the game clock was running when a message was sent
shotclocksStringShot clock value for an event
ex. 11.00
Quarter:
AttributeParent ElementTypeDescription
numberperiodIntegerNumber of a quarter
sequenceperiodIntegerSequential number of a quarter
typeperiodGUIDType of period
REG, OT