Skip to main content

​
List Vaults

Returns all available vaults. Optionally filter by chain or asset. 
GET /v1/vaults

​
Query Parameters

ParameterTypeRequiredDescription
chain_idintegerNoFilter by chain ID (e.g. 8453)
assetstringNoFilter by asset symbol (e.g. usdc)

​
Response

Returns an array of vault objects. 
[
  {
    "vault_id": "1:0x014e6da8f283c4af65b2aa0f201438680a004452",
    "name": "Lido Earn USD",
    "address": "0x014e6dA8F283c4Af65B2aa0F201438680a004452",
    "chain_id": 1,
    "chain_name": "Ethereum",
    "asset": {
      "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "symbol": "usdt",
      "decimals": 6
    },
    "accepted_assets": [
      { "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7", "symbol": "usdt", "decimals": 6 },
      { "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "symbol": "usdc", "decimals": 6 }
    ],
    "deposit_router": "0x85f76c1685046Ea226E1148EE1ab81a8a15C385d",
    "type": "lido",
    "paused": false
  }
]

​
Response Fields

FieldTypeDescription
vault_idstringUnique identifier for the vault (<chain_id>:<address>)
namestringHuman-readable vault name
addressstringVault contract address
chain_idintChain ID where the vault is deployed
chain_namestringHuman-readable chain name
assetobjectPrimary deposit asset (used as the default for swaps)
asset.addressstringAsset token contract address
asset.symbolstringAsset token symbol
asset.decimalsintAsset token decimals
accepted_assetsarrayAll tokens this vault accepts as direct deposits (no swap). Defaults to [asset] for single-asset vaults. Use this to surface multi-asset deposit options in your UI.
deposit_routerstringDeposit router contract address
typestringVault type (morpho, lido, veda, midas, ipor, etc.)
pausedboolTrue when deposits are temporarily disabled upstream
paused_reasonstring/nullHuman-readable reason when paused=true
min_depositstring/nullMinimum deposit amount (raw units) when the vault enforces one

​
Example

# All vaults
curl https://api.yieldo.xyz/v1/vaults

# USDC vaults on Base only
curl "https://api.yieldo.xyz/v1/vaults?chain_id=8453&asset=usdc"

​
Get Vault Details

Returns detailed information about a specific vault, including on-chain data like total assets, total supply, and share price. 
GET /v1/vaults/{vault_id}

​
Path Parameters

ParameterTypeRequiredDescription
vault_idstringYesThe vault ID

​
Response

{
  "vault_id": "base-steakhouse-prime-usdc",
  "name": "Steakhouse Prime USDC",
  "address": "0xBEEFE94c8aD530842bfE7d8B397938fFc1cb83b2",
  "chain_id": 8453,
  "chain_name": "Base",
  "asset": {
    "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "symbol": "USDC",
    "decimals": 6
  },
  "deposit_router": "0xF6B7723661d52E8533c77479d3cad534B4D147Aa",
  "type": "erc4626",
  "total_assets": "15000000000000",
  "total_supply": "14800000000000",
  "share_price": "1013513513513513513"
}

​
Additional Fields

FieldTypeDescription
total_assetsstring/nullTotal assets in the vault (raw units)
total_supplystring/nullTotal vault shares in circulation
share_pricestring/nullPrice per share scaled to 18 decimals

​
Errors

StatusDescription
404Vault not found