Get historical APY on single vault

Get historical APY data for a vault for block with closest timestamp to the given one

get

/v1/vaults/{network}//{vaultAddress}/historical-apy/{timestamp}

Authorizations

Path parameters

vaultAddressstringrequired

Address of a vault

Pattern: ^0x[a-fA-F0-9]{40}$

networkstring · enumrequired

Network name or caip

Options: mainnet, arbitrum, optimism, polygon, base, gnosis, unichain, eip155:1, eip155:42161, eip155:10, eip155:137, eip155:8453, eip155:100, eip155:130

timestampintegerrequired

Timestamp of the historical data

Query parameters

intervalstring · enumrequired

Resolution of the APY data

Options: 1day, 7day, 30day

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://api.vaults.fyi/v1/vaults/{network}/{vaultAddress}/historical-apy/{timestamp}?interval=1day' \
  --header 'x-api-key: YOUR_API_KEY'

200

200

{
  "timestamp": 1,
  "blockNumber": 1,
  "apy": {
    "base": 1,
    "rewards": 1,
    "total": 1
  }
}

Object describing the APY of the vault in given time

Get historical APY data for a vault for blocks in given timestamp range

get

/v1/vaults/{network}//{vaultAddress}/historical-apy

Authorizations

Path parameters

vaultAddressstringrequired

Address of a vault

Pattern: ^0x[a-fA-F0-9]{40}$

networkstring · enumrequired

Network name or caip

Options: mainnet, arbitrum, optimism, polygon, base, gnosis, unichain, eip155:1, eip155:42161, eip155:10, eip155:137, eip155:8453, eip155:100, eip155:130

Query parameters

intervalstring · enumrequired

Resolution of the APY data

Options: 1day, 7day, 30day

from_timestampintegerrequired

Timestamp of the beginning of the range

to_timestampintegerrequired

Timestamp of the end of the range

pageinteger · default: 0

Page number

per_pageinteger · max: 50 · default: 10

Number of items per page

granularityintegerrequired

Time difference between returned data points

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://api.vaults.fyi/v1/vaults/{network}/{vaultAddress}/historical-apy?interval=1day&from_timestamp=1&to_timestamp=1&granularity=1' \
  --header 'x-api-key: YOUR_API_KEY'

200

200

{
  "next_page": 1,
  "data": [
    {
      "timestamp": 1,
      "blockNumber": 1,
      "apy": {
        "base": 1,
        "rewards": 1,
        "total": 1
      }
    }
  ]
}

Default Response