Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vaults.fyi/llms.txt

Use this file to discover all available pages before exploring further.

The v1 market data endpoints give you access to real-time and historical APY and TVL data across leading lending and staking vaults. You can query the full vault catalog, drill into a single vault, fetch benchmark rates, or pull time-series data for charting and backtesting.
These are legacy v1 endpoints. They are fully supported and maintained. For new integrations, consider using the v2 endpoints.

​
Get data for multiple vaults

GET https://api.vaults.fyi/v1/detailed/vaults
Returns a paginated list of vaults with detailed APY, TVL, token, and scoring information. Use query parameters to filter by network, token, TVL range, or transactional support. Authentication: x-api-key header required.

​
Query parameters

​
page
integer
default:"0"
Page number.
​
per_page
integer
default:"10"
Number of results per page. Maximum: 250.
​
tags
string[]
Filter by tags. All specified tags must be present on the vault.
​
token
string
Filter by token name or symbol.
​
network
string
Filter by network name or CAIP identifier. Supported values: mainnet, arbitrum, optimism, polygon, base, gnosis, unichain, and their CAIP equivalents.
​
tvl_min
number
Minimum TVL in USD.
​
tvl_max
number
Maximum TVL in USD.
​
transactionalOnly
string
Return only vaults with transactional endpoint support. Values: true, false.
​
transactionalFeaturedOnly
string
Return only transactional vaults featured on app.vaults.fyi. Values: true, false.

​
Example request

GET /v1/detailed/vaults HTTP/1.1
Host: api.vaults.fyi
x-api-key: YOUR_API_KEY
Accept: */*

​
Example response

{
  "next_page": 1,
  "data": [
    {
      "name": "USDC Lending",
      "address": "0xabc...123",
      "network": "mainnet",
      "protocol": "Aave",
      "tvlDetails": {
        "tvlNative": "5000000",
        "tvlUsd": "5000000",
        "lockedNative": "4500000",
        "lockedUsd": "4500000",
        "liquidNative": "500000",
        "liquidUsd": "500000"
      },
      "numberOfHolders": 1204,
      "apy": {
        "base": { "1day": 450, "7day": 420, "30day": 410 },
        "rewards": { "1day": 50, "7day": 48, "30day": 45 },
        "total": { "1day": 500, "7day": 468, "30day": 455 }
      },
      "isTransactional": true
    }
  ]
}
APY values are expressed in basis points (BPS). Divide by 100 to get a percentage.

​
Get data on a single vault

GET https://api.vaults.fyi/v1/vaults/{network}/{vaultAddress}/
Returns full detail for a specific vault including TVL breakdown, APY windows, top holders, rewards, and scoring. Authentication: x-api-key header required.

​
Path parameters

​
network
string
required
Network name or CAIP identifier. E.g. mainnet, arbitrum, base.
​
vaultAddress
string
required
Vault contract address. Pattern: ^0x[a-fA-F0-9]{40}$.

​
Example request

GET /v1/vaults/mainnet/0xabc...123/ HTTP/1.1
Host: api.vaults.fyi
x-api-key: YOUR_API_KEY
Accept: */*

​
Get APY on a single vault

GET https://api.vaults.fyi/v1/vaults/{network}/{vaultAddress}/apy
Returns the current base APY, rewards APY, and total APY for a vault at a specified averaging interval. Authentication: x-api-key header required.

​
Path parameters

​
network
string
required
Network name or CAIP identifier.
​
vaultAddress
string
required
Vault contract address. Pattern: ^0x[a-fA-F0-9]{40}$.

​
Query parameters

​
interval
string
required
APY averaging window. Possible values: 1day, 7day, 30day.

​
Example request

GET /v1/vaults/mainnet/0xabc...123/apy?interval=7day HTTP/1.1
Host: api.vaults.fyi
x-api-key: YOUR_API_KEY
Accept: */*

​
Example response

{
  "base": 420,
  "rewards": 48,
  "total": 468
}

​
Get benchmark rates

GET https://api.vaults.fyi/v1/benchmarks
Returns the Vaults.fyi TVL-weighted benchmark yield for stablecoins (USD) and ETH, calculated across leading DeFi pools. Authentication: x-api-key header required.

​
Example request

GET /v1/benchmarks HTTP/1.1
Host: api.vaults.fyi
x-api-key: YOUR_API_KEY
Accept: */*

​
Example response

{
  "usd": {
    "name": "vaults.fyi USD Benchmark",
    "apy": {
      "1day": 480,
      "7day": 460,
      "30day": 450
    },
    "vaults": [
      {
        "name": "USDC Lending",
        "network": "mainnet",
        "address": "0xabc...123"
      }
    ]
  },
  "eth": {
    "name": "vaults.fyi ETH Benchmark",
    "apy": {
      "1day": 310,
      "7day": 305,
      "30day": 300
    },
    "vaults": [
      {
        "name": "stETH",
        "network": "mainnet",
        "address": "0xdef...456"
      }
    ]
  }
}
See the methodology docs for details on how benchmark rates are calculated.

​
Historical data endpoints

Historical endpoints are available on Pro-level plans and are useful for building APY and TVL charts or backtesting strategies.

​
Get historical APY and TVL over a timestamp range

GET https://api.vaults.fyi/v1/vaults/{network}/{vaultAddress}/historical-data
Returns paginated time-series APY and TVL data for a vault between two timestamps. Authentication: x-api-key header required.

​
Path parameters

​
network
string
required
Network name or CAIP identifier.
​
vaultAddress
string
required
Vault contract address. Pattern: ^0x[a-fA-F0-9]{40}$.

​
Query parameters

​
from_timestamp
integer
Start of the range in epoch seconds.
​
to_timestamp
integer
End of the range in epoch seconds.
​
interval
string
default:"7day"
APY averaging window. Possible values: 1day, 7day, 30day.
​
granularity
integer
default:"86400"
Time between returned data points, in seconds.
​
page
integer
default:"0"
Page number.
​
per_page
integer
default:"10"
Results per page. Maximum: 50.

​
Example response

{
  "next_page": 1,
  "data": [
    {
      "timestamp": 1700000000,
      "blockNumber": 18500000,
      "apy": {
        "base": 400,
        "rewards": 40,
        "total": 440
      },
      "tvlDetails": {
        "tvlNative": "4800000",
        "tvlUsd": "4800000",
        "lockedNative": "4300000",
        "lockedUsd": "4300000",
        "liquidNative": "500000",
        "liquidUsd": "500000"
      }
    }
  ]
}

​
Get historical APY over a timestamp range

GET https://api.vaults.fyi/v1/vaults/{network}/{vaultAddress}/historical-apy
Returns APY-only time-series data over a timestamp range. Authentication: x-api-key header required.

​
Path parameters

​
network
string
required
Network name or CAIP identifier.
​
vaultAddress
string
required
Vault contract address. Pattern: ^0x[a-fA-F0-9]{40}$.

​
Query parameters

​
interval
string
required
APY averaging window. Possible values: 1day, 7day, 30day.
​
from_timestamp
integer
required
Start of the range in epoch seconds.
​
to_timestamp
integer
required
End of the range in epoch seconds.
​
granularity
integer
required
Time between returned data points, in seconds.
​
page
integer
default:"0"
Page number.
​
per_page
integer
default:"10"
Results per page. Maximum: 50.

​
Example request

GET /v1/vaults/mainnet/0xabc...123/historical-apy?interval=7day&from_timestamp=1700000000&to_timestamp=1702592000&granularity=86400 HTTP/1.1
Host: api.vaults.fyi
x-api-key: YOUR_API_KEY
Accept: */*

​
Example response

{
  "next_page": 1,
  "data": [
    {
      "timestamp": 1700000000,
      "blockNumber": 18500000,
      "apy": {
        "base": 400,
        "rewards": 40,
        "total": 440
      }
    }
  ]
}

​
Get historical APY at a single timestamp

GET https://api.vaults.fyi/v1/vaults/{network}/{vaultAddress}/historical-apy/{timestamp}
Returns the APY for a vault at the block closest to the given timestamp. Authentication: x-api-key header required.

​
Path parameters

​
network
string
required
Network name or CAIP identifier.
​
vaultAddress
string
required
Vault contract address. Pattern: ^0x[a-fA-F0-9]{40}$.
​
timestamp
integer
required
Epoch timestamp in seconds.

​
Query parameters

​
interval
string
required
APY averaging window. Possible values: 1day, 7day, 30day.

​
Example response

{
  "timestamp": 1700000000,
  "blockNumber": 18500000,
  "apy": {
    "base": 400,
    "rewards": 40,
    "total": 440
  }
}

​
Get historical TVL at a single timestamp

GET https://api.vaults.fyi/v1/vaults/{network}/{vaultAddress}/historical-tvl/{timestamp}
Returns the TVL breakdown for a vault at the block closest to the given timestamp. Authentication: x-api-key header required.

​
Path parameters

​
network
string
required
Network name or CAIP identifier.
​
vaultAddress
string
required
Vault contract address. Pattern: ^0x[a-fA-F0-9]{40}$.
​
timestamp
integer
required
Epoch timestamp in seconds.

​
Example request

GET /v1/vaults/mainnet/0xabc...123/historical-tvl/1700000000 HTTP/1.1
Host: api.vaults.fyi
x-api-key: YOUR_API_KEY
Accept: */*