v1 Market Data Endpoints for DeFi Vaults

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

integer

default:"0"

Page number.

integer

default:"10"

Number of results per page. Maximum: 250.

string[]

Filter by tags. All specified tags must be present on the vault.

string

Filter by token name or symbol.

string

Filter by network name or CAIP identifier. Supported values: mainnet, arbitrum, optimism, polygon, base, gnosis, unichain, and their CAIP equivalents.

number

Minimum TVL in USD.

number

Maximum TVL in USD.

string

Return only vaults with transactional endpoint support. Values: true, false.

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

string

required

Network name or CAIP identifier. E.g. mainnet, arbitrum, base.

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

string

required

Network name or CAIP identifier.

string

required

Vault contract address. Pattern: ^0x[a-fA-F0-9]{40}$.

Query parameters

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

string

required

Network name or CAIP identifier.

string

required

Vault contract address. Pattern: ^0x[a-fA-F0-9]{40}$.

Query parameters

integer

Start of the range in epoch seconds.

integer

End of the range in epoch seconds.

string

default:"7day"

APY averaging window. Possible values: 1day, 7day, 30day.

integer

default:"86400"

Time between returned data points, in seconds.

integer

default:"0"

Page number.

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

string

required

Network name or CAIP identifier.

string

required

Vault contract address. Pattern: ^0x[a-fA-F0-9]{40}$.

Query parameters

string

required

APY averaging window. Possible values: 1day, 7day, 30day.

integer

required

Start of the range in epoch seconds.

integer

required

End of the range in epoch seconds.

integer

required

Time between returned data points, in seconds.

integer

default:"0"

Page number.

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

string

required

Network name or CAIP identifier.

string

required

Vault contract address. Pattern: ^0x[a-fA-F0-9]{40}$.

integer

required

Epoch timestamp in seconds.

Query parameters

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

string

required

Network name or CAIP identifier.

string

required

Vault contract address. Pattern: ^0x[a-fA-F0-9]{40}$.

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: */*

Sections

Endpoints

Beta

Alpha

v1 Market Data Endpoints for DeFi Vaults

Get data for multiple vaults

Query parameters

Example request

Example response

Get data on a single vault

Path parameters

Example request

Get APY on a single vault

Path parameters

Query parameters

Example request

Example response

Get benchmark rates

Example request

Example response

Historical data endpoints

Get historical APY and TVL over a timestamp range

Path parameters

Query parameters

Example response

Get historical APY over a timestamp range

Path parameters

Query parameters

Example request

Example response

Get historical APY at a single timestamp

Path parameters

Query parameters

Example response

Get historical TVL at a single timestamp

Path parameters

Example request

​Get data for multiple vaults

​Query parameters

​Example request

​Example response

​Get data on a single vault

​Path parameters

​Example request

​Get APY on a single vault

​Path parameters

​Query parameters

​Example request

​Example response

​Get benchmark rates

​Example request

​Example response

​Historical data endpoints

​Get historical APY and TVL over a timestamp range

​Path parameters

​Query parameters

​Example response

​Get historical APY over a timestamp range

​Path parameters

​Query parameters

​Example request

​Example response

​Get historical APY at a single timestamp

​Path parameters

​Query parameters

​Example response

​Get historical TVL at a single timestamp

​Path parameters

​Example request

Get data for multiple vaults

Query parameters

Example request

Example response

Get data on a single vault

Path parameters

Example request

Get APY on a single vault

Path parameters

Query parameters

Example request

Example response

Get benchmark rates

Example request

Example response

Historical data endpoints

Get historical APY and TVL over a timestamp range

Path parameters

Query parameters

Example response

Get historical APY over a timestamp range

Path parameters

Query parameters

Example request

Example response

Get historical APY at a single timestamp

Path parameters

Query parameters

Example response

Get historical TVL at a single timestamp

Path parameters

Example request