OC Regular Overview

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

❗️
Version Upgrade
Odds Comparison Regular is no longer the current version for global odds.
Upgrade to our Odds Comparison Core product now for increased coverage. See documentation here.

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.

Odds Comparison Regular v1 Schema

MCP Server

The Sportradar Odds Comparison Regular MCP Server is a Model Context Protocol (MCP) implementation that bridges AI assistants directly to our OC Regular API feeds. It allows LLMs to use standardized tools to fetch our sports data, helping to power your applications, assist in coding, and streamlining your integration.

For detailed instructions on how to set up and use this integration, visit our MCP Server documentation.