Get started with Probabilities API v1
Introduction
The Probabilities API provides live and pre-match 3-way (win, lose, or draw) probabilities for sporting events. Top US bookmakers are featured, and return odds for NFL, NBA, MLB, NHL, top soccer leagues, and more.
The API is consistent in structure, format, and behavior with the other General Sport APIs. Primary feeds will return schedules for sports and leagues covered.
Additional feeds provide probability breakdowns for events, including a live timeline for supported games.
API Map
To best utilize the Probabilities API, you will need specific parameters to create your API calls. The map below shows every feed in the API, grouped by task; the key marks the identifier each feed takes, and each entry links out to its endpoint page.
Feeds that require no ID, or only a sport ID and a date, can be called directly. Their responses provide the sport, competition, season, and sport event IDs that the probability feeds take.
Endpoint Descriptions
Competition Seasons – Returns a list of seasons for a given competition ID.
Seasonal Outright Probabilities – Returns a list of probabilities for various seasonal outrights.
Seasonal Probabilities - Returns a list of sport events with probabilities, for a given competition season ID.
Sport Competitions – Returns a list of competitions IDs for a given sport ID.
Sport Event Probabilities - Returns probabilities for a given sport event ID.
Sport Event Probabilities Timeline - Returns a list of probability changes during an event for a given sport event ID.
Sport Schedule - Returns a list of scheduled sport events by sport ID and date.
Sports - Returns a list of sports and their IDs.
Data Retrieval Samples
To find the Sport Event Probabilities for a Cricket match on a given day:
- Call the Sports endpoint and find Cricket.
- Take note of the "sport - id" for Cricket (sr:sport:21).
- Call the Sport Schedule endpoint using the sport id and the given day you are interested in.
- Find the sport event you are interested in and call the Sport Event Probabilities feed with the "sport_event - id".
The probabilities for the chosen match are displayed.
To find the Probabilities for a season of Cricket and view a Sport Event Probabilities Timeline:
- Call the Sports endpoint and find Cricket.
- Take note of the "sport - id" for Cricket (sr:sport:21).
- Call the Sport Competitions endpoint and take note of the "competition - id" for the competition you want.
- Call the Competition Seasons endpoint using the "competition - id" and take note of the "season - id" for the season you want.
- Call the Seasonal Probabilities endpoint using the "season - id" and take note of the "sport_event - id" for the match you want.
- Call the Sport Event Probabilities Timeline endpoint using the "sport_event - id".
Integration Resources
OpenAPI Spec
Our Probabilities API is available via OpenAPI. Click below to view and/or download the specs.
Postman Workspace
Run in PostmanOur full Media API suite—including the Probabilities 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 Probabilities API XSD schema.
MCP Server
The Sportradar Probabilities MCP Server is a Model Context Protocol (MCP) implementation that bridges AI assistants directly to our Probabilities API feeds. It allows LLMs to use standardized tools to fetch our sports data, helping to power your applications, assisting in coding, and streamlining your integration.
For detailed instructions on how to set up and use this integration, visit our MCP Server documentation.