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

apiKey

x-api-keystringRequired

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

timestampintegerRequired

Timestamp of the benchmark data point

400

Default Response

application/json

401

Default Response

application/json

402

Default Response

application/json

403

Default Response

application/json

404

Default Response

application/json

408

Default Response

application/json

500

Default Response

application/json

503

Default Response

application/json

get

/v2/benchmarks/{network}

HTTPcURLJavaScriptPython

GET /v2/benchmarks/{network}?code=usd 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

apiKey

x-api-keystringRequired

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

itemsOnPageintegerRequired

Number of items on the current page

nextPageintegerOptional

Next page number

400

Default Response

application/json

401

Default Response

application/json

402

Default Response

application/json

403

Default Response

application/json

404

Default Response

application/json

408

Default Response

application/json

500

Default Response

application/json

503

Default Response

application/json

get

/v2/historical-benchmarks/{network}

HTTPcURLJavaScriptPython

GET /v2/historical-benchmarks/{network}?code=usd 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
    }
  ]
}