Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Timeline Probabilities

Global Basketball Timeline Probabilities Provides a timeline of pre-match and live probability changes for a given game.

⏱️

Update Frequency

1s Time To Live / Cache



Data Points

Category & Sport:
AttributeParent ElementTypeDescription
country_codesport_event_context - categoryStringCountry code for a competition category
ex. FRA (France)
idsport_event_context - categoryStringUnique category ID for a competition
ex. sr:category:110
namesport_event_context - categoryStringName for a competition category
ex. France
idsport_event_context - sportStringUnique sport ID for a competitor
ex. sr:sport:2
namesport_event_context - sportStringName for a competitor's sport
ex. Basketball
Competition:
AttributeParent ElementTypeDescription
gendersport_event_context - competitionStringGender for a competition
men, women
idsport_event_context - competitionStringUnique ID for a competition
ex. sr:competition:264 (Liga ACB)
namesport_event_context - competitionStringName of a competition
ex. Pro A, NBA
parent_idsport_event_context - competitionStringUnique parent ID for a competition. Typically present for group competitions
ex. sr:competition:30190 used to group NCAA postseason tournaments.
Groups:
AttributeParent ElementTypeDescription
idsport_event_context - groups - groupStringUnique ID for a sport event's group
ex. sr:league:76103 (Euroleague 23/24)
namesport_event_context - groups - groupStringName of a sport event's group
ex. Euroleague 23/24
group_namesport_event_context - groups - groupStringAbbreviated name of a sport event's group
ex. D
Rounds:
AttributeParent ElementTypeDescription
competition_sport_event_numbersport_event_context - roundIntegerSport event number within a competition. Used for competitions that have fixed match numbers.
cup_round_idsport_event_context - roundStringUnique ID for a sport event's cup round
ex. sr:cup_round:1988995
cup_round_number_of_sport_eventssport_event_context - roundIntegerNumber of events in a sport event's round
cup_round_sport_event_numbersport_event_context - roundIntegerNumber within the cup_round of a match ID. For example, 1st leg of 2
namesport_event_context - roundStringName of a sport event's round
ex. round_3 or round_of_16
numbersport_event_context - roundIntegerNumber of a sport event's round
other_sport_event_idsport_event_context - roundStringA linked sport event ID, typically in a two-legged tie
ex. sr:sport_event:47395897
Seasons:
AttributeParent ElementTypeDescription
competition_idsport_event_context - seasonStringUnique ID for the competition a sport event belongs to
ex. sr:competition:264 (Liga ACB)
disabledsport_event_context - seasonBooleanSignifies a season has been disabled when true
end_datesport_event_context - seasonDateEnd date of a sport event's season
ex. 2024-06-17
idsport_event_context - seasonStringUnique ID for a sport event's season
ex. sr:season:108577 (Liga ACB 23/24)
namesport_event_context - seasonStringName of a sport event's season
ex. Liga ACB 23/24
start_datesport_event_context - seasonDateStart date of a sport event's season
ex. 2023-09-23
yearsport_event_context - seasonStringYear of a sport event's season
ex. 23/24
Stages:
AttributeParent ElementTypeDescription
end_datesport_event_context - stageDateEnd date of a sport event's stage
ex. 2024-05-19
ordersport_event_context - stageIntegerOrder of a stage within a season
phasesport_event_context - stageStringName of a sport event's stage
ex. regular season, conference, playoffs

See the enum_phase entry in our Global Basketball OpenAPI spec for a complete list of valid phase enum values
start_datesport_event_context - stageDateStart date of a sport event's stage
ex. 2023-08-11
typesport_event_context - stageStringType of a sport event's stage
cup, league
yearsport_event_context - stageStringYear of a sport event's stage
ex. 23/24
Competitor:

Competitor information appears in the competitors node under both sport_event and statistics

AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name
ex. RMA (Real Madrid)
age_groupcompetitors - competitorStringAge group of a competitor, when applicable
ex. U23
countrycompetitors - competitorStringCountry of a competitor
ex. Spain
country_codecompetitors - competitorStringCountry code of a competitor
ex. ESP (Spain)
divisioncompetitors - competitorIntegerDivision number for a competitor
gendercompetitors - competitorStringGender for a competitor
male, female
idcompetitors - competitorStringUnique ID for a competitor
ex. sr:competitor:3540 (Real Madrid)
namecompetitors - competitorStringName for a competitor
ex. Real Madrid
qualifiercompetitors - competitorStringDesignation of a competitor for a sport event
home, away
statecompetitors - competitorStringState of a competitor
ex. TX (Texas)
Game Probabilities:
AttributeParent ElementTypeDescription
away_scoretimeline - marketIntegerScore for the away team
home_scoretimeline - marketIntegerScore for the home team
last_updatedtimeline - marketDate-timeTimestamp of the most recent probability update
ex. 2024-04-23T19:22:59+00:00
livetimeline - marketBooleanSignifies that the game is live for this market when true
match_timetimeline - marketStringClock value of a game in minutes and seconds
ex. 21:40
nametimeline - marketStringProbability market
2way
remaining_timetimeline - marketStringRemaining time in a game
ex. 18:20
remaining_time_in_periodtimeline - marketStringRemaining time in a period
ex. 8:20
removedtimeline - marketBooleanSignifies a market has been removed when true
nametimeline - market - outcomeStringProbability market outcome
home_team_winner, away_team_winner
probabilitytimeline - market - outcomeFloatProbability of the market outcome (home win, away win) in percentage
ex. 36.1
Player:
AttributeParent ElementTypeDescription
idstatistics - competitor - playerStringUnique ID of a player
ex. sr:player:608026
namestatistics - competitor - playerStringName of a player
ex. Tavares, Edy
Sport Event:
AttributeParent ElementTypeDescription
neutralsport_event_conditions - groundBooleanSignifies a neutral ground sport event when true
idsport_eventStringUnique ID of a sport event
ex. sr:sport_event:49796317
replaced_bysport_eventStringAn alternative sport event ID if the match is postponed and played at a later date
ex. sr:sport_event:47395897
resume_timesport_eventDateAn updated timestamp if there is a delay at the start or interruption during a match
ex. 2024-03-26T20:00:00+00:00
start_timesport_eventDateStart time of a sport event
ex. 2024-03-26T20:00:00+00:00
start_time_confirmedsport_eventBooleanSignifies the start time of a sport event is confirmed when true
Sport Event - Coverage Properties:
AttributeParent ElementTypeDescription
livesport_event - coverageBooleanSignifies a sport event is covered live when true
typesport_event - coverage - propertyStringType of coverage for a sport event
ex. boxscore or lineups

See our FAQ for a complete list of coverage types and their descriptions
valuesport_event - coverage - propertyBooleanSignifies a coverage types is available when true

For example, type="lineups" value="true" signifies lineups are available for this sport event
Sport Event Situation:
AttributeParent ElementTypeDescription
playedsport_event_status - clockStringGame time played in a quarter/period, in minutes
ex. 00:36
remainingsport_event_status - clockStringTime remaining in a quarter/period, in minutes
ex. 9:21
away_scoresport_event_status - period_scoresIntegerAway team period score
home_scoresport_event_status - period_scoresIntegerHome team period score
numbersport_event_status - period_scoresIntegerPeriod number
typesport_event_status - period_scoresStringPeriod type
regular_period, overtime, 1st_quarter, 2nd_quarter, 3rd_quarter, 4th_quarter, 1st_half, 2nd_half, penalties, 1st_pause, 2nd_pause, 3rd_pause, awaiting_extra, awaiting_penalties, interrupted, 1st_extra, 2nd_extra
Sport Event Status:
AttributeParent ElementTypeDescription
away_scoresport_event_statusIntegerTotal score for the away team in the match
away_normaltime_scoresport_event_statusIntegerScore for the away team in normal time
home_scoresport_event_statusIntegerTotal score for the home team in the match
home_normaltime_scoresport_event_statusIntegerScore for the home team in normal time
match_statussport_event_statusStringStatus within a match (sport event). Provides more detail on the state of a sport event when live than status
ex. not_started, 1st_quarter, ended, cancelled

See our FAQ for a complete list of statuses and their definitions.
scount_abandonedsport_event_statusBooleanSignifies a sport event was abandoned by a scout when true
statussport_event_statusStringStatus of a sport event
ex. not_started, live, ended, closed

See our FAQ for a complete list of statuses and their definitions.
winner_idsport_event_statusStringUnique ID of the match winner
ex. sr:competitor:44
Game Stats (Player):
AttributeParent ElementTypeDescription
assistsplayer - statisticsIntegerNumber of assists for a player in a game
blocksplayer - statisticsIntegerNumber of shots blocked for a player in a game
defensive_reboundsplayer - statisticsIntegerNumber of defensive rebounds for a player in a game
field_goals_attemptedplayer - statisticsIntegerNumber of field goal attempts for a player in a game
field_goals_madeplayer - statisticsIntegerNumber of field goals for a player in a game
free_throws_attemptedplayer - statisticsIntegerNumber of free throw attempts for a player in a game
free_throws_madeplayer - statisticsIntegerNumber of free throws for a player in a game
minutesplayer - statisticsIntegerNumber of minutes played for a player in a game
offensive_reboundsplayer - statisticsIntegerNumber of offensive rebounds for a player in a game
personal_foulsplayer - statisticsIntegerNumber of personal fouls for a player in a game
pointsplayer - statisticsIntegerNumber of points for a player in a game
stealsplayer - statisticsIntegerNumber of steals for a player in a game
technical_foulsplayer - statisticsIntegerNumber of technical fouls for a player in a game
three_pointers_attemptedplayer - statisticsIntegerNumber of three point attempts for a player in a game
three_pointers_madeplayer - statisticsIntegerNumber of three pointers for a player in a game
total_reboundsplayer - statisticsIntegerNumber of total rebounds (offense + defense) for a player in a game
turnoversplayer - statisticsIntegerNumber of turnovers for a player in a game
Game Stats (Team):
AttributeParent ElementTypeDescription
assistscompetitor - statisticsIntegerNumber of assists for a team in a game
ball_possessioncompetitor - statisticsIntegerPercentage of team ball possession for a game
biggest_leadcompetitor - statisticsIntegerBiggest lead in points for a team in a game
defensive_reboundscompetitor - statisticsIntegerNumber of defensive rebounds for a team in a game
foulscompetitor - statisticsIntegerNumber of fouls for a team in a game
free_throw_attempts_successfulcompetitor - statisticsIntegerNumber of free throws for a team in a game
free_throw_attempts_totalcompetitor - statisticsIntegerNumber of free throw attempts for a team in a game
offensive_reboundscompetitor - statisticsIntegerNumber of offensive rebounds for a team in a game
reboundscompetitor - statisticsIntegerNumber of total rebounds (offense + defense) for a team in a game
shots_blockedcompetitor - statisticsIntegerNumber of shots blocked for a team in a game
stealscompetitor - statisticsIntegerNumber of steals for a team in a game
team_leadscompetitor - statisticsIntegerNumber of times a team had a lead in a game
team_reboundscompetitor - statisticsIntegerNumber of team rebounds in a game
team_turnoverscompetitor - statisticsIntegerNumber of team turnovers in a game
three_point_attempts_successfulcompetitor - statisticsIntegerNumber of three pointers for a team in a game
three_point_attempts_totalcompetitor - statisticsIntegerNumber of three point attempts for a team in a game
time_spent_in_leadcompetitor - statisticsIntegerNumber of minutes a team led in a game
timeoutscompetitor - statisticsIntegerNumber of timeouts used for a team in a game
turnoverscompetitor - statisticsIntegerNumber of turnovers for a team in a game
two_point_attempts_successfulcompetitor - statisticsIntegerNumber of two pointers for a team in a game
two_point_attempts_totalcompetitor - statisticsIntegerNumber of two point attempts for a team in a game
Venue:
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a competitor's home venue
ex. 15000
changedvenueBooleanSignifies a venue has been changed when true
city_namevenueStringCity name of a competitor's home venue
ex. Madrid
country_codevenueStringCountry code of a competitor's home venue
ex. ESP (Spain)
country_namevenueStringCountry name of a competitor's home venue
ex. Spain
idvenueStringUnique ID of a competitor's home venue
ex. sr:venue:7000
map_coordinatesvenueStringCoordinates of a competitor's home venue
ex. 40.423889,-3.671667
namevenueStringName of a competitor's home venue
ex. WiZink Center
reduced_capacityvenueBooleanOptional attribute signifying a venue has a restricted capacity when true
reduced_capacity_maxvenueIntegerValue of a venue's restrictued capacity
timezonevenueStringTimezone of a competitor's home venue
ex. Europe/Madrid
Language
Credentials
Query
Click Try It! to start a request and see the response here!