---
title: "Get Ethereum Vault Details"
method: GET
path: "/v1/ethereum_yield_vault/{vault_id}"
tags: ["Yield"]
---

# Get Ethereum Vault Details

`GET /v1/ethereum_yield_vault/{vault_id}`

## Request

- Base URL: `https://api.privy.io`
- URL: `https://api.privy.io/v1/ethereum_yield_vault/{vault_id}`
- Auth: HTTP basic

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

## Path parameters

- `vault_id` string, required: The Privy vault ID.

## Headers

- `privy-app-id` string, required: ID of your Privy app.

## Response `200`

Vault details retrieved successfully.

- EthereumVaultDetailsResponse: 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` 'morpho' | 'aave' | 'veda', required: Supported yield/lending protocol providers.
  - `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:4217 for Tempo, eip155:8453 for Base).
  - `user_apy` number, nullable, required: Current annual percentage yield in basis points (e.g., 500 for 5%). 1 basis point = 0.01%.
  - `app_apy` number, nullable, required: Annual percentage yield earned by the app from vault fees, in basis points. Null when APY data is unavailable.
  - `tvl_usd` number, nullable, required: Total value locked in USD.
  - `available_liquidity_usd` number, nullable, required: Assets available for instant withdrawal in USD.

## Changes

- **2026-07-09** `d5a26f68a18a`: 1 warning
  - added the new `veda` enum value to the `provider` response property for the response status `200`

[Operation history](https://skmtc.dev/privy-io/apis/privy-api/changes/v1/ethereum_yield_vault/:vault_id/get.md)

---

[API](https://skmtc.dev/privy-io/apis/privy-api.md) - [All operations](https://skmtc.dev/privy-io/apis/privy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/privy-io/apis/privy-api/revisions/3a2288470053?raw)