Get data on single vault

Get a vault information given a specific address and network

get

/v1/vaults/{network}//{vaultAddress}//

Authorizations

Path parameters

vaultAddressstringrequired

Address of a vault

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

networkstring · enumrequired

Network name or caip

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

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://api.vaults.fyi/v1/vaults/{network}/{vaultAddress}/' \
  --header 'x-api-key: YOUR_API_KEY'

200

200

{
  "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
  },
  "assetPriceInUsd": 1,
  "topHolders": [
    {
      "address": "text",
      "balance": "text"
    }
  ],
  "holdersTotalBalance": "text"
}

Object describing the vault