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
    • vaults.fyi API Overview
      • Insights API
      • Earn API
        • Product demo
        • Flow diagrams
      • Plans
        • Credits
    • Endpoints
      • 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
      • Contextual insights
        • Top vault options for address
        • Get single top option for address
        • [Etherscan cards] Get top USD, top ETH vault for address
      • Generate payloads (Earn API)
        • Prepare calldata
          • Supply/Deposit
          • Withdraw/Redeem
            • Request redeem
            • Claim redeem
          • Claim rewards
        • Get contract interaction details
        • Get supported assets
        • Get supported vaults
      • Position tracking (Portfolio API)
        • 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
  • Links
    • vaults.fyi
    • X
    • Farcaster
    • Wallfacer Labs
Powered by GitBook
On this page
  1. API
  2. Endpoints
  3. Market data
  4. Get historical data

Get historical APY and TVL data on single vault over timestamp range

PreviousGet historical dataNextGet historical APY on single vault over timestamp range
get

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

Authorizations
Path parameters
vaultAddressstringRequired

Address of a vault

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

Network name or caip

Possible values:
Query parameters
pageintegerOptional

Page number

Default: 0
per_pageinteger ยท max: 50Optional

Number of items per page

Default: 10
intervalstring ยท enumOptional

Resolution of the APY data

Default: 7dayPossible values:
from_timestampintegerOptional

Timestamp of the beginning of the range in epoch seconds

Default: 1739374158
to_timestampintegerOptional

Timestamp of the end of the range in epoch seconds

Default: 1741966158
granularityintegerOptional

Time difference between returned data points

Default: 86400
Responses
200
Default Response
application/json
get
GET //v1/vaults/{network}/{vaultAddress}/historical-data HTTP/1.1
Host: api.vaults.fyi
x-api-key: YOUR_API_KEY
Accept: */*
200

Default Response

{
  "next_page": 1,
  "data": [
    {
      "timestamp": 1,
      "blockNumber": 1,
      "apy": {
        "base": 1,
        "rewards": 1,
        "total": 1
      },
      "tvlDetails": {
        "tvlNative": "text",
        "tvlUsd": "text",
        "lockedNative": "text",
        "lockedUsd": "text",
        "liquidNative": "text",
        "liquidUsd": "text"
      }
    }
  ]
}