Docs
Coverage MatrixDocumentationRelease LogLog In

FAQs

Frequently asked questions on Probabilities v1

Click on the categories below or browse questions on the right panel.

Categories

.


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?

Only main markets (2way, 3way) odds are currently available for all sports. The Innings Runs market is also available for Cricket.


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

<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 happens to the Sport Event Probabilities Timeline before, during, and after the match?

Before the match, the feed will only include pre-match probabilities. Near the start of the match the probabilities will switch to live. The pre-match probabilities will remain in the feeds throughout the match but be frozen in time with no further changes.

Live probabilities will continue to update throughout the match and will converge to 0 and 100 for the losing and winning outcomes.

Post-match the live probabilities will remain at 0 and 100 while the pre-match probabilities will persist as they were at the start of the match.



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?

When we present date only values we present these in the ISO 8601 standard format.

ex: 2013-04-03

We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/ISO_8601


What format are the date/time fields presented in?

All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.

ex: 2013-04-03T18:15:00+00:00

For more information: https://en.wikipedia.org/wiki/ISO_8601


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 Time & 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

When does match_time, remaining_time and remaining_time_in_period show up in the data?

These attributes are included alongside predictions for sport events which are divided into time-based periods of play. The data is only recorded while a period of play is in-progress and does not appear during breaks such as half-time.




🙋

More questions?

Reach out to [email protected] for further assistance.