## Odds Comparison Prematch API Overview
The Prematch API provides aggregated odds data for a wide variety of pre-match betting markets. Top US bookmakers are available, and return odds for NFL, NBA, MLB, NHL, NCAA Men's Basketball and top soccer leagues.
The API is consistent in structure, format, and behavior with the other General Sport APIs. Primary feeds will return books, categories, sports, and tournaments offered.
Additional feeds provide a huge selection of pre-match markets broken down by sport, league, and event.
API
API Version
Odds Comparison
Prematch
Note: Authentication is required for all API calls.
## Odds Comparison Prematch API Map
To best utilize the Odds Comparison Prematch API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.
>
Example:
>To find 3-way prematch odds for a sport event on a given day:
>
Call the Sports resource and make note of the Sport Id for your event
Call the Daily Sport Event Markets for your given date, using the Sport Id
Find the Sport Event Id of your event within the results
Call the Sport Event Markets using your located Sport Event Id
The prematch odds for your event are displayed
Find the "1x2" market within the results
Primary feeds require only a Sport parameter, while other feeds may require dates, IDs or other human-readable parameters to identify the category, sport, sport event or tournament that the feed will describe. The primary feeds provide IDs for categories, competitions and stages.
Mapping feeds provide a list of IDs for players, competitions, sport events, teams, and stages which are mapped between General Sport IDs and League Specific IDs. 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” which are detailed in the affected feeds below.
## Books
Returns a list of configured bookmakers and their IDs.
TTL / Cache:
300 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Market & Book Info Data Points:
Book Id
Book Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/books.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/books.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/books.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Books feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-prematch/`{access_level}`/`{version}`/`{language_code}`/books.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v2). |
| `language_code` | Supported Locales |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to top
## Competition Mappings
Provides competition ID mapping between League Specific and General Sport ID types.
TTL / Cache:
600 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Mapping Info Data Points:
External Id
Id
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/competitions/mappings.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/competitions/mappings.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/competitions/mappings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Competition Mappings feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-prematch/`{access_level}`/`{version}`/`{language_code}`/competitions/mappings.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v2). |
| `language_code` | Supported Locales |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to top
## Competition Schedules
Provides scheduling info for all events with odds available in a given competition.
Note: Data will be removed from this endpoint 24 hours after the end of a day
Note: Pagination will often be required to pull all data within this feed. By default, the feed will return 200 events.
TTL / Cache:
1 second
Update Frequency:
As Necessary
Content Type:
XML or JSON
Competitor & Player Info Data Points:
Competitor Abbreviation Competitor Age Group Competitor Country Competitor Country Code
Competitor Gender Competitor Id Competitor Name
Competitor Qualifier Competitor Rotation Number Competitor Virtual
Sport Event Info Data Points:
Sport Event Id Sport Event Replaced By
Sport Event Resume Time Sport Event Start Time
Sport Event Start Time Confirmed
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/competitions/sr:competition:109/schedules.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/competitions/sr:competition:109/schedules.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/competitions/sr:competition:109/schedules.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Competition Schedules feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-prematch/`{access_level}`/`{version}`/`{language_code}`/competitions/`{competition_id}`/schedules.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v2). |
| `language_code` | Supported Locales |
| `competition_id` | Id of a given competition. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to top
### Optional Query String Parameters
>Example including optional query string parameters:
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/competitions/sr:competition:109/schedules.xml?api_key={your_api_key}&start=0&limit=50")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl -L GET 'api.sportradar.us/oddscomparison-prematch/trial/v2/en/competitions/sr:competition:109/schedules.xml?api_key={your_api_key}&start=0&limit=50'
In addition to the URL parameters listed above, you can paginate the market information with one or more of the following optional query string parameters.
Note: Optional query string parameters must be added after your API key with an ampersand (&).
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `start` | Number to start the list of results from. Example: start=0 |
| `limit` | Number to limit the number of results. Minimum value is 1, maximum value is 200. Example: limit=50 |
Return to top
## Competitor Mappings
Provides competitor ID mapping between League Specific and General Sport ID types.
TTL / Cache:
600 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Mapping Info Data Points:
External Id
Id
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/competitors/mappings.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/competitors/mappings.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/competitors/mappings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Competitor Mappings feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-prematch/`{access_level}`/`{version}`/`{language_code}`/competitors/mappings.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v2). |
| `language_code` | Supported Locales |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to top
### Optional Query String Parameters
>Example including optional query string parameters:
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/competitors/mappings.xml?api_key={your_api_key}&start=0&limit=1000")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl -L GET 'api.sportradar.us/oddscomparison-prematch/trial/v2/en/competitors/mappings.xml?api_key={your_api_key}&start=0&limit=1000'
In addition to the URL parameters listed above, you can paginate the competitor information with one or more of the following optional query string parameters.
Note: Optional query string parameters must be added after your API key with an ampersand (&).
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `start` | Number to start the list of results from. Example: start=0 |
| `limit` | Number to limit the number of results. Minimum value is 1, maximum value is 1000. Example: limit=1000 |
Return to top
## Daily Schedules
Provides scheduling info for all events with odds available on a given sport and date.
Note: Pagination will often be required to pull all data within this feed. By default, the feed will return 200 events.
TTL / Cache:
1 second
Update Frequency:
As Necessary
Content Type:
XML or JSON
Competitor & Player Info Data Points:
Competitor Abbreviation Competitor Age Group Competitor Country Competitor Country Code
Competitor Gender Competitor Id Competitor Name
Competitor Qualifier Competitor Rotation Number Competitor Virtual
Sport Event Info Data Points:
Sport Event Id Sport Event Replaced By
Sport Event Resume Time Sport Event Start Time
Sport Event Start Time Confirmed
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sports/sr:sport:1/schedules/2023-03-31/schedules.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/sports/sr:sport:2/schedules/2023-03-31/schedules.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sports/sr:sport:2/schedules/2023-03-31/schedules.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Daily Sport Event Schedules feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-prematch/`{access_level}`/`{version}`/`{language_code}`/sports/`{sport_id}`/schedules/`{date}`/schedules.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v2). |
| `language_code` | Supported Locales |
| `sport_id` | ID of a given sport. |
| `date` | Date in the following format: YYYY-MM-DD |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to top
### Optional Query String Parameters
>Example including optional query string parameters:
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/sports/sr:sport:2/schedules/2023-03-31/schedules.xml?api_key={your_api_key}&start=0&limit=50")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl -L GET 'api.sportradar.us/oddscomparison-prematch/trial/v2/en/sports/sr:sport:2/schedules/2023-03-31/schedules.xml?api_key={your_api_key}&start=0&limit=50'
In addition to the URL parameters listed above, you can paginate the market information with one or more of the following optional query string parameters.
Note: Optional query string parameters must be added after your API key with an ampersand (&).
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `start` | Number to start the list of results from. Example: start=0 |
| `limit` | Number to limit the number of results. Minimum value is 1, maximum value is 200. Example: limit=50 |
| `live` | Boolean value to return live/non-live markets Example: live=true or live=false |
Return to top
## Player Mappings
Provides player ID mapping between League Specific and General Sport ID types.
TTL / Cache:
600 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Mapping Info Data Points:
External Id
Id
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/players/mappings.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/players/mappings.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/players/mappings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Player Mappings feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-prematch/`{access_level}`/`{version}`/`{language_code}`/players/mappings.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v2). |
| `language_code` | Supported Locales |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
### Optional Query String Parameters
>Example including optional query string parameters:
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/players/mappings.xml?api_key={your_api_key}&start=0&limit=1000")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl -L GET 'api.sportradar.us/oddscomparison-prematch/trial/v2/en/players/mappings.xml?api_key={your_api_key}&start=0&limit=1000'
In addition to the URL parameters listed above, you can paginate the player information with one or more of the following optional query string parameters.
Note: Optional query string parameters must be added after your API key with an ampersand (&).
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `start` | Number to start the list of results from. Example: start=0 |
| `limit` | Number to limit the number of results. Minimum value is 1, maximum value is 1000. Example: limit=1000 |
Return to top
## Sport Categories
Returns a list of categories for a sport ID that have odds available.
TTL / Cache:
300 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Category & Sport Info Data Points:
Category Country Code
Category Id
Category Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sports/sr:sport:2/categories.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/sports/sr:sport:2/categories.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sports/sr:sport:2/categories.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Sport Categories feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-prematch/`{access_level}`/`{version}`/`{language_code}`/sports/`{sport_id}`/categories.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v2). |
| `language_code` | Supported Locales |
| `sport_id` | ID of a given sport. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to top
## Sport Competitions
Returns a list of competitions for a sport ID that have odds available.
TTL / Cache:
300 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Category & Sport Info Data Points:
Category Country Code
Category Id
Category Name
Competition Info Data Points:
Competition Futures Competition Gender Competition Id
Competition Markets Competition Name
Competition Player Props
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sports/sr:sport:2/competitions.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/sports/sr:sport:2/competitions.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sports/sr:sport:2/competitions.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Sport Competitions feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-prematch/`{access_level}`/`{version}`/`{language_code}`/sports/`{sport_id}`/competitions.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v2). |
| `language_code` | Supported Locales |
| `sport_id` | ID of a given sport. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to top
## Sport Event Mappings
Provides sport event ID mapping between League Specific and General Sport ID types.
TTL / Cache:
600 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Mapping Info Data Points:
External Id
Id
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sport_events/mappings.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/sport_events/mappings.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sport_events/mappings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Sport Event Mappings feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-prematch/`{access_level}`/`{version}`/`{language_code}`/sport_events/mappings.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v2). |
| `language_code` | Supported Locales |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
### Optional Query String Parameters
>Example including optional query string parameters:
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/sport_events/mappings.xml?api_key={your_api_key}&start=0&limit=1000")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl -L GET 'api.sportradar.us/oddscomparison-prematch/trial/v2/en/sport_events/mappings.xml?api_key={your_api_key}&start=0&limit=1000'
In addition to the URL parameters listed above, you can paginate the sport event information with one or more of the following optional query string parameters.
Note: Optional query string parameters must be added after your API key with an ampersand (&).
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `start` | Number to start the list of results from. Example: start=0 |
| `limit` | Number to limit the number of results. Minimum value is 1, maximum value is 1000. Example: limit=1000 |
Return to top
## Sport Event Markets
Returns a list of markets for a given sport event.
TTL / Cache:
1 second
Update Frequency:
As Necessary
Content Type:
XML or JSON
Competitor & Player Info Data Points:
Competitor Abbreviation Competitor Age Group Competitor Country Competitor Country Code
Competitor Gender Competitor Id Competitor Name
Competitor Qualifier Competitor Rotation Number Competitor Virtual
Sport Event Info Data Points:
Sport Event Id Sport Event Replaced By
Sport Event Resume Time Sport Event Start Time
Sport Event Start Time Confirmed
Market & Book Info Data Points:
Book External Market Id Book External Sport Event Id
Book Id Book Name Book Removed
Market Id Market Is Live Market Name
Outcome Info Data Points:
External Outcome Id Field Id Handicap Outcome Id Odds - American Odds - Decimal Odds - Fraction
Open Handicap Open Odds - American Open Odds - Decimal Open Odds - Fraction Open Spread Open Total
Player Id Player Name Removed Spread Total Trend Type
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sport_events/sr:sport_event:27751520/sport_event_markets.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/sport_events/sr:sport_event:27751520/sport_event_markets.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sport_events/sr:sport_event:27751520/sport_event_markets.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Sport Event Markets feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-prematch/`{access_level}`/`{version}`/`{language_code}`/sport_events/`{sport_event_id}`/sport_event_markets.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v2). |
| `language_code` | Supported Locales |
| `sport_event_id` | ID of a given sport event. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
### Optional Query String Parameters
>Example including optional query string parameters:
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/sport_events/sr:sport_event:27751520/sport_event_markets.xml?api_key={your_api_key}&live=true")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl -L GET 'api.sportradar.us/oddscomparison-prematch/trial/v2/en/sport_events/sr:sport_event:27751520/sport_event_markets.xml?api_key={your_api_key}&live=true'
In addition to the URL parameters listed above, you can limit the returned information to live/non-live markets.
Note: Optional query string parameters must be added after your API key with an ampersand (&).
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `live` | Boolean value to return live/non-live markets Example: live=true or live=false |
Return to top
## Sport Event Markets Change Log
Returns a list of sport events with odds changes in the last 5 minutes.
TTL / Cache:
1 second
Update Frequency:
As Necessary
Content Type:
XML or JSON
Change Log Info Data Points:
Change Id Change Type
Sport Event Markets Odds Change
Status From Status To
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sport_event_markets_changelog.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/sport_event_markets_changelog.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sport_event_markets_changelog.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Sport Event Markets Change Log feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-prematch/`{access_level}`/`{version}`/`{language_code}`/sport_event_markets_changelog.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v2). |
| `language_code` | Supported Locales |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to top
## Sport Stages
Returns a list of stages and categories for a sport ID that have odds available.
TTL / Cache:
300 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Category & Sport Info Data Points:
Category Country Code
Category Id
Category Name
Competition Info Data Points:
Stage Id Stage Description
Stage Scheduled
Stage Scheduled End
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sports/sr:sport:9/stages.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/sports/sr:sport:9/stages.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sports/sr:sport:9/stages.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Sport Stages feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-prematch/`{access_level}`/`{version}`/`{language_code}`/sports/`{sport_id}`/stages.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v2). |
| `language_code` | Supported Locales |
| `sport_id` | ID of a given sport. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to top
## Sports
Returns a list of sports and sport IDs.
TTL / Cache:
300 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Category & Sport Info Data Points:
Sport Id
Sport Name
Sport Type
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sports.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/sports.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/sports.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Sports feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-prematch/`{access_level}`/`{version}`/`{language_code}`/sports.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v2). |
| `language_code` | Supported Locales |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to top
## Stage Mappings
Provides stage ID mapping between League Specific and General Sport ID types.
TTL / Cache:
600 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Mapping Info Data Points:
External Id
Id
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/stages/mappings.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/stages/mappings.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.com/oddscomparison-prematch/trial/v2/en/stages/mappings.xml?api_key={your_api_key}"
```
Access the Stage Mapping feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-prematch/`{access_level}`/`{version}`/`{language_code}`/stages/mappings.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v2). |
| `language_code` | Supported Locales |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
### Optional Query String Parameters
>Example including optional query string parameters:
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-prematch/trial/v2/en/stages/mappings.xml?api_key={your_api_key}&start=0&limit=1000")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl -L GET 'api.sportradar.us/oddscomparison-prematch/trial/v2/en/stages/mappings.xml?api_key={your_api_key}&start=0&limit=1000'
In addition to the URL parameters listed above, you can paginate the sport event information with one or more of the following optional query string parameters.
Note: Optional query string parameters must be added after your API key with an ampersand (&).
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `start` | Number to start the list of results from. Example: start=0 |
| `limit` | Number to limit the number of results. Minimum value is 1, maximum value is 1000. Example: limit=1000 |
Return to top
## Frequently Asked Questions
Q: What format are date fields presented in?
A: We present date only values in the ISO 8601 standard format.
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: How can I find the values for various enum data points within the API?
A: For the most up-to-date values, please see the Schema section of the OpenAPI specification here:
A: Odds are removed from all endpoints after 24 hours of their completion. This will include competition and sport event information.
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 competitions are covered?
A: The competition coverage varies depending on configured bookmakers offering in that particular point in time. To get a list of all the competitions for a sport call the Sport Competitions endpoint.
Q: What happens if a bookmaker suspends/removes a market or outcome?
A: Markets that have been suspended/removed are indicated as removed="true" at the book level. Outcomes that have been suspended/removed are indicated by removed="true" at the outcome level.
Q: How do I tell what the closing odds/line was?
A: When a game goes live and the pre-match markets have been removed by the bookmaker, we add a removed="true" attribute at the book level and continue to display the last known odds which can be interpreted as the closing line.
Q: Why do some outcomes show nonsensical odds?
A: If an outcome is flagged as removed="true" and is displaying decimal odds of 1.00 then that means that the selection was never offered for betting by the bookmaker. This will often happen on "under" selections where the bookmaker does not want to offer the "under" side of the bet.
Q: How do I use the change log?
A: The change log will display a list of Sport Event IDs which have changed in the last 5 minutes using Unix timestamps. The actual time of the odds change is denoted by the "sport_event_markets_odds_change" attribute. This can be used to trigger calls to the Sport Event Markets endpoint.
Q: What is the refresh rate of the Prematch data?
A: We check for changes to the data every 60 seconds.
Q: Why would a player ID (ex. sr:player:830531) appear more than once in the Player Mappings endpoint?
A: A player may appear in multiple APIs with a separate ID unique to that API. For example, multiple ID mapping entries could occur from the American Football API to the NFL, NCAA Men’s Football, or USFL APIs.
Q: How do I locate the TTL (Time to Live)/cache on an API endpoint?
A: The cache (in seconds) can be accessed in the returned header information on each RESTful API call, under cache-control.
ex. cache-control: max-age=1, public, s-maxage=1 or cache-control: public, must-revalidate, max-age=120
## Books
Returns a list of configured bookmakers and their IDs.
