Table of Contents

---

Getting Started

Coverage

What sports are covered?

The sports coverage varies depending on what configured bookmakers are offering in that particular point in time. To get a list of available sports call the Sports endpoint.

What competitions are covered?

The competition coverage varies depending on what configured bookmakers are offering in that particular point in time. To get a list of all the competitions for a sport call the Sport Competitions endpoint.

Confirming which competitions carry props, via the player_props flag, is step 1 of Retrieving Player Props in the Odds Comparison Integration Guide.

Is the Player Props data pre-match or live?

The Player Props API serves pre-match player props. In-play player props are served by the Odds Comparison Live Odds API through its Sport Event Player Props feed, with lines that move as the game unfolds.

Tracking Live Odds in the Odds Comparison Integration Guide shows live player props beside a live game board.

How can I tell what Competitions have Player Props available?

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.

Retrieving Player Props in the Odds Comparison Integration Guide starts from this flag and walks through to a full props board.

---

Integration

How do I use the Change Log endpoint?

Player Props 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 player_props_odds_change attribute. This can be used to trigger calls to the Sport Event Players Props endpoint.

Monitoring Odds Changes in the Odds Comparison Integration Guide builds the full change-log polling loop for both the Prematch and Player Props packages.

How can I find the values for various enum data points within the API?

For the most up-to-date values, please see the Schema section of the OpenAPI specification here.

What format are date fields presented in?

Date values are presented in the ISO 8601 standard format.

Timestamp fields are in UTC. These could include scheduled start times or play-by-play event timestamps. Examples: scheduled="2024-02-11T23:30:00+00:00", created_at="2024-02-11T23:43:20+00:00"

Date-only fields reflect local league convention and are not UTC-adjusted. These could include season start dates and birth dates. Examples: start_date="2024-08-16", date_of_birth="1984-09-22"

Timestamps across the API are covered on API Basics in the Odds Comparison Integration Guide.

How do I locate the TTL (Time to Live)/cache on an API endpoint?

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

Every feed's TTL, with recommended polling cadences and the bookmaker price refresh cycle per package, is charted on Update Frequencies in the Odds Comparison Integration Guide.

Back to top ↑

---

Odds Data

Bookmakers

What bookmakers are included for Player Props?

Player Props data is available for the following bookmakers:

• DraftKings
• William Hill
• MGM
• PointsBet
• FanDuel

What happens if a bookmaker suspends/removes a market or outcome?

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.

Handling suspended props, including an empty props list for a started or completed event, is covered on Retrieving Player Props in the Odds Comparison Integration Guide.

---

Odds Availability

What is the refresh rate of the Player Props data?

We check for changes to the data every 60 seconds.

The refresh cycle for each package sits beside the TTL chart on Update Frequencies in the Odds Comparison Integration Guide.

Are consensus lines available?

We strive to provide consensus lines as much as possible in the Player Props API, but they are not guaranteed to be present for any sport or competition.

Why do some outcomes show nonsensical odds?

If an outcome is flagged as removed="true" and is displaying decimal odds of 1.00, then 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.

The removed lifecycle at book and outcome level is explained on Odds Comparison Fundamentals in the Odds Comparison Integration Guide.

---

Closing Lines

How do I tell what the closing odds/line was?

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.

Pulling Prematch Odds in the Odds Comparison Integration Guide shows the retained prices read as closing lines.

---

Mapping

What is the best method to map IDs from the Odds Comparison API to other Sportradar APIs?

The Mapping API is the recommended solution for linking entity IDs across Sportradar products. It supports mapping for competitions, competitors, players, seasons, and sport events, and is designed to scale across multiple APIs without the need to paginate through large feeds.

If you need to map IDs specifically within the Odds Comparison API, dedicated Mapping feeds are also available. These feeds provide ID mappings for players, competitions, sport events, teams, and stages between General Sport IDs and League Specific IDs.

ID Handling in the Odds Comparison Integration Guide walks through joining props to player data in the League Specific APIs, and the Mapping API Integration Guide covers the entity-level lookups.

Why would a player ID (ex. sr:player:830531) appear more than once in the Player Mappings endpoint?

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 UFL APIs.

Repeated mapping entries per player are explained on ID Handling in the Odds Comparison Integration Guide.

---

Back to top ↑

---

---