FAQs

Categories

.

Coverage

What sports are covered?

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.

What competitions are covered?

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.

Odds Availability

What is the refresh rate of the Prematch data?

We check for changes to the data every 60 seconds.

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.

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.

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.

Mapping

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

Integration

How do I use the Change Log endpoint?

Sport Event Markets 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 Markets endpoint.

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?

When we present date only values we present these in the ISO 8601 standard format.

ex: 2013-04-03

We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/ISO_8601

What format are the date/time fields presented in?

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

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

🙋

More questions?

Reach out to [email protected] for further assistance.