Table of Contents

Getting Started

Coverage

What sports are available in the Probabilities API?

The below sports are available to be licensed. More can be made available by request.

• American Football
• Baseball
• Basketball
• Cricket
• Handball
• Ice Hockey
• Soccer
• Tennis

The discovery walk from sports to competitions to seasons is on Probabilities API Basics in the Probabilities Integration Guide.

What markets are currently available?

Here are the valid markets:

<sport_event_status status="not_started" match_status="not_started"/>
<markets>
    <market name="3way" last_updated="2026-07-06T10:14:42+00:00">
        <outcomes>
            <outcome name="home_team_winner" probability="38.3"/>
            <outcome name="draw" probability="27.8"/>
            <outcome name="away_team_winner" probability="33.9"/>
        </outcomes>
    </market>
    <market name="to_qualify" last_updated="2026-07-06T10:14:42+00:00">
        <outcomes>
            <outcome name="home_team_winner" probability="52.6"/>
            <outcome name="away_team_winner" probability="47.4"/>
        </outcomes>
    </market>
</markets>

"markets": [
    {
        "name": "3way",
        "outcomes": [
            {
                "name": "home_team_winner",
                "probability": 38.3
            },
            {
                "name": "draw",
                "probability": 27.8
            },
            {
                "name": "away_team_winner",
                "probability": 33.9
            }
        ],
        "last_updated": "2026-07-06T10:14:42+00:00"
    },
    {
        "name": "to_qualify",
        "outcomes": [
            {
                "name": "home_team_winner",
                "probability": 52.6
            },
            {
                "name": "away_team_winner",
                "probability": 47.4
            }
        ],
        "last_updated": "2026-07-06T10:14:42+00:00"
    }
]

The market model, point anatomy, and lifecycle are covered on Probabilities Fundamentals in the Probabilities Integration Guide.

What competitions are covered?

To get a list of all the competitions call the Sport Competitions endpoint for a given sport.

The live_coverage flag, and the per-event live signal for competitions without it, are explained on Probabilities API Basics in the Probabilities Integration Guide.

Are historical probabilities available?

No. This is a forward-looking API only and probabilities will only be available for the current season of any competition. Additionally, there are no probabilities available prior to February 2019.

Season scope, and what the seasonal feeds cover, is on Probabilities API Basics in the Probabilities Integration Guide.

What level of precision is applied to the probabilities?

The probabilities are presented to the nearest tenth of a percent. Changes to the probabilities are captured when the probabilities change by more than 0.1%.

Integration

How do I distinguish between pre-match and live probabilities?

Live probabilities are denoted by the attribute live="true".

<markets>
    <market name="2way" last_updated="2019-03-05T01:54:53+00:00">
        <outcomes>
            <outcome name="home_team_winner" probability="66.3"/>
            <outcome name="away_team_winner" probability="33.7"/>
        </outcomes>
    </market>
    <market name="2way" live="true" last_updated="2019-03-05T13:57:32+00:00">
        <outcomes>
            <outcome name="home_team_winner" probability="44.7"/>
            <outcome name="away_team_winner" probability="55.3"/>
        </outcomes>
    </market>
</markets>

How the pre-match and live entries sit side by side during play, and how to read the Timeline, is covered on Tracking Win Probabilities in the Probabilities Integration Guide.

What format are date fields presented in?

Date values are presented in the ISO 8601 standard format.

Timestamp fields are in UTC. These could include scheduled start times or play-by-play event timestamps. Examples: scheduled="2024-02-11T23:30:00+00:00", created_at="2024-02-11T23:43:20+00:00"

Date-only fields reflect local league convention and are not UTC-adjusted. These could include season start dates and birth dates. Examples: start_date="2024-08-16", date_of_birth="1984-09-22"

Timestamps across the API are covered on Probabilities API Basics in the Probabilities Integration Guide.

How do I locate the TTL (Time to Live)/cache on an API endpoint?

The cache (in seconds) can be accessed in the returned header information on each RESTful API call, under cache-control.

ex. cache-control: max-age=1, public, s-maxage=1 or cache-control: public, must-revalidate, max-age=120

Every feed's TTL, with recommended polling cadences, is charted on Update Frequencies in the Probabilities Integration Guide.

Back to top ↑

Game Data

Sport Event Statuses

What are the possible values for sport_event - status?

Here are the valid sport_event.status values and their definitions:

• not_started - The match is scheduled to be played
• started - The match has begun
• live - The match is currently in progress
• postponed - The match has been postponed to a future date
• suspended - The match has been suspended
• match_about_to_start - The match is about to begin
• delayed - The match has been temporarily delayed and will be continued
• interrupted - The match began, but coverage has stopped for a short time. Note that match scores may not be updated during this period, the last recorded match score will be displayed instead
• cancelled - The match has been cancelled and will not be played
• ended - The match is over
• closed - The match results have been confirmed

How these statuses, and the sport-specific match_status values, drive a polling loop is covered on Tracking Win Probabilities in the Probabilities Integration Guide.

Why does an abandoned cricket match show status="ended" with 0% probabilities?

This is expected behavior for cricket matches rather than a data error.

When a cricket match is abandoned, voided, or completes with no result, the market is voided and every outcome returns a probability of 0. The sport_event.status still resolves to ended — as the list above shows, there is no abandoned value, so the status alone will not distinguish an abandoned match from one that finished normally.

To identify these matches, read the probabilities rather than the status. A match with status="ended" where every outcome returns probability="0" has been voided. A match that completed normally resolves to a winning outcome, so its probabilities will not all be zero.

<sport_event id="sr:sport_event:73455922" start_time="2026-08-29T09:30:00+00:00" start_time_confirmed="true">
--snip--
    <competitors>
        <competitor id="sr:competitor:1051285" name="Meerut Mavericks" country="India" country_code="IND" abbreviation="MEE" qualifier="home"/>
        <competitor id="sr:competitor:1051281" name="Lucknow Falcons" country="India" country_code="IND" abbreviation="LUC" qualifier="away"/>
    </competitors>
</sport_event>
<sport_event_status status="ended" match_status="ended" away_dismissals="0" away_score="0" delivery="3" home_dismissals="2" home_score="67" innings="1" live="true" over="9"/>
<markets>
    <market name="2way" last_updated="2026-08-29T08:58:42+00:00">
        <outcomes>
            <outcome name="home_team_winner" probability="0"/>
            <outcome name="away_team_winner" probability="0"/>
        </outcomes>
    </market>
    <market name="2way" live="true" last_updated="2026-09-03T20:43:49+00:00">
        <outcomes>
            <outcome name="home_team_winner" probability="0"/>
            <outcome name="away_team_winner" probability="0"/>
        </outcomes>
    </market>
</markets>

Match Scoring

What information does 'basic score' include?

Basic score information is included in the sport_event_status node and includes the following parameters:

• status
• match_status
• home_score
• away_score
• innings
• over
• delivery
• home_dismissals
• away_dismissals

The sport_event_status node and the game state it carries per sport are shown on Probabilities Fundamentals in the Probabilities Integration Guide.

Back to top ↑