# Expected

In this tutorial we're going to cover our Expected values. You can find all the types we cover on this page:

{% content-ref url="../../definitions/types/expected" %}
[expected](https://docs.sportmonks.com/v3/definitions/types/expected)
{% endcontent-ref %}

### 🎯 What is Expected Goals (xG)?

Expected Goals (xG) is an advanced metric that quantifies the quality of a scoring chance by evaluating multiple factors including shot location, angle, type of assist, and defensive pressure.

**How xG relates to our data:**

* Based on historical [match statistics](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/statistics/fixture-statistics) and shot outcomes
* Correlates with [team](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/statistics/team-statistics) and [player performance](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/statistics/players-statistics) metrics
* Powers [prediction models](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/odds-and-predictions/predictions) and analysis

💡 **Use case:** Identify teams/players that are underperforming or overperforming relative to the quality of chances they create.

These are the topics we will cover:

{% content-ref url="expected/endpoints" %}
[endpoints](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/expected/endpoints)
{% endcontent-ref %}

{% content-ref url="expected/includes" %}
[includes](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/expected/includes)
{% endcontent-ref %}

{% content-ref url="expected/coverage" %}
[coverage](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/expected/coverage)
{% endcontent-ref %}

{% hint style="info" %}
Please note that the availability of xG values varies depending on the package you choose.&#x20;

* The **Basic** package offers access straight after the match has finished to all xG statistics.
* The **Advanced** package offers real-time availability to all xG statistics.

You can find more information on our dedicated [pricing page](https://www.sportmonks.com/football-api/plans-pricing).&#x20;
{% endhint %}

### See also

#### Understanding xG data

* [Statistics Tutorial](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/statistics) - The data that informs xG calculations
* [Fixture Statistics](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/statistics/fixture-statistics) - Match-level performance data
* [Player Statistics](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/statistics/players-statistics) - Individual player xG metrics

#### Prerequisites

* [Fixtures Tutorial](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/livescores-and-fixtures/fixtures) - How to access fixture data
* [Includes Tutorial](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/includes) - Using xGFixture and lineups.xGLineup includes
* [Lineups Tutorial](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/lineups-and-formations) - Player lineups for xG by player

#### Related advanced metrics

* [Trends Tutorial](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/trends) - xG trends over time
* [Predictions](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/odds-and-predictions/predictions) - xG informs match predictions
* [Standings](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/standings) - xPTS (Expected Points) tables

#### Building with xG

* [Filter and Select](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/filter-and-select-fields) - Filter by specific xG types
* [Types Reference](https://docs.sportmonks.com/v3/definitions/types/expected) - All xG type IDs

#### API reference

* [Expected Endpoints](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/expected) - API documentation


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/expected.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
