Skip to main content
GET
/
v1
/
ethereum_yield_vault
/
{vault_id}
Get Ethereum Vault Details
curl --request GET \
  --url https://api.privy.io/v1/ethereum_yield_vault/{vault_id} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'privy-app-id: <privy-app-id>'
{
  "id": "cm7oxq1el000e11o8iwp7d0d0",
  "name": "Gauntlet USDC Prime",
  "provider": "morpho",
  "vault_address": "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145",
  "asset_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "caip2": "eip155:1",
  "user_apy": 500,
  "app_apy": 50,
  "tvl_usd": 1000000,
  "available_liquidity_usd": 500000
}

Authorizations

​
Authorization
string
header
required

Basic Auth header with your app ID as the username and your app secret as the password.

Headers

​
privy-app-id
string
required

ID of your Privy app.

Path Parameters

​
vault_id
string
required

The Privy vault ID.

Response

200 - application/json

Vault details retrieved successfully.

Detailed vault information including current APY and liquidity.

​
id
string
required

Vault identifier.

​
name
string
required

Human-readable vault name from the yield provider.

​
provider
enum<string>
required

Supported yield/lending protocol providers.

Available options:
morpho,
aave
​
vault_address
string
required

On-chain vault contract address.

​
asset_address
string
required

Underlying asset token address.

​
caip2
string
required

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

​
user_apy
number | null
required

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

​
app_apy
number | null
required

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

​
tvl_usd
number | null
required

Total value locked in USD.

​
available_liquidity_usd
number | null
required

Assets available for instant withdrawal in USD.