v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB

Yield

Get Ethereum Vault Details

Retrieve detailed information about an ethereum yield vault, including current APY and liquidity.

get/v1/ethereum_yield_vault/{vault_id}

Path parameters

vault_idstring required

The Privy vault ID.

Headers

privy-app-idstring required

ID of your Privy app.

Response

Vault details retrieved successfully.

app_apynumber nullable required

Annual percentage yield earned by the app from fee wrapper fees, in basis points. Null when APY data is unavailable.

asset_addressstring required

Underlying asset token address.

available_liquidity_usdnumber nullable required

Assets available for instant withdrawal in USD.

caip2string required

Chain identifier (e.g., eip155:8453).

idstring required

Vault identifier.

namestring required

Human-readable vault name from the yield provider.

provider'morpho' | 'aave' | 'veda' required

Supported yield/lending protocol providers.

tvl_usdnumber nullable required

Total value locked in USD.

user_apynumber nullable required

Current annual percentage yield in basis points (e.g., 500 for 5%). 1 basis point = 0.01%.

vault_addressstring required

On-chain vault contract address.

Example response

{
  "app_apy": 50,
  "asset_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "available_liquidity_usd": 500000,
  "caip2": "eip155:1",
  "id": "cm7oxq1el000e11o8iwp7d0d0",
  "name": "Gauntlet USDC Prime",
  "provider": "morpho",
  "tvl_usd": 1000000,
  "user_apy": 500,
  "vault_address": "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145"
}