# Performance Page

{% hint style="success" %}
Alpha Vaults's performance metrics are taken from on-chain data.

It can be independently verified by anyone.
{% endhint %}

## Performance Charts

{% hint style="info" %}
Alpha Vaults track the vault's performance at each Rebalance - it is therefore an approximation to the real time performance.\
\
To track the real time performance, users will need to track the USD value of their deposits. 
{% endhint %}

There is a performance chart for every vault, measuring:

### The performance versus holding the assets

<figure><img src="https://3306594273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FncWpbfiN022KvH5AGrQq%2Fuploads%2FP4NKE3jimU4DD99UC60M%2FETHUSDT%20Chart%403x.png?alt=media&#x26;token=1a4db2cf-6422-4200-8e29-82d439d8c559" alt=""><figcaption><p>Example of a performance chart in Alpha Vaults</p></figcaption></figure>

This chart tracks the vault's Net Performance\* versus the performance if depositors did not deposit into the vault (ie holding the assets).  The blue line shows the vault's performance during the period, and the dotted line shows the performance if depositors just held the assets.

{% hint style="info" %}
\*Net Performance = Fees Income Performance - Capital Loss - Protocol Fees - Manager Fees
{% endhint %}

#### For example:

The chart above shows the [WETH/USDT 0.05% vault](https://charm-alpha.vercel.app/vault/0x7adee9c6772df5e9b48a1d2580403af33a4a20e3-1)'s Net Performance is 8.24%\*\* better than holding the assets from 17th February to 25th June. This is an annualized performance of 23.5%.

\*\*101.33/93.61 - 1

{% hint style="danger" %}
Performance versus hold can vary significantly between periods, because it is based on the [token ratio](https://app.gitbook.com/o/-MR4cwx-KeRGSyiz7Khv/s/ncWpbfiN022KvH5AGrQq/~/changes/13/provide-liquidity/user-guides/home-page#ratio) at the start of the period.
{% endhint %}

{% hint style="info" %}
The  full-range performance chart (see below) is a performance metric that do not depend on the token ratio.
{% endhint %}

### The performance versus a full-range position

This chart tracks the vault's Net Performance\* versus the performance if depositors deposit into a full-range position, assuming the fees income for a full-range position is [negligible](https://support.uniswap.org/hc/en-us/articles/7423608592781-Can-I-provide-liquidity-over-the-full-range-on-V3-). The grey line ('Benchmark') in the chart above shows the performance of a Full-Range Position.

#### For example:

The chart above shows the [WETH/USDT 0.05% vault](https://charm-alpha.vercel.app/vault/0x7adee9c6772df5e9b48a1d2580403af33a4a20e3-1)'s Net Performance is 8.49%\*\* better than a Full-Range Position from 17th February to 25th June. This is an annualized performance of 24.23%.

\*\*101.33/93.40 - 1

### The vault's token ratio

<figure><img src="https://3306594273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FncWpbfiN022KvH5AGrQq%2Fuploads%2F2WkgvwgtOO74ZiRP6rwk%2Fimage.png?alt=media&#x26;token=3e85461a-232a-4d60-93d3-d3baa74b6d0f" alt=""><figcaption></figcaption></figure>

This tracks the [token ratio](https://learn.charm.fi/charm/provide-liquidity/user-guides/broken-reference) within the vault, and indicates how much of each asset is required for deposits, and what assets will be returned after withdrawing.

### The vault's liquidity distribution

<figure><img src="https://3306594273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FncWpbfiN022KvH5AGrQq%2Fuploads%2FHQHmtG3vsfDsE4C5QGsM%2FScreenshot%202023-07-04%20at%2020.10.33.png?alt=media&#x26;token=924c2129-2565-4b70-9312-ef2ca9eeb800" alt=""><figcaption></figcaption></figure>

This is the % of liquidity within the vault that's held in the base order, limit order, and full range. It's a useful indicator of the vault's risk. &#x20;

With all else being equal, a vault is more risky if it has a low full range %, and more % deposited into a narrower range (determined by the [baseThreshold](https://learn.charm.fi/charm/manage-liquidity/user-guides/vault-parameters#base-order-width-basethreshold) and [limitThreshold](https://learn.charm.fi/charm/manage-liquidity/user-guides/vault-parameters#limit-order-width-limitthreshold)).

For example, the vault above has 4.3% in full-range, 56.8% in a limit range, and 38.9% in a base range. The vault is quite risky because 38.9% of its liquidity is in a narrower base range. It will have higher risk of Capital Loss, but can also earn higher Fees Income.

## Verifying the performance

If you wish to verify the performance, or to build you own performance charts, you can:

### Use the Alpha Vaults subgraph

This is how the Alpha Vaults front-end tracks performance.  It uses the Alpha Vaults [subgraph](https://learn.charm.fi/charm/technical-references/customizations) to index information from the blockchain, and specifically, the events emitted by the [Core Contracts](https://learn.charm.fi/charm/technical-references/core).

### Directly querying the contract

The real time performance of a vault can be tracked by querying the following contract methods:

* [`getTotalAmount()`](https://learn.charm.fi/charm/technical-references/core/alphaprovault#gettotalamounts) - this gets the total amount of tokens held by the vault.
* totalSupply()- this is the total number of vault shares that has been minted.

and then calculate the % difference between Value Per Share\*  to get the performance between 2 dates.

\*Value per Share = getTotalAmount() x spot price / getTotalSupply())


---

# 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://learn.charm.fi/charm/provide-liquidity/user-guides/performance-page.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.