Leagues & Performance

  • Basic
  • Standard
  • Advanced
  • Custom

Introduction

One of our newest features is the Prediction API. Predictions on 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.

We offer endpoints to get the Probabilities per fixture or the Get all Probabilities. All probabilities are available 21 days before the match starts.

We also detect Value Bets for you. the Value Bet API is processing thousands of historical odds data and market trends to find Value opportunities, compared against bookmakers odds. Please note that not for every match a Value Bet is detected. Available endpoints are Value Bet by Fixture and Get all Value Bets

To offer you full transparency of the Predictions Performance of our Football Predictions we introduced this Leagues Performance endpoint. It helps you to track the success rate per League over the last 100 Predictions. For all Leagues with Predictions available (400+) you can find several indicators that help you to provide the insights you need about each League. Predictions are available for domestic Leagues. Cups will be added later on.

hit_ratio: number of times the model predicts the right outcome (1, X, 2) over the last 100 matches of the league. The closer to 1,00 the better. The random prediction has a hit ratio of 0.33 (33%).

log_loss: average log loss over the last 100 matches of the league. This is measuring the quality of the probabilities. The closer to 0 the better. Here, the quality is considered as good when is it below -1.02 and high when it is below -0.98. The random prediction has a log loss of -1.09. So any log loss below -1.07 will be considered as poor predictability.

predictability: not everybody is comfortable with numbers. The predictability tells you in a word if the league has a poor, medium, good or high predictability.

predictive_power: the predictive power tells you if the log loss has been increased since the last 50 matches. It can be up, down or unchanged. When the predictive power is up, the league is becoming more predictable.

Endpoint Details

Below you can find the details for this endpoint.

Key Value
Endpoint: https://soccer.sportmonks.com/api/v2.0/predictions/leagues
Pagination: No
Includes: No includes available for this endpoint.
Nested Includes: - You can add a max of levels of nested includes.
Parameters: No parameters available for this endpoint.

Example Request

The following code snippets demonstrate how to get all prediction apis available in this endpoint.

// Get your API tokens here: https://www.sportmonks.com/settings#/api
curl "https://soccer.sportmonks.com/api/v2.0/predictions/leagues?api_token=YOURTOKEN"
-H "Accept: application/json"
// Get your API tokens here: https://www.sportmonks.com/settings#/api
$client = new GuzzleHttp\Client();
$res = $client->request('GET', 'https://soccer.sportmonks.com/api/v2.0/predictions/leagues?api_token=YOURTOKEN', [
    'headers' => ['Accept' => 'application/json']
]);
// Get your API tokens here: https://www.sportmonks.com/settings#/api
response = requests.get("https://soccer.sportmonks.com/api/v2.0/predictions/leagues?api_token=YOURTOKEN")

# Print the status code of the response.
print(response.status_code)
// Get your API tokens here: https://www.sportmonks.com/settings#/api
require 'faraday_middleware'

Faraday.new('https://soccer.sportmonks.com/api/v2.0/predictions/leagues?api_token=YOURTOKEN', headers: {'Accept' => 'application/json', 'Accept-Encoding' => 'gzip'}).get
// Get your API tokens here: https://www.sportmonks.com/settings#/api
URL url = new URL("https://soccer.sportmonks.com/api/v2.0/predictions/leagues?api_token=YOURTOKEN");
HttpURLConnection con = (HttpURLConnection) url.openConnection();
con.setRequestMethod("GET");
// Get your API tokens here: https://www.sportmonks.com/settings#/api
import { SportmonksApi } from 'sportmonks';
const sportmonks = new SportmonksApi(__YOUR_API_TOKEN__);
sportmonks.get("https://soccer.sportmonks.com/api/v2.0/predictions/leagues?api_token=YOURTOKEN",params).then( function(resp){
  //resp.data will contain your data
  //resp.meta will contain the meta informations
  console.log(resp);
});
// Get your API tokens here: https://www.sportmonks.com/settings#/api
package main

import (
    "fmt"
    "log"

    sm "github.com/BialkowskiSz/go-sportmonks"
)

func main() {
    sm.SetAPIToken("<YOUR_TOKEN_HERE>")
    g, err := sm.Get("https://soccer.sportmonks.com/api/v2.0/predictions/leagues?api_token=YOURTOKEN", "", 0, false)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(string(g))
}

Example Response

In the API Reference Guide the example responses of the prediction apis endpoint are shown.

Test this Endpoint

With our In-Page API Tester you can directly test this Endpoint by clicking the blue button on the right ‘Open Test API’. By adding Includes, Parameters and Variables and clicking the blue button on the right below ‘Send API Request’, you can directly view the API Response. Your Requests and Responses are even stored in your personal API Tester Folder (only when you are logged-in). If you are not logged in the API Tester will use the Free Plan Leagues for your requests.

Questions?

We're always happy to help with code or other questions you might have! Search our documentation, contact support, or get in touch with our sales team.

This article was last updated on
{{ api_response }}
# Variable Value Description
{{ variable.variable }} {{ variable.description }}
# Relationship Description Value
{{ parameter.parameter }} {{ parameter.description }}
# Relationship Description Extra
{{ relation.include }} {{ relation.description }}

{{ loginForm.errors.get('email') }}

{{ loginForm.errors.get('password') }}

Remember me?