Endpoints

📦 Add-on Required

Expected Goals (xG) data requires either the xG Basic or xG Advanced add-on.

• xG Basic Add-on: Access to all xG statistics immediately after match completion (€19-€99 depending on your base plan)

• xG Advanced Add-on: Real-time xG statistics during live matches plus all post-match data (€199-€399 depending on your base plan)

Available with all base plans (Starter, Growth, Pro, Enterprise). View pricing and add-ons →

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. More information on our packages can be found here.