Browse by category below. Select any group or question to jump straight to it. Use your browser's find (Ctrl/Cmd + F) to search the page.
Table of Contents
Getting Started
Coverage
What sports are covered?
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.
Possible sports in the Core package can be viewed here.
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.
Integration
How can I access Odds Comparison Core?
OC Core is an expanded package which must be configured at the API key level. Reach out to your account representative or Sportradar Support to trial.
How can I find what access I have, OC US or OC Core?
Each OC API response returns an X-Origin-Id header that identifies the bookmaker pipeline your key is configured for:
X-Origin-Id Value | Access Level |
|---|---|
MARKET_ORIGIN_CORE_CRAWLERS | OC Core Key |
MARKET_ORIGIN_MAGIC_CRAWLERS | OC US Key |
Are IDs consistent between OC US and OC Core?
All bookmaker IDs and event IDs are consistent across pipelines.
Futures IDs can differ depending on mapping.
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 sections of the OpenAPI specifications 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
Odds Data
Bookmakers
What bookmakers are included?
140+ bookmakers are available in OC Core. Reach out to Sportradar Support for configuration.
Request the Books endpoint to view all configured bookmakers on your key.
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
Are consensus lines available?
For OCv2 Core, consensus must be explicitly configured by Sportradar Support.
Consensus is calculated as the median of a selection of strong bookmakers, and based on the pipeline being used.
What is the event lifecycle?
Events appear when odds become available. Event odds are removed 2 weeks after the event.
What if a bookmaker has no odds?
The event can still appear in our endpoints, but no odds will be shown for that bookmaker.
A 400 response may also be returned in some no-odds scenarios.
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.
More questions?Reach out to [email protected] for further assistance.