# How to read Vault info

This page will be braked into 2 sections. One regarding the Vault general information (eg: TVL) and the other regarding the user-specific information (Eg: Balances). 

### 1) Vault information

Inside the Vault information, the main info that you will have: 

* TVL
* Accumulated Returns (since creation)
* Estimated APY (Get the last 30 days and project this for the year)
* Monthly returns
* Historical transactions

**The easiest way to fetch this information is through our API**: <https://yield-backend.pods.finance/strategies/>&#x20;

There you will find the information needed from all our vaults.

In this table, you can find the relation between the information above and the response keys.

| Metric                  | Object Key Name              |
| ----------------------- | ---------------------------- |
| TVL                     | `tvlInTokenDeposited`        |
| Accumulated Returns     | `lastAccReturn`              |
| Estimated APY           | `projectedAPY`               |
| Monthly Returns         | `monthlyReturnsBreakdown`    |
| Historical transactions | not supported yet in the API |

### 2) User information

The basic information that you show about the user are:

* Amount Idle (waiting to be processed)
* Amount invested (already processed, waiting to earn yield)
* Historical transactions

**The easiest way to fetch this information is through our API**: [https://yield-backend.pods.finance/](https://yield-backend.pods.finance/strategies/)user/\<userAddress>

In this table, you can find the relation between the information above and the response keys.

| Metric                  | Object Key Name                  |
| ----------------------- | -------------------------------- |
| Amount idle             | `idleAmountInTokenDeposited`     |
| Amount invested         | `investedAmountInTokenDeposited` |
| Number of shares        | `totalShares`                    |
| Returns                 | `returns`                        |
| Historical transactions | `actions`                        |

This information is what we show in this part of our app:

<figure><img src="/files/nfso4eqTynOhUUfmxAkd" alt=""><figcaption></figcaption></figure>


---

# 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.pods.finance/developers/integration-guide/how-to-read-vault-info.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.