FAQs

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

What markets are currently available?

Here are the valid markets:

Market	Applies to	Description
`2way`	All sports	Probabilities for a two-outcome result (win/loss), with no draw option. If an event ends in a draw, the market is resulted as `void`.
`3way`	All sports	Probabilities for a three-outcome result (home win, draw, away win).
`to_qualify`	Soccer	Probability that a team advances, accounting for play beyond 90 minutes — extra time and penalties.
`home_innings_runs`	Cricket	Probabilities for the runs scored by the home team in an innings.
`away_innings_runs`	Cricket	Probabilities for the runs scored by the away team in an innings.

<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"
    }
]

What competitions are covered?

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

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.

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>

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"

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

Sport Event Statuses

What are the possible values for `sport_event` - `status`?

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

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

Categories