Categories

Coverage
Odds Availability
Integration

Bookmakers
Mapping
Pagination

.

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.

What markets are available?

All in-game markets which bookmakers make available in the Prematch and Player Props packages will be available in the Live Odds game endpoints.

Currently we guarantee that Moneyline, Spread and Total will be available.

Bookmakers

What bookmakers are included?

Request the Books endpoint for a complete list of your available bookmakers. Current bookmakers are:

MGM
DraftKings
FanDuel
Consensus
SugarHouseNJ
PointsBet
WilliamHillNewJersey
FoxBetNewJersey

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.

Odds Availability

What is the refresh rate of the Live Odds data?

We check for changes to the data every 15-30 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.

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 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"

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

Pagination

How do I access all games in the Competition Player Props or Daily Player Props endpoints?

The Competition Player Props and Daily Player Props endpoints return one (1) sport_event per request.

Reference the x-max-results header to locate the number of sport events available for each, then make additional requests using the start parameter to obtain each available event.

In the below Competition Player Props response, the header specifies 1 sport event is returned (x-result), but 15 sport events are available (x-max-results). Make additional API requests – appending &start=1, &start=2, etc. to the end of your call – to obtain additional events.

Response Header Sample
< HTTP/2 200 
< content-type: application/xml
< content-length: 517078
< date: Tue, 11 Feb 2025 19:04:27 GMT
< x-amzn-requestid: 28294a6b-3a7f-4c71-87c1-6feecec8b02d
< x-offset: 0
< x-amz-apigw-id: F1XRQGH1liAEKgQ=
< cache-control: no-cache, private
< x-result: 1
< etag: "e128f66ea2b55555e7923e0f863b3b29"
< x-max-results: 15
< x-amzn-trace-id: Root=1-67ab9f3a-56e9db0b3d7122cb23aa65fc
< x-amzn-remapped-date: Tue, 11 Feb 2025 19:04:27 GMT
< vary: Accept-Encoding
< x-cache: Miss from cloudfront