Endpoints

Retrieve all the expected data you want, from xG to xPTS, you can request them all through our expected endpoints.

Use one of our 2 expected endpoints. Per endpoint, you can find the details, including base URL, parameters, includes and more.

• GET Expected by Team: returns all the expected data that are available within your subscription on team level.

• GET Expected by Player: returns all the expected data that are available within your subscription on player level.

For the expected endpoints this is the base URL:

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

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

Requesting Expected values

GET Expected by Team

This endpoint will return all the expected values we offer on a team level. This response will differ based on your plan.

https://api.sportmonks.com/v3/football/expected/fixtures

Response

{
  "data": [
    {
      "id": 26898369,
      "fixture_id": 18898173,
      "type_id": 5304,
      "participant_id": 10010,
      "data": {
        "value": 1.0674
      },
      "location": "home"
    },
    {
      "id": 26898370,
      "fixture_id": 18898173,
      "type_id": 5304,
      "participant_id": 7011,
      "data": {
        "value": 1.0657
      },
      "location": "away"
    },

The availability of xG values is influenced by the speed of data processing. Since xG calculations require match statistics like shots, there may be a delay before xG values become available. Patience is key as relevant match data is processed to generate accurate xG insights.

GET Expected by Player

This endpoint will return all the expected values we offer on a player level. You won't see the expected values per chance, only the full values for each player.

https://api.sportmonks.com/v3/football/expected/lineups

Response

  "data": [
    {
      "id": 1064853093,
      "fixture_id": 19076535,
      "player_id": 77908,
      "team_id": 238626,
      "lineup_id": 8076889919,
      "type_id": 5304,
      "data": {
        "value": 0.0295
      }
    },
    {
      "id": 1064853094,
      "fixture_id": 19076535,
      "player_id": 37389571,
      "team_id": 238626,
      "lineup_id": 8076889917,
      "type_id": 5304,
      "data": {
        "value": 0.0496
      }
    },

xG values are continuously calculated and processed throughout the match, with updates occurring every couple of minutes. The maximum time between these updates should not exceed 5 minutes. Stay informed with real-time insights into evolving goal-scoring probabilities.