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 Id | Market Name |
| 1 | 2way |
| 2 | 3way |
| 3 | total |
| 4 | spread |
| 4 | run_line |
| 5 | handicap |
| 5 | asian_handicap |
| 100 | first_team_to_score |
| 102 | 1x2_half_time |
| 103 | both_teams_to_score |
| 104 | first_team_to_get_corner |
| 106 | correct_score |
| 107 | ht_ft (Halftime Fulltime) |
| 108 | odd_even_goals |
| 109 | double_chance |
| 110 | draw_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:
- Call the Categories endpoint and find Estonia
- Take note of the "category - id"
- 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.