Odds Comparison Player Props
| API | API Version |
| Odds Comparison | Player Props |
|
|
| Note: Authentication is required for all API calls. |
| Note: Optional query string parameters must be added after your API key with an ampersand (&). |
Example: start=0 | | `limit` | Number to limit the number of results. Minimum value is 1, maximum value is 1000.
Example: limit=1000 | ## Player Prop Change Log ```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}" ``` This endpoint retrieves the Player Prop Change Log. https://api.sportradar.us/oddscomparison-player-props/`{access_level}`/`{version}`/`{language_code}`/players_props_changelog.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. | ## Sport Categories ```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}" ``` This endpoint retrieves the Categories by Sport. https://api.sportradar.us/oddscomparison-player-props/`{access_level}`/`{version}`/`{language_code}`/sports/`{sport_id}`/categories.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. | ## Sport Competitions ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/oddscomparison-player-props/trial/v2/en/sports/sr:sport:3/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:3/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:3/competitions.xml?api_key={your_api_key}" ``` This endpoint retrieves the Competitions by Sport. https://api.sportradar.us/oddscomparison-player-props/`{access_level}`/`{version}`/`{language_code}`/sports/`{sport_id}`/competitions.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. | ## Sport Event Mappings ```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}" ``` This endpoint retrieves Sport Event Mapping information. https://api.sportradar.us/oddscomparison-player-props/`{access_level}`/`{version}`/`{language_code}`/sport_events/mappings.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("http://api.sportradar.us/oddscomparison-player-props/trial/v2/en/sport_events/mappings.xml?api_key={your_api_key}&start=0&limit=1000") 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}&start=0&limit=1000") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell 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 (&). |
Example: start=0 | | `limit` | Number to limit the number of results. Minimum value is 1, maximum value is 1000.
Example: limit=1000 | ## Sport Event Player Props ```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}" ``` This endpoint retrieves the Sport Event Player Props. 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}` Replace placeholders with the following query parameters: | 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. | ## Sport Stages ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/oddscomparison-player-props/trial/v2/en/sports/sr:sport:3/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:3/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:3/stages.xml?api_key={your_api_key}" ``` This endpoint retrieves the Stages by Sport. https://api.sportradar.us/oddscomparison-player-props/`{access_level}`/`{version}`/`{language_code}`/sports/`{sport_id}`/stages.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. | ## Sports ```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}" ``` This endpoint retrieves the list of Sports. https://api.sportradar.us/oddscomparison-player-props/`{access_level}`/`{version}`/`{language_code}`/sports.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. | ## Stage Mappings ```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}" ``` This endpoint retrieves Stage Mapping information. https://api.sportradar.us/oddscomparison-player-props/`{access_level}`/`{version}`/`{language_code}`/stages/mappings.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("http://api.sportradar.us/oddscomparison-player-props/trial/v2/en/stages/mappings.xml?api_key={your_api_key}&start=0&limit=1000") 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}&start=0&limit=1000") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell 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 (&). |
Example: start=0 | | `limit` | Number to limit the number of results. Minimum value is 1, maximum value is 1000.
Example: limit=1000 | ## 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.
Example: 2013-04-03
For more information: https://en.wikipedia.org/wiki/ISO_8601
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: 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 7 days 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
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.
Return to topDocs Navigation
- Documentation
- Football (Soccer)
- American Football
- Australian Rules Football
- Baseball
- Basketball
- Combat Sports
- Cricket
- Editorial Content
- eSports
- Golf
- Handball
- Hockey
- Images
- Insights
- Core Insights
- Betting Insights
- Odds
- Racing
- Rugby
- Tennis
- Baseline Sports Coverage
- Badminton v2
- Badminton v1
- Bandy v1
- Curling v1
- Cycling v2
- Cycling v1
- Darts v2
- Darts v1
- Floorball v1
- Futsal v1
- Horse Racing v2
- Lacrosse v1
- Pesapallo v1
- Snooker v2
- Snooker v1
- Squash v1
- Table Tennis v2
- Volleyball (Beach) v2
- Volleyball (Beach) v1
- Volleyball (Indoor) v2
- Volleyball (Indoor) v1
- Waterpolo v1
- Winter Sports v1
