OC Prematch Overview

Introduction

The Prematch API provides aggregated odds data for a wide variety of pre-match betting markets. Top US bookmakers are available, and return odds for NFL, NBA, MLB, NHL, NCAA Men's Basketball and top soccer leagues.

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 a huge selection of pre-match markets broken down by sport, league, and event.

🗝️

Authentication is required for all API calls.

---

API Map

To best utilize the Odds Comparison Prematch 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 require only a Sport parameter, 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, competitions and stages.

Mapping feeds provide a list of IDs for players, competitions, sport events, teams, and stages which are mapped between General Sport IDs and League Specific 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. 

Competition Mappings – Provides competition ID mapping between League Specific and General Sport ID types. 

Competition Schedules – Provides scheduling info for all events with odds available in a given competition.

Competitor Mappings – Provides competitor ID mapping between League Specific and General Sport ID types. 

Daily Schedules – Provides scheduling info for all events with odds available on a given sport and date.

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

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

Sport Competitions – Returns a list of competitions for a sport ID that have odds available. 

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

Sport Event Markets – Returns a list of markets for a given sport event.

Sport Event Markets Change Log – Returns a list of sport events with odds changes in the last 5 minutes.

Sport Stages – Returns a list of stages and categories for a sport ID that have odds available. 

Sports – Returns a list of sports and sport IDs. 

Stage Mappings – Provides stage ID mapping between League Specific and General Sport ID types.

---

Data Retrieval Sample

To find 3-way prematch odds for a sport event on a given day:

1. Call the Sports resource and make note of the Sport Id for your event
2. Call the Daily Sport Event Markets for your given date, using the Sport Id
3. Find the Sport Event Id of your event within the results
4. Call the Sport Event Markets using your located Sport Event Id
5. The prematch odds for your event are displayed
6. Find the "1x2" market within the results

---

What's Included?

Bookmakers

Sports/Leagues

Markets

---

Integration Links

OpenAPI Spec

Our Odds Comparison Prematch API is available via OpenAPI. Click below to view and/or download the specs.

Odds Comparison Prematch v2 OpenAPI

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Odds Comparison Prematch 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 Prematch API XSD schema.

Odds Comparison Prematch v2 Schema