Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Provides 2-way match win probabilities (home team win, away team win) for all matches in a given season.

⏱️

Update Frequency

60s Time To Live / Cache

📘

Pagination Note

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



Data Points

Match Probabilities:
AttributeParent ElementTypeDescription
namemarketStringProbability market
2way
namemarket - outcomeStringProbability market outcome
home_team_winner, away_team_winner
probabilitymarket - outcomeFloatProbability of the market outcome (home win, away win) in percentage
ex. 36.1
Category & Sport:
AttributeParent ElementTypeDescription
country_codesport_event_context - categoryStringCountry code for a sport event's category
idsport_event_context - categoryStringUnique category ID for a sport event
ex. sr:category:259 (International)
namesport_event_context - categoryStringName for a sport event's category
ex. International
idsport_event_context - sportStringUnique sport ID for a sport event
ex. sr:sport:31
namesport_event_context - sportStringName for a sport event's sport
ex. Badminton
Competition:
AttributeParent ElementTypeDescription
gendersport_event_context - competitionStringGender for a competition
ex. men, women, mixed
idsport_event_context - competitionStringUnique ID for a competition
ex. sr:competition:41728 (Ruichang China Masters, MS)
namesport_event_context - competitionStringName of a competition
ex. Ruichang China Masters, MS, Toyota Thailand Open, Doubles
parent_idsport_event_context - competitionStringUnique parent ID for a competition.
ex. sr:competition:41726 is used to group all Ruichang China Masters competitions.
typesport_event_context - competitionStringType of a competition
ex. singles, doubles, mixed_doubles
Groups:
AttributeParent ElementTypeDescription
idsport_event_context - groups - groupStringUnique ID for a sport event's group
ex. sr:cup:161825 (French Open 2024, MD)
namesport_event_context - groups - groupStringName of a sport event's group
ex. French Open 2024, MD
group_namesport_event_context - groups - groupStringAbbreviated name of a sport event's group
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:1751367
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 match's round
ex. quarterfinal or final
numbersport_event_context - roundIntegerNumber of a match's round
other_sport_event_idsport_event_context - roundStringA linked sport event ID, typically in a two-legged tie
ex. sr:sport_event:47395897
Season:
AttributeParent ElementTypeDescription
competition_idsport_event_context - seasonStringUnique ID for the competition a season belongs to
ex. sr:competition:559 (Olympic Tournament, Doubles)
disabledsport_event_context - seasonBooleanSignifies a season has been disabled when true
end_datesport_event_context - seasonDateEnd date of a season
ex. 2025-07-13
idseasonStringUnique ID for a season
ex. sr:season:119999 (Olympic Tournament, Doubles 2024)
namesport_event_context - seasonStringName of a season
ex. Olympic Tournament, Doubles 2024
start_datesport_event_context - seasonDateStart date of a season
ex. 2025-06-23
yearsport_event_context - seasonStringYear of a season
ex. 24/25 or 2024
Stages:
AttributeParent ElementTypeDescription
end_datesport_event_context - stageDateEnd date of a sport event's stage
ex. 2024-07-14
ordersport_event_context - stageIntegerOrder of a stage within a season
phaseName of a sport event's stage
ex. ms (men singles), md (men doubles), ws (women singles), wd (women doubles), xd (mixed doubles)

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

Competitors can be a player or a doubles team

AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name (singles or doubles)
ex. SHI (Shi, Yu Qi), LIW (Liang W K / Wang C)
countrycompetitors - competitorStringCountry of a competitor
ex. China
country_codecompetitors - competitorStringCountry code of a competitor
ex. CHN
date_of_birthcompetitor - competitorDateDate of birth of a competitor
ex. 1996-02-28
gendercompetitors - competitorStringGender for a competitor
male, female
idcompetitors - competitorStringUnique ID for a competitor
ex. sr:competitor:164376
namecompetitors - competitorStringName for a competitor (singles or doubles)
ex. Shi, Yu Qi, Liang W K / Wang C
qualifiercompetitors - competitorStringDesignation of a competitor for a match
home, away
virtualcompetitors - competitorBooleanSignifies a competitor is virtual when true. Used for placeholder players/teams in TBD vs TBD matchups.
Player:

Competitors will appear under a players node when part of a doubles competition.

AttributeParent ElementTypeDescription
abbreviationcompetitor - players - playerStringAbbreviation for a player name
ex. LIA (Liang, Wei Keng)
countrycompetitor - players - playerStringCountry of a competitor
ex. China
country_codecompetitor - players - playerStringCountry code of a competitor
ex. CHN
date_of_birthcompetitor - players - playerDateDate of birth of a player
ex. 1994-07-05
idcompetitor - players - playerStringUnique ID for a competitor
ex. sr:competitor:569895
namecompetitor - players - playerStringName for a competitor
ex. Liang, Wei Keng
Coverage Properties:
AttributeParent ElementTypeDescription
livesport_event - coverageStringSignifies a sport event is covered live when true
Sport Event:
AttributeParent ElementTypeDescription
idsport_eventStringUnique ID of a match
ex. sr:sport_event:50453019
replaced_bysport_eventStringAn alternative sport event ID if the match is postponed and played at a later date
ex. sr:sport_event:51847153
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 match
ex. 2024-03-26T20:00:00+00:00
start_time_confirmedsport_eventBooleanSignifies the start time of a match is confirmed when true
Venue:
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a venue
ex. 14820
changedvenueBooleanSignifies a venue has been changed when true
city_namevenueStringCity name of a venue
ex. Jakarta
country_codevenueStringCountry code of a venue
ex. IDN (England)
country_namevenueStringCountry name of a venue
ex. Indonesia
idvenueStringUnique ID of a venue
ex. sr:venue:76057
map_coordinatesvenueStringCoordinates of a venue
ex. 54.707924, 25.236942
namevenueStringName of a venue
ex. Court 1, Center Court, or Court 2
reduced_capacityvenueBooleanOptional attribute signifying a venue has a restricted capacity when true
reduced_capacity_maxvenueIntegerValue of a venue's restrictued capacity
timezonevenueStringTimezone of a venue
ex. Asia/Jakarta
Language
Credentials
Query
Click Try It! to start a request and see the response here!