# Vault performances

Vault performances track yield metrics, user activity, and reward distributions for vaults. These metrics are used in analytics, reporting, and performance visualization on Pareto.

## Structure

Each vault performance object includes:

* `_id` *(string)* — Unique identifier
* `vaultId` *(string)* — Vault being tracked
* `vaultBlockId` *(string)* — Related vault block reference
* `block` *(object)* — Block information:
  * `number` *(number)* — Block number
  * `timestamp` *(number)* — Unix timestamp
* `age` *(number)* — Block age in seconds
* `holders` *(number)* — Number of unique users in the vault
* `realizedAPY` *(number)* — Realized annual percentage yield
* `accruedRewards` *(array of objects)* —
  * `tokenId` *(string)* — Reward token ID
  * `amount` *(string)* — Raw amount of rewards
  * `amountUSD` *(string)* — Value in USD
  * `APR` *(number)* — APR contribution
  * `percentage` *(number)* — Share of total reward
* `earnings` *(object)* —
  * `USD` *(string)* — USD-denominated earnings
  * `token` *(string)* — Token earnings amount
  * `percentage` *(number)* — Share of vault value
* `createdAt`, `updatedAt` *(string)* — ISO 8601 timestamps
* `createdBy`, `updatedBy` *(string)* — Actor IDs

## Endpoints

{% openapi src="/files/zlD9JUjbEtPWgFZATV1H" path="/vault-performances" method="get" %}
[VaultPerformances.yaml](https://4223418165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVSPclqPyChB4NMxFfG2X%2Fuploads%2FXXw4wqlMIQLVc4GctVm1%2FVaultPerformances.yaml?alt=media\&token=7e7e0c81-9c15-4099-8ad8-ae6a965bd241)
{% endopenapi %}

{% openapi src="/files/zlD9JUjbEtPWgFZATV1H" path="/vault-performances/{vaultPerformanceId}" method="get" %}
[VaultPerformances.yaml](https://4223418165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVSPclqPyChB4NMxFfG2X%2Fuploads%2FXXw4wqlMIQLVc4GctVm1%2FVaultPerformances.yaml?alt=media\&token=7e7e0c81-9c15-4099-8ad8-ae6a965bd241)
{% endopenapi %}


---

# 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.pareto.credit/developers/api/vault-performances.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.