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

400

Default Response

application/json

401

Default Response

application/json

403

Default Response

application/json

500

Default Response

application/json

503

Default Response

application/json

get

HTTPcURLJavaScriptPython

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

400

Default Response

application/json

401

Default Response

application/json

403

Default Response

application/json

500

Default Response

application/json

503

Default Response

application/json

get

HTTPcURLJavaScriptPython

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

400

Default Response

application/json

401

Default Response

application/json

403

Default Response

application/json

500

Default Response

application/json

503

Default Response

application/json

get

HTTPcURLJavaScriptPython

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"
      }
    }
  ]
}