vaults.fyi
  • General
    • 🏦Overview
    • 💡Use Cases
      • For Wallets and Apps
      • For Analysts
      • For Protocols & Product Teams
    • 🔎Methodology
      • vaults.fyi USD benchmark rate
      • vaults.fyi ETH benchmark rate
    • ❓FAQ
      • Vault requirements for inclusion on vaults.fyi
    • 🤖AI
  • API
    • Introduction
      • Market data
      • Transactional support
      • Portfolio tracking
      • Personalized insights
  • Endpoints
    • General
    • Detailed Vaults
    • Historical
    • Portfolio
    • Transactions
    • Legacy (v1) endpoints
      • v1 Market data
        • Get historical data
          • Get historical APY and TVL data on single vault over timestamp range
          • Get historical APY on single vault over timestamp range
          • Get historical TVL on single vault at single timestamp
          • Get historical APY on single vault at single timestamp
        • Get data for multiple vaults
        • Get data on single vault
          • Get APY on single vault
        • Get benchmark rates
        • Get supported vaults, networks & tokens
          • /vaults
          • /networks
          • /tokens
          • /tags
      • v1 Contextual insights
        • Top vault options for address
        • Get single top option for address
        • [Etherscan cards] Get top USD, top ETH vault for address
      • v1 Generate payloads
        • Prepare calldata
          • Supply/Deposit
          • Withdraw/Redeem
            • Request redeem
            • Claim redeem
          • Claim rewards
        • Get contract interaction details
        • Get supported assets
        • Get supported vaults
      • v1 Position tracking
        • Get user balances
        • Get user positions
        • Get list of past vault txns by user address
        • Get estimated returns for user's vault position
  • Case Studies
    • Kraken Wallet
    • Etherscan Cards
  • Plans
    • Credits
      • Credits (v1 endpoints)
  • Links
    • vaults.fyi
    • X
    • Farcaster
    • Wallfacer Labs
Powered by GitBook
On this page
  1. Endpoints

Historical

PreviousDetailed VaultsNextPortfolio

Last updated 3 days ago

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: 20000
apyIntervalstring · enumOptional

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

Default: 7dayPossible 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
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: 20000
apyIntervalstring · enumOptional

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

Default: 7dayPossible 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
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: 20000
apyIntervalstring · enumOptional

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

Default: 7dayPossible 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
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"
      }
    }
  ]
}
  • GET/v2/historical/{network}/{vaultAddress}
  • GET/v2/historical/{network}/{vaultAddress}/apy
  • GET/v2/historical/{network}/{vaultAddress}/tvl