Upload
others
View
1
Download
0
Embed Size (px)
Citation preview
Updated 10.17.17
1 SPORTRADAR ODDS COMPARISON FEEDS
Odds Comparison Feeds
2017
Updated 10.17.17
2 SPORTRADAR ODDS COMPARISON FEEDS
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
3 SPORTRADAR ODDS COMPARISON FEEDS
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
4 SPORTRADAR ODDS COMPARISON FEEDS
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
5 SPORTRADAR ODDS COMPARISON FEEDS
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
Daily Sports Schedule
Sport Categories
Sport Event Change Log
Sport Event Markets
Sport Tournaments
Tournament Schedule
Tournaments
Category Name
Categories
category name String
Category Outrights
Daily Sports Schedule
Sport Categories
Sport Event Change Log
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
Daily Sports Schedule
Sport Categories
Sport Event Change Log
Sport Event Markets
Sport Tournaments
Sports
Tournament Schedule
Tournaments
Sport Name
Category Outrights
sport name String Daily Sports Schedule
Sport Categories
Sport Event Change Log
srl Serbian Latin
Updated 10.17.17
6 SPORTRADAR ODDS COMPARISON FEEDS
Sport Event Markets
Sport Tournaments
Sports
Tournament Schedule
Tournaments
Updated 10.17.17
7 SPORTRADAR ODDS COMPARISON FEEDS
Competitor Information
Stat Feeds Element Attribute Format
Competitor Abbreviation
Category Outrights
competitor abbreviation String
Daily Sports Schedule
Sport Event Change Log
Sport Event Markets
Tournament Schedule
Competitor Country
Category Outrights
competitor country String
Daily Sports Schedule
Sport Event Change Log
Sport Event Markets
Tournament Schedule
Competitor Country Code
Category Outrights
competitor country_code String
Daily Sports Schedule
Sport Event Change Log
Sport Event Markets
Tournament Schedule
Competitor Id
Category Outrights
competitor id Id
Daily Sports Schedule
Sport Event Change Log
Sport Event Markets
Tournament Schedule
Competitor Name
Category Outrights
competitor name String
Daily Sports Schedule
Sport Event Change Log
Sport Event Markets
Tournament Schedule
Competitor Qualifier
Daily Sports Schedule
competitor qualifier String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Competitor Rotation Number
Daily Sports Schedule
competitor rotation_number Integer Sport Event Change Log
Sport Event Markets
Tournament Schedule
Updated 10.17.17
8 SPORTRADAR ODDS COMPARISON FEEDS
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
Daily Sports Schedule
season end_date Date/Time Sport Event Change Log
Sport Event Markets
Tournament Schedule
Season Id
Daily Sports Schedule
season id Id Sport Event Change Log
Sport Event Markets
Tournament Schedule
Season Name
Daily Sports Schedule
season name String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Season Start Date
Daily Sports Schedule
season start_date Date/Time Sport Event Change Log
Sport Event Markets
Tournament Schedule
Season Tournament Id
Daily Sports Schedule
season tournament_id Id Sport Event Change Log
Sport Event Markets
Tournament Schedule
Season Year
Daily Sports Schedule
season year String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Tournament Id
Daily Sports Schedule
tournament id Id
Sport Event Change Log
Sport Event Markets
Sport Tournaments
Tournament Schedule
Tournaments
Tournament Name
Daily Sports Schedule
tournament name String
Sport Event Change Log
Sport Event Markets
Sport Tournaments
Tournament Schedule
Tournaments
Tournament Round - Cup Round
Match Number
Daily Sports Schedule
tournament_round cup_round_match_number Integer Sport Event Change Log
Sport Event Markets
Tournament Schedule
Updated 10.17.17
9 SPORTRADAR ODDS COMPARISON FEEDS
Tournament Round - Cup Round
Matches
Daily Sports Schedule
tournament_round cup_round_matches Integer Sport Event Change Log
Sport Event Markets
Tournament Schedule
Tournament Round - Group
Daily Sports Schedule
tournament_round group String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Tournament Round - Name
Daily Sports Schedule
tournament_round name String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Tournament Round - Number
Daily Sports Schedule
tournament_round number Integer Sport Event Change Log
Sport Event Markets
Tournament Schedule
Tournament Round - Type
Daily Sports Schedule
tournament_round type String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Tournament Round – Other Match
Id
Daily Sports Schedule
tournament_round other_match_id GUID Sport Event Change Log
Sport Event Markets
Tournament Schedule
Updated 10.17.17
10 SPORTRADAR ODDS COMPARISON FEEDS
Sport Event Information
Stat Feeds Element Attribute Format
Sport Event Id
Daily Sports Schedule
sport_event id Id Sport Event Change Log
Sport Event Markets
Tournament Schedule
Sport Event Scheduled Date/Time
Daily Sports Schedule
sport_event scheduled Date/Time Sport Event Change Log
Sport Event Markets
Tournament Schedule
Sport Event Start Time to be Determined
Daily Sports Schedule
sport_event start_time_tbd Boolean Sport Event Change Log
Sport Event Markets
Tournament Schedule
Sport Event Status
Daily Sports Schedule
sport_event status String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Updated 10.17.17
11 SPORTRADAR ODDS COMPARISON FEEDS
Book Information
Stat Feeds Element Attribute Format
Book Id
Books
book id Id
Category Outrights
Daily Sports Schedule
Sport Event Change Log
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
Daily Sports Schedule
Sport Event Change Log
Sport Event Markets
Tournament Schedule
Updated 10.17.17
12 SPORTRADAR ODDS COMPARISON FEEDS
Mapping Information
Stat Feeds Element Attribute Format
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
13 SPORTRADAR ODDS COMPARISON FEEDS
Market Information
Stat Feeds Element Attribute Format
Market Group Name
Daily Sports Schedule
market group_name String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Market Name
Daily Sports Schedule
market name String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Markets Last Updated
Daily Sports Schedule
markets last_updated String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Updated 10.17.17
14 SPORTRADAR ODDS COMPARISON FEEDS
Outcome Information
Stat Feeds Element Attribute Format
Back Odds
Daily Sports Schedule
outcome back_odds String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Back Odds Max
Daily Sports Schedule
outcome back_max String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Back Odds Spread
Daily Sports Schedule
outcome back_spread String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Deep Link
Daily Sports Schedule
outcome deep_link String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Handicap
Daily Sports Schedule
outcome handicap String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Lay Odds
Daily Sports Schedule
outcome lay_odds String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Lay Odds Max
Daily Sports Schedule
outcome lay_max String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Lay Odds Spread
Daily Sports Schedule
outcome lay_spread String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Odds
Daily Sports Schedule
outcome odds String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Percentage
Daily Sports Schedule
outcome percentage String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Spread
Daily Sports Schedule
outcome spread String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Total
Daily Sports Schedule
outcome total String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Type Daily Sports Schedule outcome type String
Updated 10.17.17
15 SPORTRADAR ODDS COMPARISON FEEDS
Sport Event Change Log
Sport Event Markets
Tournament Schedule
Outrights Information
Stat Feeds Element Attribute Format
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
16 SPORTRADAR ODDS COMPARISON FEEDS
Line Information
Stat Feeds Element Attribute Format
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
17 SPORTRADAR ODDS COMPARISON FEEDS
Venue Information
Stat Feeds Element Attribute Format
Capacity
Daily Sports Schedule
venue capacity Integer Sport Event Change Log
Sport Event Markets
Tournament Schedule
City Name
Daily Sports Schedule
venue city_name String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Country Name
Daily Sports Schedule
venue country String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Country Code
Daily Sports Schedule
venue country_code String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Map Coordinates
Daily Sports Schedule
venue map_coordinates String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Name
Daily Sports Schedule
venue name String Sport Event Change Log
Sport Event Markets
Tournament Schedule
Venue Id
Daily Sports Schedule
venue id GUID Sport Event Change Log
Sport Event Markets
Tournament Schedule
Updated 10.17.17
18 SPORTRADAR ODDS COMPARISON FEEDS
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:
https://en.wikipedia.org/wiki/ISO_8601
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.
Updated 10.17.17
19 SPORTRADAR ODDS COMPARISON FEEDS
Updated 10.17.17
20 SPORTRADAR ODDS COMPARISON FEEDS
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
21 SPORTRADAR ODDS COMPARISON FEEDS
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
22 SPORTRADAR ODDS COMPARISON FEEDS
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