> For the complete documentation index, see [llms.txt](https://info.soccerfootball.info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://info.soccerfootball.info/dominance-index.md).

# Dominance index

The dominance index is the innovative index that objectively indicates the pressure that team A or B is exerting in the match.

### How is it computed?

The calculation is relatively simple. Each event is given a weight expressed in points, and the sum of the points in the 30-second time frame gives the result. \
The most complex part is to correctly weigh all events

### What values do we have available?

In the calls where the dominance index is indicated there are two values:

* dominance\_index
* dominance\_index\_2\_5\_avg&#x20;

The first value contains a JSON updated every 30 seconds that shows the current game performance. The average value of 2.5 minutes shows the average score of the last 5 samples.

Two values are present because the first one can be useful to draw and humanly interpret graphs, the second one instead gives a dry value that numerically indicates the pressure of the team in that moment, so it can be useful for strategies or bots.

### How should it be interpreted?

The higher the value, the higher the pace of the team.&#x20;

The difference between the value of team A and that of team B indicates dominance. \
If the dominance is positive, team A is dominating, if it is negative, team B is dominating, if the gap is wide, either negative or positive, the dominance is very marked.

### How can it be plotted?

Indicatively the dominance index can be drawn in two ways:

#### With line chart&#x20;

![Dominance index line chart](/files/j2wJK7WuM5GB2qLs4Dcb)

The graph shows not only the difference between the two indices but also the rhythm of the match. The higher the value, the higher the rhythm of the two teams.

**With bar chart**

![Dominance index bar chart](/files/kHF30NU7xpb3cFjVZcIt)

The bar chart plots the difference of the two indices and at a glance shows the tendency of dominance of one of the two teams .\
To generate a bar char just do the difference between the index of dominance A and B.\
If result is negative team B dominance vice versa dominates the A team

To help you draw the graph quickly, we wrote a COLAB document that interprets the response of the MATCH VIEW call and prints the graphs.

[**`GO TO COLAB FILE`**](https://colab.research.google.com/drive/1tkPTJK5OBesFBMVsQBPitLZN_lz87vU7?usp=sharing)

### What calls are available?

Dominance index are available in this calls:

* [Emulation totalcorner today](/v1/emulated/totalcorner/match-today.md)
* [Emulation totalcorner schedule](/v1/emulated/totalcorner/match-schedule.md)
* [Live full](/v1/live/live-full.md)
* [Live basic](/v1/live/live-basic.md)
* [Match day basic](/v1/matches/day-basic.md)
* [Match day full](/v1/matches/day-full.md)
* [Match view basic](/v1/matches/view-basic.md)
* [Match view full](/v1/matches/view-full.md)
* [Match by basic](/v1/matches/by-basic.md)
* [Match by full](/v1/matches/by-full.md)
* [Match view  progressive](/v1/matches/view-progressive.md)
