Sportradar ODDS COMPARISON feeds

Updated 10.17.17

1 SPORTRADAR ODDS COMPARISON FEEDS

Odds Comparison Feeds

2017

Updated 10.17.17


Table of Contents

Odds Comparison Statistics Feeds ......................................................................................................3

Language Support ..............................................................................................................................4

Category & Sport Information ...........................................................................................................5

Competitor Information ....................................................................................................................7

Tournament Information ...................................................................................................................8

Sport Event Information .................................................................................................................. 10

Book Information ............................................................................................................................ 11

Mapping Information ...................................................................................................................... 12

Market Information ......................................................................................................................... 13

Outcome Information ...................................................................................................................... 14

Outrights Information ..................................................................................................................... 15

Line Information ............................................................................................................................. 16

Venue Information .......................................................................................................................... 17

Frequently Asked Questions ............................................................................................................ 18

Document Change History .............................................................................................................. 22

Updated 10.17.17


Odds Comparison Statistics Feeds

We package our comprehensive odds collection into the following feeds, each focused on serving specific

information needs:

Books - Returns a list of configured bookmakers and their IDs.

Categories - Returns a list of categories where outrights exist.

Category Outrights – Returns a list of outrights, competitors and their odds for a given category ID.

Daily Sports Schedule – Returns a list of sport events for a given sport ID and date that have odds available.

Player Mapping – Returns a paginated list of player IDs mapped between US IDs and Sportradar IDs.

Season Mapping - Returns a list of seasons IDs mapped between US IDs and Sportradar IDs.

Sport Categories – Returns a list of categories for a sport ID that have outrights available.

Sport Event Change Log - Returns a list of sport events where odds have changed including changed odds

values and possible sport event changes.

Sport Event Mapping – Returns a paginated list of sport event IDs mapped between US IDs and Sportradar IDs.

Sport Event Markets - Returns a list of markets and odds for a given match ID where odds exist. Additionally

returns deep-links for each market outcome in the rest of world package and returns consensus lines and picks

for each sport event in US package.

Sport Tournaments - Returns a list of tournaments for a given sport ID that have schedules available.

Sports – Returns a list of sports and sport IDs.

Team Mapping – Returns a list of team IDs mapped between US IDs and Sportradar IDs.

Tournament Mapping – Returns a list of tournament IDs mapped between US IDs and Sportradar IDs.

Tournament Schedule - Returns a list of scheduled sport events by tournament.

Tournaments - Returns a list of tournaments and their IDs.

Venue Mapping – Returns a list of venue IDs mapped between US IDs and Sportradar IDs.

Updated 10.17.17


Language Support We provide support for a large set of languages. The language support primarily affects names of players, teams,

tournaments etc. Different languages are obtained through different endpoints where the only difference is the language

part of the path. The language part is any valid ISO-646 language code. For languages we don’t provide specific translations

for we return back the names in English.

Code Language it Italian

en English

de German

fr French

se Swedish

es Spanish

ru Russian

zh Chinese (simplified)

zht Chinese (traditional)

ja Japanese

hr Croatian

tr Turkish

sk Slovak

sl Slovenian

no Norwegian

da Danish

nl Dutch

pl Polish

pt Portuguese

cs Czech

fi Finnish

th Thai

hu Hungarian

bg Bulgarian

ek Greek

ro Romanian

ukr Ukrainian

et Estonian

lv Latvian

bs Bosnian

sr Serbian

ml Macedonian

lt Lithuanian

id Indonesian

vi Vietnamese

ko Korean

aa Arabic

aze Azerbaijan

ka Georgian

heb Hebrew

kaz Kazakh

sqi Albanian

br Brazilian Portuguese

Updated 10.17.17


Category & Sport Information

Stat Feeds Element Attribute Format

Category Country Code

Categories

category country_code String

Category Outrights

Daily Sports Schedule

Sport Categories

Sport Event Change Log

Sport Event Markets

Sport Tournaments

Tournament Schedule

Tournaments

Category Id

Categories

category id Id

Category Outrights


Sport Categories


Sport Event Markets

Sport Tournaments

Tournament Schedule

Tournaments

Category Name

Categories

category name String

Category Outrights


Sport Categories


Sport Event Markets

Sport Tournaments

Tournament Schedule

Tournaments

Category Outrights Categories

category outrights Boolean Sport Categories

Category Sport Id Categories

category sport_id GUID Sport Categories

Sport Id

Category Outrights

sport id Id


Sport Categories


Sport Event Markets

Sport Tournaments

Sports

Tournament Schedule

Tournaments

Sport Name

Category Outrights

sport name String Daily Sports Schedule

Sport Categories


srl Serbian Latin

Updated 10.17.17


Sport Event Markets

Sport Tournaments

Sports

Tournament Schedule

Tournaments

Updated 10.17.17


Competitor Information


Competitor Abbreviation

Category Outrights

competitor abbreviation String



Sport Event Markets

Tournament Schedule

Competitor Country

Category Outrights

competitor country String



Sport Event Markets

Tournament Schedule

Competitor Country Code

Category Outrights

competitor country_code String



Sport Event Markets

Tournament Schedule

Competitor Id

Category Outrights

competitor id Id



Sport Event Markets

Tournament Schedule

Competitor Name

Category Outrights

competitor name String



Sport Event Markets

Tournament Schedule

Competitor Qualifier


competitor qualifier String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Competitor Rotation Number


competitor rotation_number Integer Sport Event Change Log

Sport Event Markets

Tournament Schedule

Updated 10.17.17


Tournament Information Stat Feeds Element Attribute Format

Current Season End Date Sport Tournaments

current_season end_date Date/Time Tournaments

Current Season Id Sport Tournaments

current_season id Id Tournaments

Current Season Name Sport Tournaments

current_season name String Tournaments

Current Season Start Date Sport Tournaments

current_season start_date Date/Time Tournaments

Current Season Year Sport Tournaments

current_season year String Tournaments

Season End Date


season end_date Date/Time Sport Event Change Log

Sport Event Markets

Tournament Schedule

Season Id


season id Id Sport Event Change Log

Sport Event Markets

Tournament Schedule

Season Name


season name String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Season Start Date


season start_date Date/Time Sport Event Change Log

Sport Event Markets

Tournament Schedule

Season Tournament Id


season tournament_id Id Sport Event Change Log

Sport Event Markets

Tournament Schedule

Season Year


season year String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Tournament Id


tournament id Id


Sport Event Markets

Sport Tournaments

Tournament Schedule

Tournaments

Tournament Name


tournament name String


Sport Event Markets

Sport Tournaments

Tournament Schedule

Tournaments

Tournament Round - Cup Round

Match Number


tournament_round cup_round_match_number Integer Sport Event Change Log

Sport Event Markets

Tournament Schedule

Updated 10.17.17


Tournament Round - Cup Round

Matches


tournament_round cup_round_matches Integer Sport Event Change Log

Sport Event Markets

Tournament Schedule

Tournament Round - Group


tournament_round group String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Tournament Round - Name


tournament_round name String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Tournament Round - Number


tournament_round number Integer Sport Event Change Log

Sport Event Markets

Tournament Schedule

Tournament Round - Type


tournament_round type String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Tournament Round – Other Match

Id


tournament_round other_match_id GUID Sport Event Change Log

Sport Event Markets

Tournament Schedule

Updated 10.17.17


Sport Event Information


Sport Event Id


sport_event id Id Sport Event Change Log

Sport Event Markets

Tournament Schedule

Sport Event Scheduled Date/Time


sport_event scheduled Date/Time Sport Event Change Log

Sport Event Markets

Tournament Schedule

Sport Event Start Time to be Determined


sport_event start_time_tbd Boolean Sport Event Change Log

Sport Event Markets

Tournament Schedule

Sport Event Status


sport_event status String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Updated 10.17.17


Book Information


Book Id

Books

book id Id

Category Outrights



Sport Event Markets

Tournament Schedule

Book Name Books book name String

Book Odds Category Outrights book odds String

Book Removed

Category Outrights

book removed Boolean



Sport Event Markets

Tournament Schedule

Updated 10.17.17


Mapping Information


Player SR Id Player Mapping mapping id GUID

Player US Id Player Mapping mapping us_id GUID

Season SR Id Season Mapping mapping id GUID

Season US Id Season Mapping mapping us_id GUID

Sport Event SR Id Sport Event Mapping mapping id GUID

Sport Event US Id Sport Event Mapping mapping us_id GUID

Team SR Id Team Mapping mapping id GUID

Team US Id Team Mapping mapping us_id GUID

Tournament SR Id Tournament Mapping mapping id GUID

Tournament US Id Tournament Mapping mapping us_id GUID

Venue SR Id Venue Mapping mapping id GUID

Venue US Id Venue Mapping mapping us_id GUID

Updated 10.17.17


Market Information


Market Group Name


market group_name String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Market Name


market name String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Markets Last Updated


markets last_updated String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Updated 10.17.17


Outcome Information


Back Odds


outcome back_odds String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Back Odds Max


outcome back_max String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Back Odds Spread


outcome back_spread String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Deep Link


outcome deep_link String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Handicap


outcome handicap String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Lay Odds


outcome lay_odds String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Lay Odds Max


outcome lay_max String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Lay Odds Spread


outcome lay_spread String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Odds


outcome odds String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Percentage


outcome percentage String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Spread


outcome spread String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Total


outcome total String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Type Daily Sports Schedule outcome type String

Updated 10.17.17



Sport Event Markets

Tournament Schedule

Outrights Information


Outright End Date Category Outrights outright end_date String

Outright Id Category Outrights outright id Id

Outright Name Category Outrights outright name String

Outright Start Date Category Outrights outright start_date Date

Outright Tournament Id Category Outrights outright tournament_id Id

Updated 10.17.17


Line Information


Line Name Sport Event Markets line name String

Line Spread Sport Event Markets line spread String

Line Total Sport Event Markets line total String

Updated 10.17.17


Venue Information


Capacity


venue capacity Integer Sport Event Change Log

Sport Event Markets

Tournament Schedule

City Name


venue city_name String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Country Name


venue country String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Country Code


venue country_code String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Map Coordinates


venue map_coordinates String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Name


venue name String Sport Event Change Log

Sport Event Markets

Tournament Schedule

Venue Id


venue id GUID Sport Event Change Log

Sport Event Markets

Tournament Schedule

Updated 10.17.17


Frequently Asked Questions

Q: How are the date time fields presented?

A: All of our Date/Time attributes are in either UTC (ISO-8601) or Unix Time (Epoch Time).

UTC Example: 2013-04-03T18:15:00+00:00

Unix Example: 1505844490

For more information:

https://en.wikipedia.org/wiki/ISO_8601

https://en.wikipedia.org/wiki/Unix_time

Q: What is the Date format?

A: When we present date only values we present these in the ISO 8601 standard format.

ex: 2013-04-03

We use these for attributes that have date and no time (such as birthdate). For more information:


Q: What time zone are the date time fields presented in?

A: All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.

ex: 2013-04-03T18:15:00+00:00

For more information: https://en.wikipedia.org/wiki/ISO_8601

Q: What sports are covered?

A: The sports coverage varies depending on configured bookmakers offering in that particular point in time. To get

a list of available sports call the Sports endpoint.

Q: What tournaments are covered?

A: The tournament coverage varies depending on configured bookmakers offering in that particular point in time.

To get a list of all the tournaments call the Tournaments endpoint. Alternatively you may call the Sports

Tournaments endpoint to get a list of all the tournaments for a given sport.

Q: Does it have live odds?

A: No, it only contains pre-match odds data.

Q: How frequently are the odds updated?

A: Update frequency varies between different bookmakers. The API checks for odds changes every 60 seconds and

updates them as soon as changes are found in our system. Note that we will not update the "last_updated" timestamp

if there are no odds changes found when running the check.


https://en.wikipedia.org/wiki/Unix_time



Updated 10.17.17


Updated 10.17.17


Q: What endpoint should be used to retrieve odds?

A: There are several endpoints through which you can retrieve odds - their usage depends on the particular use

case.

• Tournament Schedule - returns a list of scheduled sport events and main markets for a given

tournament ID. To get a list of all tournaments call the Tournaments or Sports Tournaments endpoint.

• Sport Schedule - returns a list of scheduled sport events and main markets for a given sport ID and

date. To get a list of all sports call the Sports endpoint.

• Sport Event Markets - returns all available markets for a given match ID. To get a list of sport events

call the Tournament Schedule or Sport Schedule endpoints.

• Category Outrights - returns a list of outrights, outright competitors and their winning odds for a given

category ID. To get a list of all the categories containing outright odds, call the Sport Categories

endpoint.

• Sport Events Change Log - returns a list of all the sport events where odds have changed including

changed odds values and possible sport event changes.

Q: How do you retrieve all possible results from the mapping feeds?

A: The mapping feeds have a limit of 30,000 results per page. To get additional results you need to use the optional

query string parameters “start” and “limit”. Optional query string parameters must be added after your API key with

an ampersand (&).

For example: https://api.sportradar.us/oddscomparison-

rowt1/en/eu/sport_events/id_mappings.xml?api_key={your_api_key}&start=30000&limit=30000

Q: How do you indicate when a bookmaker withdraws a match odds or outright competitor odds?

A: Removed markets are indicated with "removed" flag as shown below

<

<<market name="total" group_name="regular">

<book id="sr:book:988" removed="true"/>

<</market>

Q: How do I use the change log endpoint?

A: The Sport Event Change Log endpoint returns a list of all the sport events where odds have changed including

the changed odds values. It takes a Unix timestamp in UTC as a URL input parameter and must be between current

UTC time -15min and current UTC time. To avoid empty responses it's suggested to request this endpoint with

regular frequency that should not be less than 60 seconds and should be few seconds smaller than Unix timestamp

not to miss any odds changes and to account for the document generation time.

ex: Requesting Sport Event Change Log endpoint every 110 seconds with Unix timestamp of current UTC time - 120

seconds.

This endpoint also displays newly published matches, removed markets, and possible match scheduled time and

status changes. It will not include matches and/or markets where odds values have remained unchanged.

Updated 10.17.17


Q: What markets are currently available?

A: Only main markets (2way, 3way, total, spread, handicap, and asian handicap), exchange odds, and outright odds

are currently available. Special bet markets will become available later in 2018.

Q: What is an Outright?

A. Outrights (also known as Futures) are a flexible odds type that covers any variety of events where you have two

or more competitors trying to win the same event. The event does not even have to be a physical match of any kind

for instance: “Who will win the Formula 1 Drivers Championship this year?” for which there is a long list of

competitors, each with their odds for winning this outright.

Q: What is a consensus line?

A: Consensus line is the most balanced line, calculated from the primary lines from configured bookmakers. There

are three consensus lines that we calculate (Spread, Total and Moneyline). Each of these will display information

about the opening and the current consensus line.

Consensus lines are available across all sports but their presence depends on availability of primary lines from

configured bookmakers – for instance when none of the configured bookmakers is offering “Spread” odds for a

particular match, the opening and current consensus spread line will not be present.

Consensus lines are sport-dependent, which means that for Soccer the Moneyline is calculated based on 3way odds

and will have three outcomes for home, draw and away odds. In the case of Basketball the Moneyline is calculated

based on 2way odds and will have only two outcomes for home and away odds.

Consensus spread line in Ice Hockey is generally known as the “puck line” and in Baseball it’s known as the “run

line”. In the API it will be named accordingly.

Q: What is a consensus pick?

A: Consensus pick shows a percentage of bets placed on each side of the primary line. Having primary line odds

does not automatically guarantee that a pick will be present. Consensus picks are included when Sportradar has

information about bets being placed on specific primary line

Updated 10.17.17


Document Change History

Date Section Change

10/17/2017

FAQ Added FAQ question to address paginated results from mapping feeds.

Mapping Information Added mapping information for players, seasons, sport events, teams, tournaments,

and venues.

03/13/2017 All Document creation

Documents

Sportradar ODDS COMPARISON feeds