Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Sport Event Markets

Returns a list of markets and odds for a given match.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

60s Time To Live / Cache


Data Points

Books
AttributeParent ElementTypeDescription
idmarket - bookGUIDUnique ID of a sportsbook for a market

ex. sr:book:18186
namemarket - bookStringName of a sportsbook for a market

ex. FanDuel
removedmarket - bookStringSignifies a book market has been removed when true
Sport & Category
AttributeParent ElementTypeDescription
country_codesport_event - tournament - categoryStringCountry code of a category for a sport event

ex. USA (USA, MLB)
idsport_event - tournament - categoryGUIDUnique ID of a category for a sport event

ex. sr:category:16 (MLB)
namesport_event - tournament - categoryStringName of a category for a sport event

ex. USA
id(sport_event - tournament) - sportGUIDUnique ID of a sport

ex. sr:sport:3 (Baseball)
name(sport_event - tournament) - sportStringName of a sport

ex. Baseball
Competitor

Competitors may be teams or players. Each will appear with unique competitor IDs (sr:competitor:xxxx).

AttributeParent ElementTypeDescription
abbreviationsport_event - competitors - competitorStringAbbreviated name of a competitor

ex. LOS (Los Angeles Dodgers) or HAA (Haaland, Erling Braut)
countrysport_event - competitors - competitorStringCountry name of a competitor

ex. USA
countrysport_event - competitors - competitorStringCountry code of a competitor

ex. USA
idsport_event - competitors - competitorStringUnique SR ID of a competitor

ex. sr:competitor:3638

Click here for more info on Sportradar IDs
namesport_event - competitors - competitorStringName of a competitor

ex. Los Angeles Dodgers or Haaland, Erling Braut
qualifiersport_event - competitors - competitorStringSignifies a competitor as the home or away team

ex. home, away
rotation_numbersport_event - competitors - competitorIntegerRotation number of a competitor bet

ex. 930
uuidssport_event - competitors - competitorStringUnique UUID(s) of a competitor

ex. ef64da7f-cfaf-4300-87b0-9313386b977c

Click here for more info on Sportradar IDs
Season
AttributeParent ElementTypeDescription
end_datesport_event - seasonDateEnd date of a sport event's season

ex. 2024-11-03
idsport_event - seasonUIDUnique SR ID of a sport event's season

ex. sr:season:112588

Click here for more info on Sportradar IDs
namesport_event - seasonStringName of a sport event's season

ex. MLB 2024
start_datesport_event - seasonDateStart date of a sport event's season

ex. 2024-03-20
tournament_idsport_event - seasonUIDUnique SR ID of a sport event's season tournament

ex. sr:tournament:109

Click here for more info on Sportradar IDs
tournament_uuidssport_event - seasonStringUnique UUID of a sport event's season tournament(s)

ex. 2ea6efe7-2e21-4f29-80a2-0a24ad1f5f85,2fa448bc-fc17-4d3d-be03-e60e080fdc26

Click here for more info on Sportradar IDs
uuidssport_event - seasonStringUnique UUID(s) of a sport event's season

ex. 6a5c278f-ebce-41f9-b1ba-2160b6af04ce,f23888ed-6ca7-45bf-99e1-24b7393f540c

Click here for more info on Sportradar IDs
yearsport_event - seasonIntegerYear of a sport event's season

ex. 2024
Tournament
AttributeParent ElementTypeDescription
idsport_event - tournamentUIDUnique SR ID of a sport event's tournament

ex. sr:tournament:109

Click here for more info on Sportradar IDs
namesport_event - tournamentStringName of a sport event's tournament

ex. MLB
typesport_event - tournamentStringType of a sport event's tournament
uuidssport_event - tournamentStringUnique UUID(s) of a sport event's tournament

ex. 2ea6efe7-2e21-4f29-80a2-0a24ad1f5f85,2fa448bc-fc17-4d3d-be03-e60e080fdc26

Click here for more info on Sportradar IDs
Tournament Round
AttributeParent ElementTypeDescription
cup_round_match_numbersport_event - tournament_roundIntegerRound match number of a sport event's tournament round
cup_round_matchessport_event - tournament_roundIntegerNumber of matches in a sport event's tournament round
groupsport_event - tournament_roundStringGroup name of a sport event's tournament round

ex. Pacific League
namesport_event - tournament_roundStringName of a sport event's tournament round

ex. semifinal, round_of_16
numbersport_event - tournament_roundIntegerRound number of a sport event's tournament round
other_match_idsport_event - tournament_roundUIDA linked sport event ID, typically in a two-legged tie

ex. sr:sport_event:47395897
phasesport_event - tournament_roundStringPhase of a sport event's tournament round

ex. regular season
tournament_match_numbersport_event - tournament_roundIntegerTournament match number of a sport event's tournament round
typesport_event - tournament_roundStringType of a sport event's tournament round

ex. cup, group
Sport Event
AttributeParent ElementTypeDescription
idsport_eventStringUnique SR ID of a sport event

ex. sr:sport_event:47395897
replaced_bysport_eventStringAn alternative sport event ID if the match is postponed and played at a later date

ex. sr:sport_event:47395897
scheduledsport_eventDateScheduled start time of a sport event

ex. 2024-03-26T20:00:00+00:00
start_time_tbdsport_eventBooleanSignifies the start time of a sport event is TBD (to be determined) when true
statussport_eventStringStatus of a sport event

ex. not_started,closed, live
uuidssport_eventStringUnique UUID(s) of a sport event

ex. f644dde6-39cc-434f-8758-18da232dc4ec

Click here for more info on Sportradar IDs
Market
AttributeParent ElementTypeDescription
group_namemarkets - marketStringGroup name of a market

ex. regular
namemarkets - marketStringName of a market. Click here for a complete list of available markets and their IDs

ex. 2way, 3way, total, run_line, handicap, asian_handicap, first_team_to_score, 1x2_half_time
odds_type_idmarkets - marketIntegerID for a type of market
last_updatedmarketsDateTimestamp of the last update to markets

ex. 2024-08-29T03:10:12+00:00
Market Outcome
AttributeParent ElementTypeDescription
handicapmarket - book - outcomeStringHandicap value of a book outcome. Used for handicap and asian_handciap markets

ex. -1 (home) and 1 (away) or -1.5 (home) and 1.5 (away)
oddsmarket - book - outcomeStringOdds value of a book outcome

ex. -105 (us), 1.952 (eu), 119/125 (uk)
odds_field_idmarket - book - outcomeIntegerIdentifier for the ouctome type

ex. 1 & 2 for home & away. 3, 4, & 5 for home, draw, & away
odds_trendmarket - book - outcomeStringOdds trending value of a book outcome

ex. down, up
opening_oddsmarket - book - outcomeStringOpening odds value of a book outcome

ex. -105 (us), 1.952 (eu), 119/125 (uk)
opening_spreadmarket - book - outcomeNumberOpening spread line of a book outcome

ex. -1.5 (Baseball runs), -17 (Football points)
opening_totalmarket - book - outcomeNumberOpening total line of a book outcome

ex. 8.5 (Baseball runs), -65.5 (Football points)
spreadmarket - book - outcomeStringSpread line of a book outcome

ex. -1.5 (Baseball runs), -17 (Football points)
totalmarket - book - outcomeStringTotal line of a book outcome

ex. 8.5 (Baseball runs), -65.5 (Football points)
typemarket - book - outcomeStringType of bet placements on a book outcome

ex. home or away
Consensus Bet Percentage
AttributeParent ElementTypeDescription
nameconsensus - bet_percentage_outcomes - marketStringName of a bet percentage market.

ex. moneyline, run_line, total, spread
percentageconsensus - bet_percentage_outcomes - market - outcomeNumberPercentage of bet placements on a market outcome

ex. 47 (home) & 53 (away)
typeconsensus - bet_percentage_outcomes - market - outcomeStringType of bet placements on a market outcome

ex. home or away
Consensus Lines
AttributeParent ElementTypeDescription
nameconsensus - lines - lineStringName of a consensus line market.

ex. moneyline_current, moneyline_open, run_line_current, run_line_open, total_current, total_open, asian_handicap_current, asian_handicap_open
handicapconsensus - lines - lineStringHandicap value of a consensus line outcome. Used for handicap and asian_handciap markets

ex. -1 or 1
spreadconsensus - lines - lineStringSpread line of a consensus line outcome

ex. -1.5 (Baseball runs), -17 (Football points)
totalconsensus - lines - lineNumberTotal line of a consensus line outcome

ex. 8.5 (Baseball runs), -65.5 (Football points)
oddsconsensus - lines - line - outcomeStringOdds value of bet placements on a consensus line outcome

ex. -105 (us), 1.952 (eu), 119/125 (uk)
totalconsensus - lines - line - outcomeNumberTotal line of a consensus line outcome

ex. 8.5 (Baseball runs), -65.5 (Football points)
typeconsensus - lines - line - outcomeStringType of bet placements on a consensus line outcome

ex. home or away
Venue
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a venue

ex. 60000
city_namevenueStringCity name of a venue

ex. Liverpool
country_codevenueStringCountry code of a venue

ex. ENG (England)
country_namevenueStringCountry name of a venue

ex. England
idvenueStringUnique ID of a venue

ex. sr:venue:579
map_coordinatesvenueStringCoordinates of a venue

ex. 53.430622,-2.960919
namevenueStringName of a venue

ex. Anfield
uuidsvenueStringUnique UUID of a venue

ex. f3690068-b967-4335-9182-69c3554f8de2

Click here for more info on Sportradar IDs
Path Params
string
enum
required
Defaults to us

Odds package type, with configured bookmakers prominent in either the US or global markets

us (United States), row (Rest of World)

Allowed:
string
enum
required
Defaults to t

The access level of your API key

t (Trial), p (Production)

Allowed:
string
required
Defaults to en

2-letter code for supported languages

en (English)

English is the only fully supported language for this API. Click here for valid language codes and a tabular list of available languages per competition.

string
enum
required
Defaults to us

Odds type in 2-letter format

us (American), uk (Fractional), eu (Decimal)

Allowed:
string
required
Defaults to sr:sport_event:60574971

Unique Id of a sport event

Example: sr:sport_event:56930759

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json