Vault Historical APY
The Vault Historical APY (GET /v1/vaults/{network}/{vaultAddress}/historical-apy/{timestamp}
) endpoint is aimed at delivering past Annual Percentage Yield (APY) data for a specified vault. This data, based on the closest available record to a given timestamp, is crucial for users looking to perform trend analysis or understand the earnings performance over time.
Parameters
interval
(required): Defines the time frame of the APY data requested. The user can choose from1day
,7day
, or30day
intervals to match their analysis needs.vaultAddress
(required): The unique address of the vault for which historical APY information is being queried. This is a path parameter in the endpoint URL.network
(required): The blockchain network where the vault is located. Accepted values include mainnet, arbitrum, optimism, polygon, base, and gnosis.timestamp
(required): A numeric value representing the timestamp for which the historical APY data is sought. The API aims to return data corresponding to the closest block time to this timestamp.
Responses
200 OK
: On success, the endpoint responds with a JSON object detailing the APY for the vault at the nearest available time to the provided timestamp.
A typical response would be structured as:
This includes:
timestamp
which is the exact timestamp of the data returned.blockNumber
indicating the blockchain block that corresponds to the returned data.baseApy
providing the APY percentage value generated by the vault during that time.rewardsApy
providing the APY percentage value generated by the vault's rewards during that time.
The Vault Historical APY endpoint is an invaluable resource for financial analysis. It offers insights into the historical profitability of vault investments and enables comparison across different time intervals. This data can help support strategic investment decisions in DeFi.
Last updated