Benchmarks

Benchmarks give users a simple, consistent way to compare yield performance across networks.

For each network, we publish a USD and ETH benchmark based on the top 5 vaults by TVL (minimum $1M) at each timestamp that match relevant token sets:

  • USD-benchmark token set: USDC, USDT, DAI, USDS, USDe

  • ETH-benchmark token set: ETH, WETH

The benchmark APY is a TVL-weighted average, calculated daily and stored with 1/7/30-day performance history. Benchmarks are not retroactively revised when new vaults are added.

get

Retrieves benchmark APY data for the specified network and benchmark code.

Authorizations
Path parameters
networkstring · enumRequired

Network name or CAIP-2 identifier

Possible values:
Query parameters
codestring · enumRequired

Benchmark code identifier. Available codes: usd, eth

Possible values:
Responses
200

Default Response

application/json
get
GET /v2/benchmarks/{network} HTTP/1.1
Host: api.vaults.fyi
x-api-key: YOUR_API_KEY
Accept: */*

{
  "apy": {
    "1day": {
      "base": 1,
      "reward": 1,
      "total": 1
    },
    "7day": {
      "base": 1,
      "reward": 1,
      "total": 1
    },
    "30day": {
      "base": 1,
      "reward": 1,
      "total": 1
    }
  },
  "timestamp": 1
}
get

Retrieves historical benchmark APY data for the specified network and benchmark code with pagination.

Authorizations
Path parameters
networkstring · enumRequired

Network name or CAIP-2 identifier

Possible values:
Query parameters
pageintegerOptional

Page number (starting from 0)

Default: 0
perPageinteger · max: 20000Optional

Number of items per page

Default: 50
codestring · enumRequired

Benchmark code identifier. Available codes: usd, eth

Possible 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

Default Response

application/json
get
GET /v2/historical-benchmarks/{network} HTTP/1.1
Host: api.vaults.fyi
x-api-key: YOUR_API_KEY
Accept: */*

{
  "itemsOnPage": 1,
  "nextPage": 1,
  "data": [
    {
      "apy": {
        "1day": {
          "base": 1,
          "reward": 1,
          "total": 1
        },
        "7day": {
          "base": 1,
          "reward": 1,
          "total": 1
        },
        "30day": {
          "base": 1,
          "reward": 1,
          "total": 1
        }
      },
      "timestamp": 1
    }
  ]
}
PreviousHistoricalNextPortfolio

Last updated