Get data for multiple vaults

Get a detailed list of vaults filtered by given parameters

get

/v1/detailed/vaults

Authorizations

Query parameters

pageinteger · default: 0

Page number

per_pageinteger · max: 250 · default: 10

Number of items per page

tagsstring[]

List of tags to filter by all of the tags must be present on the vault to be included in the results

tokenstring · min: 1

Name or symbol of the token to filter by

networkstring · enum

Network name or caip to filter by

Options: mainnet, arbitrum, optimism, polygon, base, gnosis, unichain, eip155:1, eip155:42161, eip155:10, eip155:137, eip155:8453, eip155:100, eip155:130

tvl_minnumber

Minimum TVL in USD to filter by

tvl_maxnumber

Maximum TVL in USD to filter by

transactionalOnlystring · enum

Return only vaults that support transactional endpoints

Options: true, false

transactionalFeaturedOnlystring · enum

Return only vaults that support transactional endpoints and are featured in app.vaults.fyi

Options: true, false

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://api.vaults.fyi/v1/detailed/vaults' \
  --header 'x-api-key: YOUR_API_KEY'

200

200

{
  "next_page": 1,
  "data": [
    {
      "name": "text",
      "address": "text",
      "network": "mainnet",
      "protocol": "text",
      "tvlDetails": {
        "tvlNative": "text",
        "tvlUsd": "text",
        "lockedNative": "text",
        "lockedUsd": "text",
        "liquidNative": "text",
        "liquidUsd": "text"
      },
      "numberOfHolders": 1,
      "lendLink": "text",
      "tags": [
        "text"
      ],
      "token": {
        "name": "text",
        "assetAddress": "text",
        "assetCaip": "text",
        "symbol": "text",
        "decimals": 1
      },
      "apy": {
        "base": {
          "1day": 1,
          "7day": 1,
          "30day": 1
        },
        "rewards": {
          "1day": 1,
          "7day": 1,
          "30day": 1
        },
        "total": {
          "1day": 1,
          "7day": 1,
          "30day": 1
        }
      },
      "description": "text",
      "rewards": [
        {
          "apy": {
            "1day": 1,
            "7day": 1,
            "30day": 1
          },
          "assetPriceInUsd": 1,
          "asset": {
            "name": "text",
            "assetAddress": "text",
            "assetCaip": "text",
            "symbol": "text",
            "decimals": 1
          }
        }
      ],
      "isTransactional": true,
      "score": {
        "vaultScore": 1,
        "vaultTvlScore": 1,
        "protocolTvlScore": 1,
        "holderScore": 1,
        "networkScore": 1,
        "assetScore": 1
      }
    }
  ]
}

Default Response