Probabilities

Enrich your applications with detailed predictions. Our Predictions API offers predictions on various markets like the winner, correct scores, over/under and both teams to score (BTTS) are all available here, produced with our machine learning techniques and models.

An overview of all the options to request predictions:

• GET Probabilities: returns all probabilities available within your subscription.

• GET Performance by League ID: returns the performances of our Predictions Model for your requested league ID.

• GET Probabilities by Fixture ID: returns all the predictions available for your requested fixture ID.

For all the predictions endpoints the base URL is the same:

https://api.sportmonks.com/v3/football/predictions

Per endpoint the rest of the URL requires additional information. We will explain this per endpoint.

Please note that you need to have the Predictions add-on in your subscription. The below examples are made with an Enterprise Plan with Predictions.

Requesting probabilities

GET Probabilities as include

One of the most important endpoints you can receive predictions from is the fixtures and livescores endpoints. The predictions are available as an include. The other possibilities listed in this tutorial are only available via the predictions endpoint. While this might be interesting, we understand that using predictions as an add-on is even more flexible. For example, you can use the predictions include on the fixture by date endpoint:

Response

GET All Probabilities

Response

Let’s evaluate the response:

• id: refers to the id of the probability

• fixture_id: refers to the fixture related to the prediction

• predictions: the data object with prediction values

• type_id: refers to the type of the prediction

GET Probabilities by Fixture ID

Not interested in all the probabilities? Just looking for the probabilities of a single fixture? Fear not. You can use the probabilities by fixture id endpoint. Add the fixture id you’re interested in:

https://api.sportmonks.com/v3/football/predictions/probabilities/fixtures/{fixture_id}

For example, if you’re interested in the probabilities for Dundee vs Celtic (fixture id: 18136955).

Response

GET Performance by League ID

The Leagues & performances endpoint will give you information about the performance of our prediction per league. Every league has a performance rating.

You can request the performance of the leagues by using the following URL:

https://api.sportmonks.com/v3/football/predictions/predictability/leagues/{league_id}

For example the performance of the Scottish Premiership (league id 501):

Response

The league predictability consists of four elements.

1. Hit Ratio Let's take a look at one example. We can see here that for the Scottish Premiership (league id: 501), the ‘hit ratio’ is 0.54 for the 3-way result (1, X, 2) market. The hit ratio is the number of times the model predicted the particular market correctly the last 100 matches of the league. The closer to 1,00, the better it is. You can track and see the real-time predictability performance for all prediction markets per league.

2. Log Loss This is the average log loss over the last 100 matches of the league. It measures the quality of the probabilities. The closer the number is to 0, the better it is. The quality is considered poor, medium, good or high based on the log loss. Poor is < -1.07 Medium is > -1.07 Good is > -1.02 High is > -.98

3. Predictability Not everybody is comfortable with numbers. This will tell you straight away in words, whether the predictability of the league is good or bad.

4. Predictive power This tells you whether the log loss has been increasing or not in the last 50 matches. Possible outcomes are up, down, or unchanged. If the predictive power is up, then the league becomes more predictable.

Adding useful information

• type: includes the prediction’s type.

• fixture: includes the fixture information.

• league: includes the league information.

For example, if you’re interested in the probabilities for Dundee vs Celtic (fixture id: 18136955) with the type and fixture info.

Response

Selecting and filtering

You’re interested in the probabilities for Dundee vs Celtic (fixture id: 18136955) with the type and fixture info. This results in the below request and response:

Response