Push Game Clock

Syntax

https://api.sportradar.com/nba/{access_level}/stream/{language_code}/game_clock/subscribe

Parameters

Parameter	Description
`access_level`	Defines the access level of your API key `production`, `trial`
`language_code`	2-letter code for supported languages `en` (English)

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`
`status`	Game status `inprogress`, `created` Example: `status=inprogress`
`resumeSessionId`	Resumes a dropped session within 10 minutes of its last message and replays what you missed; see Disconnections on the Push Feeds page Example: `resumeSessionId=<sessionId>`

Code Samples

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

url = URI("https://api.sportradar.com/nba/trial/stream/en/game_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/nba/trial/stream/en/game_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/nba/trial/stream/en/game_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/nba/trial/stream/en/game_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/nba/trial/stream/en/game_clock/subscribe",
    params = {'status': 'inprogress', 'match': 'sd:match:673b459c-7506-4c11-9273-1b9502537f1d'},
    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/nba/trial/stream/en/game_clock/subscribe?&status=inprogress&match=sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56'
  -H 'x-api-key: {your_api_key}'

Response Samples

{
  "payload": {
    "game": {
      "id": "023405e4-4019-4c27-ae8b-b7064db1d8d0",
      "status": "inprogress",
      "coverage": "full",
      "reference": "0022600001",
      "scheduled": "2026-10-20T19:00:00+00:00",
      "home": {
        "name": "Pistons",
        "market": "Detroit",
        "reference": "1610612765",
        "id": "583ec928-fb46-11e1-82cb-f4ce4684ea4c",
        "sr_id": "sr:team:3424"
      },
      "away": {
        "name": "Celtics",
        "market": "Boston",
        "reference": "1610612738",
        "id": "583eccfa-fb46-11e1-82cb-f4ce4684ea4c",
        "sr_id": "sr:team:3422"
      },
      "sr_id": "sr:match:73682354"
    },
    "period": {
      "sequence": 1,
      "number": 1
    },
    "clocks": {
      "game": "1029",
      "running": true,
      "shot": "22.00",
      "game_decimal": "1029"
    }
  },
  "locale": "en",
  "metadata": {
    "match": "sd:match:023405e4-4019-4c27-ae8b-b7064db1d8d0,sr:match:73682354",
    "league": "nba",
    "locale": "en",
    "status": "inprogress",
    "operation": "update",
    "version": "v7"
  }
}

{
  "payload": {
    "game": {
      "id": "023405e4-4019-4c27-ae8b-b7064db1d8d0",
      "status": "inprogress",
      "coverage": "full",
      "reference": "0022600001",
      "scheduled": "2026-10-20T19:00:00+00:00",
      "home": {
        "name": "Pistons",
        "market": "Detroit",
        "reference": "1610612765",
        "id": "583ec928-fb46-11e1-82cb-f4ce4684ea4c",
        "sr_id": "sr:team:3424"
      },
      "away": {
        "name": "Celtics",
        "market": "Boston",
        "reference": "1610612738",
        "id": "583eccfa-fb46-11e1-82cb-f4ce4684ea4c",
        "sr_id": "sr:team:3422"
      },
      "sr_id": "sr:match:73682354"
    },
    "period": {
      "sequence": 1,
      "number": 1
    },
    "clocks": {
      "game": "1029",
      "running": true,
      "shot": "21.00",
      "game_decimal": "1029"
    }
  },
  "locale": "en",
  "metadata": {
    "match": "sd:match:023405e4-4019-4c27-ae8b-b7064db1d8d0,sr:match:73682354",
    "league": "nba",
    "locale": "en",
    "status": "inprogress",
    "operation": "update",
    "version": "v7"
  }
}

{
  "payload": {
    "game": {
      "id": "023405e4-4019-4c27-ae8b-b7064db1d8d0",
      "status": "inprogress",
      "coverage": "full",
      "reference": "0022600001",
      "scheduled": "2026-10-20T19:00:00+00:00",
      "home": {
        "name": "Pistons",
        "market": "Detroit",
        "reference": "1610612765",
        "id": "583ec928-fb46-11e1-82cb-f4ce4684ea4c",
        "sr_id": "sr:team:3424"
      },
      "away": {
        "name": "Celtics",
        "market": "Boston",
        "reference": "1610612738",
        "id": "583eccfa-fb46-11e1-82cb-f4ce4684ea4c",
        "sr_id": "sr:team:3422"
      },
      "sr_id": "sr:match:73682354"
    },
    "period": {
      "sequence": 1,
      "number": 1
    },
    "clocks": {
      "game": "1028",
      "running": true,
      "shot": "21.00",
      "game_decimal": "1028"
    }
  },
  "locale": "en",
  "metadata": {
    "match": "sd:match:023405e4-4019-4c27-ae8b-b7064db1d8d0,sr:match:73682354",
    "league": "nba",
    "locale": "en",
    "status": "inprogress",
    "operation": "update",
    "version": "v7"
  }
}

{
  "payload": {
    "game": {
      "id": "023405e4-4019-4c27-ae8b-b7064db1d8d0",
      "status": "inprogress",
      "coverage": "full",
      "reference": "0022600001",
      "scheduled": "2026-10-20T19:00:00+00:00",
      "home": {
        "name": "Pistons",
        "market": "Detroit",
        "reference": "1610612765",
        "id": "583ec928-fb46-11e1-82cb-f4ce4684ea4c",
        "sr_id": "sr:team:3424"
      },
      "away": {
        "name": "Celtics",
        "market": "Boston",
        "reference": "1610612738",
        "id": "583eccfa-fb46-11e1-82cb-f4ce4684ea4c",
        "sr_id": "sr:team:3422"
      },
      "sr_id": "sr:match:73682354"
    },
    "period": {
      "sequence": 1,
      "number": 1
    },
    "clocks": {
      "game": "1028",
      "running": true,
      "shot": "20.00",
      "game_decimal": "1028"
    }
  },
  "locale": "en",
  "metadata": {
    "match": "sd:match:023405e4-4019-4c27-ae8b-b7064db1d8d0,sr:match:73682354",
    "league": "nba",
    "locale": "en",
    "status": "inprogress",
    "operation": "update",
    "version": "v7"
  }
}

Simulations

Simulations support for Push Game Clock is coming soon. In the meantime, see our Simulations documentation for how our replay service works, including Push simulations.

📘
Streaming Live Data
Learn how to use the Push Game Clock feed to stream live NBA game clock updates in our Push Feeds integration scenario.

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. `023405e4-4019-4c27-ae8b-b7064db1d8d0`
`reference`	`game`	String	League reference ID of a game ex. `0022600001`
`sr_id`	`game`	GUID	Unique Sportradar ID of a game ex. `sr:match:73682354`
`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
`scheduled`	`game`	dateTime	Scheduled date and time of a game ex. `2026-10-20T19:00:00+00:00`

Teams

Attribute	Parent Element	Type	Description
`id`	`game` - `away`	GUID	Unique ID of the away team ex. `583eccfa-fb46-11e1-82cb-f4ce4684ea4c`
`market`	`game` - `away`	String	Market name of the away team ex. `Boston`
`name`	`game` - `away`	String	Away team name ex. `Celtics`
`reference`	`game` - `away`	String	League reference ID of the away team ex. `1610612738`
`sr_id`	`game` - `away`	GUID	Unique Sportradar ID of the away team ex. `sr:team:3422`
`id`	`game` - `home`	GUID	Unique ID of the home team ex. `583ec928-fb46-11e1-82cb-f4ce4684ea4c`
`market`	`game` - `home`	String	Market name of the home team ex. `Detroit`
`name`	`game` - `home`	String	Home team name ex. `Pistons`
`reference`	`game` - `home`	String	League reference ID of the home team ex. `1610612765`
`sr_id`	`game` - `home`	GUID	Unique Sportradar ID of the home team ex. `sr:team:3424`

Period

Attribute	Parent Element	Type	Description
`number`	`period`	Integer	Number of a quarter
`sequence`	`period`	Integer	Sequential number of a quarter

Clock

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

Metadata

Attribute	Parent Element	Type	Description
`league`	`metadata`	String	Alias of a league ex. `nba`
`locale`	`metadata`	String	Language code ex. `en` (English)
`match`	`metadata`	String	Comma-separated list of game identifiers ex. `sd:match:023405e4-4019-4c27-ae8b-b7064db1d8d0,sr:match:73682354`
`operation`	`metadata`	String	Operation of an update `update`, `delete`
`status`	`metadata`	String	The status of a game Please see our FAQ section for a list of game status definitions
`version`	`metadata`	String	Version of the API ex. `v7`