Get started with Odds Comparison Futures API v2
Introduction
The Futures API provides aggregated odds data for a wide variety of futures (or outrights) markets. All major leagues are available, with top US bookmakers configured.
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 futures markets broken down by category, competition, and stage.
Authentication is required for all API calls.
API Map
To best utilize the Odds Comparison Futures 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 limited results per page. To get additional results you may 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.
Category Futures – Provides a list of futures available for a given category.
Competition Futures – Provides a list of futures available for a given competition.
Competition Mappings – Provides competition ID mapping between League Specific and General Sport ID types.
Competitor Mappings – Provides competitor ID mapping between League Specific and General Sport ID types.
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 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 the outright odds for the World Series champion:
- Call the Sports resource and make note of the Sport Id for your event
- Call the Sport Competitions endpoint, using the Sport Id
- Find the Competition Id (sr:competition:109) for MLB within the results
- Call the Competition Futures endpoint using your located Competition Id
- The outright odds for the World Series champ are displayed
Integration Links
OpenAPI Spec
Our Odds Comparison Futures API is available via OpenAPI. Click below to view and/or download the specs.
Odds Comparison Futures v2 OpenAPI
Postman Workspace
Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Odds Comparison Futures 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 Futures API XSD schema.
Odds Comparison Futures v2 Schema