## Odds Comparison Player Props API Overview
The Player Props API provides aggregated odds data for player props and player markets. Top US bookmakers are available, and return odds for NFL, NBA, MLB, NHL, 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 player props broken down by sport, league, and event.
API
API Version
Odds Comparison
Player Props
Note: Authentication is required for all API calls.
## Available Markets
See the table below for a complete breakdown of every player props market available.
Sport
Market Name
Market ID
Basketball (NBA)
total points (incl. overtime)
sr:market:921
total assists (incl. overtime)
sr:market:922
total rebounds (incl. overtime)
sr:market:923
total 3-point field goals (incl. overtime)
sr:market:924
total steals (incl. overtime)
sr:market:8000
total blocks (incl. overtime)
sr:market:8001
total turnovers (incl. overtime)
sr:market:8002
total points plus rebounds (incl. overtime)
sr:market:8003
total points plus assists (incl. overtime)
sr:market:8004
total rebounds plus assists (incl. overtime)
sr:market:8005
total points plus assists plus rebounds (incl. overtime)
sr:market:8006
total blocks plus steals (incl. overtime)
sr:market:8007
double double (incl. overtime)
sr:market:8008
triple double (incl. overtime)
sr:market:8009
Baseball
total pitcher strikeouts (incl. extra innings)
sr:market:925
total bases (incl. extra innings)
sr:market:926
total earned runs (incl. extra innings)
sr:market:928
total hits (incl. extra innings)
sr:market:9000
total runs (incl. extra innings)
sr:market:9001
total runs batted in (incl. extra innings)
sr:market:9002
total home runs (incl. extra innings)
sr:market:9003
total singles (incl. extra innings)
sr:market:9004
total doubles (incl. extra innings)
sr:market:9005
total triples (incl. extra innings)
sr:market:9006
total stolen bases (incl. extra innings)
sr:market:9007
total pitcher outs (incl. extra innings)
sr:market:9008
total total strikeouts (incl. extra innings)
sr:market:9009
total hits allowed (incl. extra innings)
sr:market:9010
total home runs allowed (incl. extra innings)
sr:market:9011
Ice Hockey (NHL)
first goalscorer
sr:market:38
last goalscorer
sr:market:39
anytime goalscorer
sr:market:40
total shots (incl. overtime)
sr:market:7000
total assists (incl. overtime)
sr:market:7001
total points (incl. overtime)
sr:market:7002
total power play points (incl. overtime)
sr:market:7003
American Football (NFL)
total passing yards (incl. overtime)
sr:market:914
total passing completions (incl. overtime)
sr:market:915
total passing touchdowns (incl. overtime)
sr:market:916
total carries (incl. overtime)
sr:market:917
total rushing yards (incl. overtime)
sr:market:918
total receiving yards (incl. overtime)
sr:market:919
total receptions (incl. overtime)
sr:market:920
total passing interceptions (incl. overtime)
sr:market:6000
total passing attempts (incl. overtime)
sr:market:6001
longest passing completion (incl. overtime)
sr:market:6002
total passing plus rushing yards (incl. overtime)
sr:market:6003
longest reception (incl. overtime)
sr:market:6004
total rushing plus receiving yards (incl. overtime)
sr:market:6005
longest rush (incl. overtime)
sr:market:6006
total kicking points (incl. overtime)
sr:market:6007
total extra points made (incl. overtime)
sr:market:6008
total field goals made (incl. overtime)
sr:market:6009
total assists (incl. overtime)
sr:market:6010
total tackles (incl. overtime)
sr:market:6011
total tackles plus assists (incl. overtime)
sr:market:6012
total sacks (incl. overtime)
sr:market:6013
first touchdown scorer
sr:market:6014
last touchdown scorer
sr:market:6015
anytime touchdown scorer
sr:market:6016
player to score 2 or more touchdowns
sr:market:6017
player to score 3 or more touchdowns
sr:market:6018
to record a sack (incl. overtime)
sr:market:6019
to record an interception (incl. overtime)
sr:market:6020
to throw an interception (incl. overtime)
sr:market:6021
Soccer
first goalscorer
sr:market:38
last goalscorer
sr:market:39
anytime goalscorer
sr:market:40
## Odds Comparison Player Props API Map
To best utilize the Odds Comparison Player Props 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 the player props 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 Player Props for your given date, using the Sport Id
Find the Sport Event Id of your event within the results
Call the Sport Event Player Props using your located Sport Event Id
>The player props for your event are displayed.
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, sports and stages.
Mapping feeds provide a list of IDs for players, competitions, sport events, teams, and stages which are mapped between US IDs and Sportradar 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
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-player-props/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-player-props/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-player-props/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-player-props/`{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 global and US id types.
TTL / Cache:
600 seconds
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-player-props/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-player-props/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-player-props/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-player-props/`{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 Player Props
Returns a list of player props for a given competition ID.
Note: Pagination will often be required to pull all data within this feed. By default, the feed will return 5 sport events.
TTL / Cache:
60 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Competitor Info Data Points:
Abbreviation Age Group Country Country Code Gender
Id Name Qualifier Rotation Number
Virtual Player Competitor Id Player Id Player Name
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-player-props/trial/v2/en/competitions/sr:competition:132/players_props.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-player-props/trial/v2/en/competitions/sr:competition:132/players_props.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-player-props/trial/v2/en/competitions/sr:competition:132/players_props.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Competition Player Props feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-player-props/`{access_level}`/`{version}`/`{language_code}`/competitions/`{competition_id}`/players_props.`{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-player-props/trial/v2/en/competitions/sr:competition:132/players_props.xml?api_key={your_api_key}&start=6&limit=5")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl -L GET 'api.sportradar.us/oddscomparison-player-props/trial/v2/en/competitions/sr:competition:132/players_props.xml?api_key={your_api_key}&start=6&limit=5'
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 5. Example: limit=5 |
Return to top
## Competitor Mappings
Provides competitor id mapping between global and US id types.
TTL / Cache:
600 seconds
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-player-props/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-player-props/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-player-props/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-player-props/`{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
## Daily Sport Player Props
Returns a list of player props for a specific date.
Note: Data will be removed from this endpoint 24 hours after the end of a day
TTL / Cache:
60 seconds
Note: Pagination will often be required to pull all data within this feed. By default, the feed will return 5 sport events.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-player-props/trial/v2/en/sports/sr:sport:3/schedules/2021-06-20/players_props.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-player-props/trial/v2/en/sports/sr:sport:3/schedules/2021-06-20/players_props.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-player-props/trial/v2/en/sports/sr:sport:3/schedules/2021-06-20/players_props.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Daily Sport Player Props feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-player-props/`{access_level}`/`{version}`/`{language_code}`/sports/`{sport_id}`/schedules/`{date}`/players_props.`{format}`?api_key=`{your_api_key}`&start=0&limit=5
| 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
### Query String Parameters
>Example including optional query string parameters:
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/oddscomparison-player-props/trial/v2/en/sports/sr:sport:3/schedules/2021-06-20/players_props.xml?api_key={your_api_key}&start=6&limit=5")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl -L GET 'api.sportradar.us/oddscomparison-player-props/trial/v2/en/sports/sr:sport:3/schedules/2021-06-20/players_props.xml?api_key={your_api_key}&start=6&limit=5'
In addition to the URL parameters listed above, you can paginate the response with one or more of the following optional query string parameters.
| Parameter | Description |
| --------- | ----------- |
| `start` | Number to start the list of results from. Example: start=1 |
| `limit` | Number to limit the number of results. Minimum value is 1, maximum value is 5. Example: limit=5 |
By default this feed returns 5 sport events, meaning pagination will often be required to obtain all games on a given day. To obtain the total number of events, reference the X-Max-Results field in the response header of an API call.
Example:
Request #1: curl -v https://api.sportradar.com/oddscomparison-player-props/trial/v2/en/sports/sr:sport:2/schedules/2022-12-02/players_props.xml?api_key={your_api_key}&start=0
Header Response Snippet:
x-plan-qps-allotted: 1x-plan-qps-current: 1x-plan-quota-allotted: 1000x-psalan-quota-current: 13cache-control: max-age=60, public, s-maxage=60etag: "f29670adaf74aff1b2ba903b155df67c"x-result: 5x-offset: 0x-max-results: 12age: 58
Note the above x-max-results value of 12, meaning there are 12 sport events scheduled for December 12th, 2022 for sr:sport:2 (Basketball).
Our first request obtained 5 events. We will then need to make 2 additional requests to obtain all 12.
Request #2: curl -v https://api.sportradar.com/oddscomparison-player-props/trial/v2/en/sports/sr:sport:2/schedules/2022-12-02/players_props.xml?api_key={your_api_key}&start=5
This second request will return sport events 5-9.
Request #3: curl -v https://api.sportradar.com/oddscomparison-player-props/trial/v2/en/sports/sr:sport:2/schedules/2022-12-02/players_props.xml?api_key={your_api_key}&start=10
This final request will return sport events 10-12.
Return to top
## Player Mappings
Provides player id mapping between global and US id types.
TTL / Cache:
600 seconds
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-player-props/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-player-props/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-player-props/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-player-props/`{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-player-props/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-player-props/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
## Player Props Change Log
Returns a list of the latest odds changes.
TTL / Cache:
1 second
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-player-props/trial/v2/en/players_props_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-player-props/trial/v2/en/players_props_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-player-props/trial/v2/en/players_props_changelog.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Player Props Change Log feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-player-props/`{access_level}`/`{version}`/`{language_code}`/players_props_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 Categories
Returns a list of categories for a sport ID that have odds available.
TTL / Cache:
300 seconds
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-player-props/trial/v2/en/sports/sr:sport:3/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-player-props/trial/v2/en/sports/sr:sport:3/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-player-props/trial/v2/en/sports/sr:sport:3/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-player-props/`{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
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-player-props/trial/v2/en/sports/sr:sport:1/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-player-props/trial/v2/en/sports/sr:sport:1/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-player-props/trial/v2/en/sports/sr:sport:1/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-player-props/`{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 global and US id types.
TTL / Cache:
600 seconds
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-player-props/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-player-props/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-player-props/trial/v2/en/sport_events/mappings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Sport Event Mapping feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-player-props/`{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-player-props/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-player-props/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 Player Props
Returns a list of player props for a given sport event ID.
TTL / Cache:
300 seconds
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-player-props/trial/v2/en/sport_events/sr:sport_event:27605772/players_props.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-player-props/trial/v2/en/sport_events/sr:sport_event:27605772/players_props.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-player-props/trial/v2/en/sport_events/sr:sport_event:27605772/players_props.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Sport Event Player Props feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-player-props/`{access_level}`/`{version}`/`{language_code}`/sport_events/`{sport_event_id}`/players_props.`{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. |
Return to top
## Sport Stages
Returns a list of stages and categories for a sport ID that have odds available.
TTL / Cache:
300 seconds
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-player-props/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-player-props/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-player-props/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-player-props/`{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
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-player-props/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-player-props/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-player-props/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-player-props/`{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 global and US id types.
TTL / Cache:
600 seconds
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.com/oddscomparison-player-props/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-player-props/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-player-props/trial/v2/en/stages/mappings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Stage Mapping feed by replacing the parameters in the following URL:
https://api.sportradar.us/oddscomparison-player-props/`{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-player-props/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-player-props/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: When we present date only values we present these in the ISO 8601 standard format.
Q: What format 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 bookmakers are included for Player Props?
A: Player Props data is available for the following Bookmakers - Draft Kings, William Hill, MGM, Pointsbet, FanDuel.
Q: How can I tell what Competitions have Player Props available?
A: Competitions that have Player Props data available from the last 24 hours and into the future are indicated by player_props="true" in 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: Is the Player Props data pre-match or live?
A: Currently Player Props data is all pre-match but we are looking to add live player props subject to data availability sometime in the future.
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 changelog?
A: The Changelog 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 "player_props_odds_change" attribute. This can be used to trigger calls to the Sport Event Players Props endpoint.
Q: What is the refresh rate of the Player Props 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.
