Docs
Coverage MatrixDocumentationRelease LogLog In

Push Clock

WNBA Push Clock retrieves a game clock feed with high level scoring and possession information.

Syntax

https://api.sportradar.us/wnba/{access_level}/stream/clock/subscribe?api_key={your_api_key}

Replace the placeholders with the following path parameters.

ParameterDescription
access_levelDefines the access level of your API key as Production (production), Trial (trial), or Simulation (simulation).
your_api_keyYour 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.

๐Ÿ“˜

Note

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:

ParameterDescription
localeLocale expressed as 2 letter code: locale={language_code}
Example: locale=en
matchMatch id expressed as: sd:match:{match_id}.
Example: match=sd:match:b9cf745b-36a1-404e-8159-78d719742a6b
operationUpdate (update), delete (delete), or insert (insert).
statusStatus type expressed as: inprogress or created.
Example: status=inprogress

Code Samples

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

url = URI("https://api.sportradar.us/wnba/trial/stream/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/wnba/trial/stream/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/wnba/trial/stream/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/wnba/trial/stream/clock/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:b9cf745b-36a1-404e-8159-78d719742a6b")

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/wnba/trial/stream/clock/subscribe",
    params = {'api_key': 'your_api_key', 'status': 'inprogress', 'match': 'sd:match:b9cf745b-36a1-404e-8159-78d719742a6b'},
    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/wnba/trial/stream/clock/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:b9cf745b-36a1-404e-8159-78d719742a6b'

Response Samples

The above commands return json like this.



Data Points

Game:
AttributeParent ElementTypeDescription
coveragegameStringCoverage level of a game
full, extended_boxscore
idgameGUIDUnique ID of a game
ex. a015b02d-845c-40c1-8ef4-844984f47e4d
referencegameStringLeague reference ID of a game
ex. 1611661323
sr_idgameGUIDUnique Sportradar ID of a game
ex. sr:match:17582493
statusgameStringThe 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
titlegameStringTitle of a game
ex. Game 3
scheduledgamedateTimeScheduled date and time of a game
ex. 2022-09-25T20:10:00+00:00
Metadata:
AttributeParent ElementTypeDescription
leaguemetadataStringAlias of a league
ex. WNBA
localemetadataStringLanguage code
ex. en (English)
matchmetadataGUIDUnique ID of a game
ex. sd:match:b38e436c-985b-4f59-8a25-68b73b4a98a1,sr:match:17582493
operationmetadataStringOperation of an update
update, delete
statusmetadataStringThe 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
versionmetadataStringVersion 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. a015b02d-845c-40c1-8ef4-844984f47e4d
marketgame - awayStringMarket name of the away team
ex. Connecticut
namegame - awayStringAway team name
ex. Sun
referencegame - awayStringLeague reference ID of the away team
ex. 1611661323
remaining_timeoutsgame - awayIntegerRemaining timeouts for the away team
sr_idgame - awayGUIDUnique Sportradar ID of the away team
ex. sr:team:35547
bonusgame - homeBooleanSignifies a team is in the bonus
pointsgame - homeIntegerTotal points for the home team
idgame - homeGUIDUnique ID of the home team
ex. 0699edf3-5993-4182-b9b4-ec935cbd4fcc
marketgame - homeStringMarket name of the home team
ex. Connecticut
namegame - homeStringHome team name
ex. Sun
referencegame - homeStringLeague reference ID of the home team
ex. 1611661317
remaining_timeoutsgame - homeIntegerRemaining timeouts for the home team
sr_idgame - homeGUIDUnique Sportradar ID of the home team
ex. sr:team:35547
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