Docs
Coverage MatrixDocumentationRelease LogLog In

OC Regular Overview

Get started with Odds Comparison Regular API v1

Introduction

The Odds Comparison API provides aggregated odds data for pre-match, outrights, and consensus lines.

The API is consistent in structure, format, and behavior with the other General Sport APIs. Primary feeds will return books, categories, sports, and tournaments offered.

Additional feeds provide an array of supplementary odds breakdowns, including:

  • Daily schedules
  • Outrights by category
  • ID mapping

🗝️

Authentication is required for all API calls.

Available Markets

See below for all available markets within this API.

Odds Type IdMarket Name
12way
23way
3total
4spread
4run_line
5handicap
5asian_handicap
100first_team_to_score
1021x2_half_time
103both_teams_to_score
104first_team_to_get_corner
106correct_score
107ht_ft (Halftime Fulltime)
108odd_even_goals
109double_chance
110draw_no_bet

API Map

To best utilize the Odds Comparison API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.

Primary feeds don't require any parameters, while other feeds may require dates, IDs or other human-readable parameters to identify the category, sport, sport event or tournament that the feed will describe. The primary feeds provide IDs for categories, sports and tournaments. Note that unix_timestamp (used in Sport Event Change Log) is not human readable parameter.

Mapping feeds provide a list of IDs for players, seasons, sport events, teams, tournaments, and venues which are mapped between US IDs and Sportradar IDs. The mapping feeds have a limit of 30,000 results per page. To get additional results you need to use the optional query string parameters “start” and “limit” which are detailed in the affected feeds below.


Endpoint Descriptions

Books - Returns a list of configured bookmakers and their IDs.

Categories - Returns a list of categories where outrights exist.

Category Outrights – Returns a list of outrights, competitors and their odds for a given category ID.

Daily Sport Schedule – Returns a list of sport events for a given sport ID and date that have odds available.

Player Mapping – Provides player ID mapping between League Specific and General Sport ID types.

Season Mapping - Provides season ID mapping between League Specific and General Sport ID types.

Sport Categories – Returns a list of categories for a sport ID that have outrights available.

Sport Event Change Log - Returns a list of sport events where odds have changed including changed odds values and possible sport event changes.

Sport Event Mapping – Provides sport event ID mapping between League Specific and General Sport ID types.

Sport Event Markets - Returns a list of markets and odds for a given match ID where odds exist.

Sport Tournaments - Returns a list of tournaments for a given sport ID that have schedules available.

Sports – Returns a list of sports and sport IDs.

Team Mapping – Provides team ID mapping between League Specific and General Sport ID types.

Tournament Mapping – Provides tournament ID mapping between League Specific and General Sport ID types.

Tournament Schedule - Returns a list of scheduled sport events by tournament.

Tournaments - Returns a list of tournaments and their IDs.

Venue Mapping – Provides venue ID mapping between League Specific and General Sport ID types.


Data Retrieval Samples

To find the Category Outright odds for Estonia:

  1. Call the Categories endpoint and find Estonia
  2. Take note of the "category - id"
  3. Call the Category Outrights endpoint using the category id.

The outright odds for Estonia are displayed.


Integration Links

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Odds Comparison Regular API collection.

Feel free to follow and/or fork any collections to receive updates.

Schema Download

Open the zip file below to access our entire Odds Comparison Regular API XSD schema.

Odds Comparison Regular v2 Schema