[Etherscan cards] Get top USD, top ETH vault for address

This endpoint is used to power Case Study: Etherscan Cards

Get the best vault for the user

get

/v1/top-vault/{network}//{userAddress}

Authorizations

Path parameters

userAddressstringrequired

User wallet address

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/top-vault/{network}/{userAddress}' \
  --header 'x-api-key: YOUR_API_KEY'

200

200

{
  "userAddress": "text",
  "bestVault": {
    "name": "text",
    "protocol": {
      "name": "text",
      "product": "text",
      "version": "text"
    },
    "vaultAddress": "text",
    "networkName": "mainnet",
    "tvlInUsd": 1,
    "apy": 1,
    "projectedEarnings": 1,
    "asset": {
      "assetAddress": "text",
      "decimals": 1,
      "name": "text",
      "symbol": "text"
    }
  },
  "bestEthVault": {
    "name": "text",
    "protocol": {
      "name": "text",
      "product": "text",
      "version": "text"
    },
    "vaultAddress": "text",
    "networkName": "mainnet",
    "tvlInUsd": 1,
    "apy": 1,
    "projectedEarnings": 1
  }
}

Default Response