Seasonal Probabilities

Time	Status	User Agent
Retrieving recent requests…

⏱️
Update Frequency
TTL / Cache: 60 seconds
Data Updates: As event probabilities revise
Polling cadence for this and every other feed: Update Frequencies

📘
Working with Seasonal Probabilities
Learn how to use the Seasonal Probabilities feed to page through a season's events and read their pre-match and live entries in our Seasonal and Outright Probabilities integration scenario.

📘
Pagination Note
Pagination may be required to pull all data within this feed. By default, the feed will return 200 sport events.

Data Points

Sport Event Probabilities

Attribute	Parent Element	Type	Description
`away_score`	`market`	String	Total score for the away team in the sport event
`home_score`	`market`	String	Total score for the home team in the sport event
`last_updated`	`market`	Date-time	Timestamp of the most recent probability update ex. `2024-04-23T19:22:59+00:00`
`live`	`market`	Boolean	Signifies that the sport event for this market is currently in progress when `true`
`match_time`	`market`	String	Clock value of a sport event in minutes and seconds ex. `21:40`
`name`	`market`	String	Probability market ex. `2way`, `3way`, `to_qualify`, `home_innings_runs`, `away_innings_runs`
`remaining_time`	`market`	String	Remaining time in a sport event ex. `18:20`
`remaining_time_in_period`	`market`	String	Remaining time in a period ex. `8:20`
`removed`	`market`	Boolean	Signifies a market has been removed when `true`

Outcome

Attribute	Parent Element	Type	Description
`name`	`market` - `outcome`	String	Name of a sport event probability market outcome ex. `home_team_winner`, `away_team_winner`, `draw`, `over`, `under`
`probability`	`market` - `outcome`	Float	Probability of the market outcome (home win, away win, draw) in percentage ex. `36.1`

Category & Sport

Attribute	Parent Element	Type	Description
`country_code`	`sport_event_context` - `category`	String	Country code for a competition category ex. `FRA` (France)
`id`	`sport_event_context` - `category`	String	Unique category ID for a competition ex. `sr:category:110`
`name`	`sport_event_context` - `category`	String	Name for a competition category ex. `France`
`id`	`sport_event_context` - `sport`	String	Unique sport ID for a competitor ex. `sr:sport:2`
`name`	`sport_event_context` - `sport`	String	Name for a competitor's sport ex. `Basketball`

Competition

Attribute	Parent Element	Type	Description
`gender`	`sport_event_context` - `competition`	String	Gender for a competition `men`, `women`
`id`	`sport_event_context` - `competition`	String	Unique ID for a competition ex. `sr:competition:264` (Liga ACB)
`name`	`sport_event_context` - `competition`	String	Name of a competition ex. `Pro A`, `NBA`
`parent_id`	`sport_event_context` - `competition`	String	Unique parent ID for a competition. Typically present for group competitions ex. `sr:competition:30190` used to group NCAA basketball postseason tournaments

Groups

Attribute	Parent Element	Type	Description
`id`	`sport_event_context` - `groups` - `group`	String	Unique ID for a sport event's group ex. `sr:league:76103` (Euroleague 23/24)
`name`	`sport_event_context` - `groups` - `group`	String	Name of a sport event's group ex. `Euroleague 23/24`
`group_name`	`sport_event_context` - `groups` - `group`	String	Abbreviated name of a sport event's group ex. `D`

Rounds

Attribute	Parent Element	Type	Description
`cup_round_id`	`sport_event_context` - `round`	String	Unique ID for a sport event's cup round ex. `sr:cup_round:1751367`
`cup_round_number_of_sport_events`	`sport_event_context` - `round`	Integer	Number of events in a sport event's round
`cup_round_sport_event_number`	`sport_event_context` - `round`	Integer	Number within the `cup_round` of a match ID. For example, 1st leg of 2
`number`	`sport_event_context` - `round`	Integer	Number of a sport event's round

Seasons

Attribute	Parent Element	Type	Description
`competition_id`	`sport_event_context` - `season`	String	Unique ID for the competition a sport event belongs to ex. `sr:competition:264` (Liga ACB)
`disabled`	`sport_event_context` - `season`	Boolean	Signifies a season has been disabled when `true`
`end_date`	`sport_event_context` - `season`	Date	End date of a sport event's season ex. `2024-06-17`
`id`	`sport_event_context` - `season`	String	Unique ID for a sport event's season ex. `sr:season:108577` (Liga ACB 23/24)
`name`	`sport_event_context` - `season`	String	Name of a sport event's season ex. `Liga ACB 23/24`
`start_date`	`sport_event_context` - `season`	Date	Start date of a sport event's season ex. `2023-09-23`
`year`	`sport_event_context` - `season`	String	Year of a sport event's season ex. `23/24`

Stages

Attribute	Parent Element	Type	Description
`end_date`	`sport_event_context` - `stage`	Date	End date of a sport event's stage ex. `2024-05-19`
`order`	`sport_event_context` - `stage`	Integer	Order of a stage within a season
`phase`	`sport_event_context` - `stage`	String	Name of a sport event's stage ex. `regular season`, `playoffs` See the enum_phase entry in our Probabilities Open API Spec for a complete list of valid `phase` enum values
`start_date`	`sport_event_context` - `stage`	Date	Start date of a sport event's stage ex. `2023-08-11`
`type`	`sport_event_context` - `stage`	String	Type of a sport event's stage `cup`, `league`
`year`	`sport_event_context` - `stage`	String	Year of a sport event's stage ex. `23/24`

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `competitor`	String	Abbreviation for a competitor name ex. `RMA` (Real Madrid)
`country`	`competitors` - `competitor`	String	Country of a competitor ex. `Spain`
`country_code`	`competitors` - `competitor`	String	Country code of a competitor ex. `ESP` (Spain)
`division`	`competitors` - `competitor`	Integer	Division number for a competitor
`id`	`competitors` - `competitor`	String	Unique ID for a competitor ex. `sr:competitor:3540` (Real Madrid)
`name`	`competitors` - `competitor`	String	Name for a competitor ex. `Real Madrid`
`qualifier`	`competitors` - `competitor`	String	Designation of a competitor for a sport event `home`, `away`

Sport Event

Attribute	Parent Element	Type	Description
`id`	`sport_event`	String	Unique ID of a sport event ex. `sr:sport_event:49796317`
`start_time`	`sport_event`	Date	Start time of a sport event ex. `2024-03-26T20:00:00+00:00`
`start_time_confirmed`	`sport_event`	Boolean	Signifies the start time of a sport event is confirmed when `true`

Sport Event Status

Attribute	Parent Element	Type	Description
`away_dismissals`	`sport_event_status`	Integer	Number of dismissals for the away team in the match (cricket)
`away_score`	`sport_event_status`	Integer	Total score for the away team in the match
`balls`	`sport_event_status`	Integer	Number of balls for the current batter in a game (baseball)
`bases`	`sport_event_status`	Integer	Current baserunners in a game (baseball) ex. `1,0,1` = runners on first base and third base
`delivery`	`sport_event_status`	Integer	Delivery number for a match (cricket)
`home_dismissals`	`sport_event_status`	Integer	Number of dismissals for the home team in the match (cricket)
`home_score`	`sport_event_status`	Integer	Total score for the home team in the match
`innings`	`sport_event_status`	Integer	Number of innings for a match (cricket)
`live`	`sport_event_status`	Boolean	Signifies live probabilities are available for a match when `true`
`match_status`	`sport_event_status`	String	Status 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`
`outs`	`sport_event_status`	Integer	Current number of outs for the game (baseball)
`over`	`sport_event_status`	Integer	Current over number for the match (cricket)
`position`	`sport_event_status`	Integer	Current yardline for the offensive team in a game (american football) ex. `58` (Opponent's 42 yardline)
`possession`	`sport_event_status`	Integer	Team with possession of the ball (american football) `1` (Home), `2` (Away)
`status`	`sport_event_status`	String	Status of a sport event ex. `not_started`, `live`, `ended`, `closed` See our FAQ for a complete list of statuses and their definitions.
`balls`	`sport_event_status`	Integer	Number of strikes for the current batter in a game (baseball)
`try`	`sport_event_status`	Integer	Current down number in a game (american football)
`winner_id`	`sport_event_status`	String	Unique ID of the match winner ex. `sr:competitor:44`
`yards`	`sport_event_status`	Integer	Current yards to go for a first down in a game (american football)

Venue

Attribute	Parent Element	Type	Description
`capacity`	`venue`	Integer	Capacity of a venue ex. `15000`
`city_name`	`venue`	String	City name of a venue ex. `Madrid`
`country_code`	`venue`	String	Country code of a venue ex. `ESP` (Spain)
`country_name`	`venue`	String	Country name of a venue ex. `Spain`
`id`	`venue`	String	Unique ID of a venue ex. `sr:venue:7000`
`map_coordinates`	`venue`	String	Coordinates of a venue ex. `40.423889,-3.671667`
`name`	`venue`	String	Name of a venue ex. `WiZink Center`
`timezone`	`venue`	String	Timezone of a venue ex. `Europe/Madrid`

Update Frequency

Working with Seasonal Probabilities

Pagination Note

Data Points

200200