OC Futures Overview

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. For a more scalable approach to entity ID mapping across Sportradar products, see the Mapping API.

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.

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 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.

Mapping Feeds:

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 Event Mappings – Provides sport event ID mapping between League Specific and General Sport ID types.
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 Resources

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

🚀
Run in Postman
Our full Media API suite—including the Odds Futures collection—lives in our public Postman workspace. Fork or follow any collection to get updates automatically.

Schema Download

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

Odds Comparison Futures v2 Schema

MCP Server

The Sportradar Odds Comparison Futures MCP Server is a Model Context Protocol (MCP) implementation that bridges AI assistants directly to our OC Futures 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.