Historical

get

Retrieves historical APY and TVL for a specific vault, based on the provided query parameters.

Authorizations
Path parameters
networkstring · enumRequired

Include only vaults with provided network(name or CAIP)

Possible values:
vaultAddressstringRequired

Address of the vault for which the data will be returned

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

Page number (starting from 0)

Default: 0
perPageinteger · max: 20000Optional

Number of items per page

Default: 50
apyIntervalstring · enumOptional

Interval for APY data. Possible values: 1day, 7day, 30day

Default: 7dayPossible values:
granularitystring · enumOptional

Granularity for historical data (even intervals starting from epoch 0). Possible values: 1hour, 1day, 1week

Default: 1hourPossible values:
fromTimestampintegerOptional

Timestamp for the start of the time period for which data will be fetched

Default: 0
toTimestampintegerOptional

Timestamp for the end of the time period for which data will be fetched

Responses
200
Historical TVL and APY data for a vault, paginated by timestamp
application/json
get
GET //v2/historical/{network}/{vaultAddress} HTTP/1.1
Host: api.vaults.fyi
x-api-key: YOUR_API_KEY
Accept: */*
{
  "itemsOnPage": 1,
  "nextPage": 1,
  "data": [
    {
      "timestamp": 1,
      "blockNumber": "text",
      "apy": {
        "base": 1,
        "reward": 1,
        "total": 1
      },
      "tvl": {
        "usd": "text",
        "native": "text"
      }
    }
  ]
}
get

Retrieves time-series historical APY data for a specific vault, including base yield and rewards components over a customizable time range

Authorizations
Path parameters
networkstring · enumRequired

Include only vaults with provided network(name or CAIP)

Possible values:
vaultAddressstringRequired

Address of the vault for which the data will be returned

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

Page number (starting from 0)

Default: 0
perPageinteger · max: 20000Optional

Number of items per page

Default: 50
apyIntervalstring · enumOptional

Interval for APY data. Possible values: 1day, 7day, 30day

Default: 7dayPossible values:
granularitystring · enumOptional

Granularity for historical data (even intervals starting from epoch 0). Possible values: 1hour, 1day, 1week

Default: 1hourPossible values:
fromTimestampintegerOptional

Timestamp for the start of the time period for which data will be fetched

Default: 0
toTimestampintegerOptional

Timestamp for the end of the time period for which data will be fetched

Responses
200
Historical APY data for a vault, paginated by timestamp
application/json
get
GET //v2/historical/{network}/{vaultAddress}/apy HTTP/1.1
Host: api.vaults.fyi
x-api-key: YOUR_API_KEY
Accept: */*
{
  "itemsOnPage": 1,
  "nextPage": 1,
  "data": [
    {
      "timestamp": 1,
      "blockNumber": "text",
      "apy": {
        "base": 1,
        "reward": 1,
        "total": 1
      }
    }
  ]
}
get

Retrieves time-series historical TVL data for a specific vault, including base yield and rewards components over a customizable time range

Authorizations
Path parameters
networkstring · enumRequired

Include only vaults with provided network(name or CAIP)

Possible values:
vaultAddressstringRequired

Address of the vault for which the data will be returned

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

Page number (starting from 0)

Default: 0
perPageinteger · max: 20000Optional

Number of items per page

Default: 50
apyIntervalstring · enumOptional

Interval for APY data. Possible values: 1day, 7day, 30day

Default: 7dayPossible values:
granularitystring · enumOptional

Granularity for historical data (even intervals starting from epoch 0). Possible values: 1hour, 1day, 1week

Default: 1hourPossible values:
fromTimestampintegerOptional

Timestamp for the start of the time period for which data will be fetched

Default: 0
toTimestampintegerOptional

Timestamp for the end of the time period for which data will be fetched

Responses
200
Historical TVL data for a vault, paginated by timestamp
application/json
get
GET //v2/historical/{network}/{vaultAddress}/tvl HTTP/1.1
Host: api.vaults.fyi
x-api-key: YOUR_API_KEY
Accept: */*
{
  "itemsOnPage": 1,
  "nextPage": 1,
  "data": [
    {
      "timestamp": 1,
      "blockNumber": "text",
      "tvl": {
        "usd": "text",
        "native": "text"
      }
    }
  ]
}

Last updated