# 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="<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>" 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="<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>" 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 %}