Live game state - SportQuanta

Get the current live state for a game

curl --request GET \
  --url https://api.sportquanta.com/v1/{league}/games/{id}/live \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sportquanta.com/v1/{league}/games/{id}/live', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportquanta.com/v1/{league}/games/{id}/live",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportquanta.com/v1/{league}/games/{id}/live"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportquanta.com/v1/{league}/games/{id}/live")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "data": {
    "game_id": "<string>",
    "status": {
      "status_code": "<string>",
      "status_label": "<string>",
      "period_ordinal": 123,
      "updated_at": "2023-11-07T05:31:56Z",
      "period_label": "<string>",
      "score": {
        "home": 123,
        "away": 123
      },
      "clock": {
        "is_running": true,
        "minute": 123,
        "second": 123,
        "display": "<string>"
      },
      "state_revision": 123
    },
    "baseball": {
      "count": {
        "balls": 123,
        "strikes": 123,
        "outs": 123
      },
      "bases": {
        "first": true,
        "second": true,
        "third": true,
        "first_runner": {
          "id": "<string>",
          "name": "<string>",
          "localized_names": {}
        },
        "second_runner": {
          "id": "<string>",
          "name": "<string>",
          "localized_names": {}
        },
        "third_runner": {
          "id": "<string>",
          "name": "<string>",
          "localized_names": {}
        }
      },
      "current_pitcher": {
        "id": "<string>",
        "source_id": "<string>",
        "name": "<string>",
        "localized_names": {},
        "jersey_number": "<string>",
        "headshot_url": "<string>",
        "throws": "<string>",
        "era": 123
      },
      "current_batter": {
        "id": "<string>",
        "source_id": "<string>",
        "name": "<string>",
        "localized_names": {},
        "bat_order": 123,
        "position": "<string>"
      },
      "weather": {
        "temp_f": 123,
        "feels_like_f": 123,
        "dew_point_f": 123,
        "conditions": "<string>",
        "weather_code": 123,
        "wind_mph": 123,
        "wind_dir": "<string>",
        "wind_deg": 123,
        "humidity_pct": 123,
        "precip_prob_pct": 123,
        "cloud_pct": 123,
        "pressure_hpa": 123
      },
      "attendance": 123
    },
    "basketball": {
      "team_fouls": {
        "home": 123,
        "away": 123
      },
      "in_bonus": {
        "home": true,
        "away": true
      }
    },
    "soccer": {
      "minute": 123,
      "stoppage_minute": 123,
      "red_cards": {
        "home": 123,
        "away": 123
      },
      "possession": {
        "home": 123,
        "away": 123
      },
      "shots_on_target": {
        "home": 123,
        "away": 123
      }
    }
  },
  "_meta": {
    "request_id": "<string>",
    "served_from": "live",
    "cache_ttl_seconds": 123,
    "provenance": {},
    "availability": {}
  }
}

GET

{league}

games

{id}

live

Get the current live state for a game

curl --request GET \
  --url https://api.sportquanta.com/v1/{league}/games/{id}/live \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sportquanta.com/v1/{league}/games/{id}/live', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportquanta.com/v1/{league}/games/{id}/live",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportquanta.com/v1/{league}/games/{id}/live"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportquanta.com/v1/{league}/games/{id}/live")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "data": {
    "game_id": "<string>",
    "status": {
      "status_code": "<string>",
      "status_label": "<string>",
      "period_ordinal": 123,
      "updated_at": "2023-11-07T05:31:56Z",
      "period_label": "<string>",
      "score": {
        "home": 123,
        "away": 123
      },
      "clock": {
        "is_running": true,
        "minute": 123,
        "second": 123,
        "display": "<string>"
      },
      "state_revision": 123
    },
    "baseball": {
      "count": {
        "balls": 123,
        "strikes": 123,
        "outs": 123
      },
      "bases": {
        "first": true,
        "second": true,
        "third": true,
        "first_runner": {
          "id": "<string>",
          "name": "<string>",
          "localized_names": {}
        },
        "second_runner": {
          "id": "<string>",
          "name": "<string>",
          "localized_names": {}
        },
        "third_runner": {
          "id": "<string>",
          "name": "<string>",
          "localized_names": {}
        }
      },
      "current_pitcher": {
        "id": "<string>",
        "source_id": "<string>",
        "name": "<string>",
        "localized_names": {},
        "jersey_number": "<string>",
        "headshot_url": "<string>",
        "throws": "<string>",
        "era": 123
      },
      "current_batter": {
        "id": "<string>",
        "source_id": "<string>",
        "name": "<string>",
        "localized_names": {},
        "bat_order": 123,
        "position": "<string>"
      },
      "weather": {
        "temp_f": 123,
        "feels_like_f": 123,
        "dew_point_f": 123,
        "conditions": "<string>",
        "weather_code": 123,
        "wind_mph": 123,
        "wind_dir": "<string>",
        "wind_deg": 123,
        "humidity_pct": 123,
        "precip_prob_pct": 123,
        "cloud_pct": 123,
        "pressure_hpa": 123
      },
      "attendance": 123
    },
    "basketball": {
      "team_fouls": {
        "home": 123,
        "away": 123
      },
      "in_bonus": {
        "home": true,
        "away": true
      }
    },
    "soccer": {
      "minute": 123,
      "stoppage_minute": 123,
      "red_cards": {
        "home": 123,
        "away": 123
      },
      "possession": {
        "home": 123,
        "away": 123
      },
      "shots_on_target": {
        "home": 123,
        "away": 123
      }
    }
  },
  "_meta": {
    "request_id": "<string>",
    "served_from": "live",
    "cache_ttl_seconds": 123,
    "provenance": {},
    "availability": {}
  }
}

Reference context: KBO. Overview · Response conventions

Authorizations

Authorization

string

header

required

Send a workspace API token in the Authorization: Bearer <token> header.

Path Parameters

league

enum<string>

default:kbo

required

League for this reference section: kbo.

Available options:

kbo

string

required

Query Parameters

provenance

boolean

default:false

Opt in to per-field provenance on supported single game, match, team, player, and venue reads. Lists and composites accept the flag but generally omit provenance. It is returned under _meta.provenance only when source metadata exists.

Response

Current live game state and sport-specific detail.

data

object

required

Hide child attributes

data.game_id

string

required

data.status

object

required

Hide child attributes

data.status.status_code

string

required

data.status.status_label

string

required

data.status.period_ordinal

integer

required

data.status.updated_at

string<date-time>

required

data.status.period_label

string

data.status.score

object

Hide child attributes

data.status.score.home

integer

required

data.status.score.away

integer

required

data.status.clock

object

Hide child attributes

data.status.clock.is_running

boolean

required

data.status.clock.minute

integer

data.status.clock.second

integer

data.status.clock.display

string

data.status.state_revision

integer

data.baseball

object

Hide child attributes

data.baseball.count

object

Hide child attributes

data.baseball.count.balls

integer

required

data.baseball.count.strikes

integer

required

data.baseball.count.outs

integer

required

data.baseball.bases

object

Hide child attributes

data.baseball.bases.first

boolean

required

data.baseball.bases.second

boolean

required

data.baseball.bases.third

boolean

required

data.baseball.bases.first_runner

object

Hide child attributes

data.baseball.bases.first_runner.id

string

data.baseball.bases.first_runner.name

string

data.baseball.bases.first_runner.localized_names

object | null

Hide child attributes

data.baseball.bases.first_runner.localized_names.{key}

any

data.baseball.bases.second_runner

object

Hide child attributes

data.baseball.bases.second_runner.id

string

data.baseball.bases.second_runner.name

string

data.baseball.bases.second_runner.localized_names

object | null

Hide child attributes

data.baseball.bases.second_runner.localized_names.{key}

any

data.baseball.bases.third_runner

object

Hide child attributes

data.baseball.bases.third_runner.id

string

data.baseball.bases.third_runner.name

string

data.baseball.bases.third_runner.localized_names

object | null

Hide child attributes

data.baseball.bases.third_runner.localized_names.{key}

any

data.baseball.current_pitcher

object

Hide child attributes

data.baseball.current_pitcher.id

string

data.baseball.current_pitcher.source_id

string

data.baseball.current_pitcher.name

string

data.baseball.current_pitcher.localized_names

object | null

Hide child attributes

data.baseball.current_pitcher.localized_names.{key}

any

data.baseball.current_pitcher.jersey_number

string

data.baseball.current_pitcher.headshot_url

string

data.baseball.current_pitcher.throws

string

data.baseball.current_pitcher.era

number

data.baseball.current_batter

object

Hide child attributes

data.baseball.current_batter.id

string

data.baseball.current_batter.source_id

string

data.baseball.current_batter.name

string

data.baseball.current_batter.localized_names

object | null

Hide child attributes

data.baseball.current_batter.localized_names.{key}

any

data.baseball.current_batter.bat_order

integer

data.baseball.current_batter.position

string

data.baseball.weather

object

Hide child attributes

data.baseball.weather.temp_f

number

Temperature in Fahrenheit.

data.baseball.weather.feels_like_f

number

Apparent temperature in Fahrenheit.

data.baseball.weather.dew_point_f

number

Dew point in Fahrenheit.

data.baseball.weather.conditions

string

data.baseball.weather.weather_code

number

data.baseball.weather.wind_mph

number

Wind speed in miles per hour.

data.baseball.weather.wind_dir

string

data.baseball.weather.wind_deg

number

Wind bearing in degrees.

data.baseball.weather.humidity_pct

number

Relative humidity percentage.

data.baseball.weather.precip_prob_pct

number

Precipitation probability percentage.

data.baseball.weather.cloud_pct

number

Cloud cover percentage.

data.baseball.weather.pressure_hpa

number

Surface pressure in hectopascals.

data.baseball.attendance

integer

data.basketball

object

Hide child attributes

data.basketball.team_fouls

object

Hide child attributes

data.basketball.team_fouls.home

integer

data.basketball.team_fouls.away

integer

data.basketball.in_bonus

object

Hide child attributes

data.basketball.in_bonus.home

boolean | null

data.basketball.in_bonus.away

boolean | null

data.soccer

object

Hide child attributes

data.soccer.minute

integer

data.soccer.stoppage_minute

integer

data.soccer.red_cards

object

Hide child attributes

data.soccer.red_cards.home

integer

data.soccer.red_cards.away

integer

data.soccer.possession

object

Hide child attributes

data.soccer.possession.home

number

data.soccer.possession.away

number

data.soccer.shots_on_target

object

Hide child attributes

data.soccer.shots_on_target.home

integer

data.soccer.shots_on_target.away

integer

_meta

object

Hide child attributes

_meta.request_id

string

_meta.served_from

enum<string>

Available options:

live,

cache

_meta.cache_ttl_seconds

integer

Response cache TTL; independent of source freshness. Omitted when zero.

_meta.provenance

object

Hide child attributes

_meta.provenance.{key}

object

Hide child attributes

_meta.provenance.{key}.source

string

_meta.provenance.{key}.run_id

string

_meta.provenance.{key}.ingested_at

string<date-time>

_meta.availability

object

Endpoint-specific availability context, including soccer roster coverage.