---
title: "Get earn vault details"
method: GET
path: "/v1/earn/ethereum/vaults/{vault_id}"
tags: ["Wallet Actions"]
---

# Get earn vault details

`GET /v1/earn/ethereum/vaults/{vault_id}`

Retrieve detailed information about an earn 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.

- union — Detailed vault information including current APY, liquidity, and asset metadata. Discriminated on provider.
  - object — Vault details for an Aave earn vault, including fee visibility.
    - `admin_wallet_address` string, required — EVM address of the vault admin wallet.
    - `admin_wallet_id` string, required — Privy wallet ID of the vault admin.
    - `app_apy` number, nullable, required — Annual percentage yield earned by the app from fee wrapper fees, in basis points.
    - `asset` EarnAsset, required — Asset metadata for an earn vault position.
      - `address` string, required — Token contract address.
      - `decimals` integer, required — Number of decimals for the asset (e.g. 6 for USDC).
      - `symbol` string, required — Lowercase token symbol (e.g. "usdc").
    - `available_fees` string, required — Fees available to collect, in smallest unit of the underlying asset.
    - `available_liquidity_usd` number, nullable, required — Available liquidity in USD.
    - `caip2` string, required — CAIP-2 chain identifier (e.g. "eip155:8453").
    - `id` string, required — Vault identifier.
    - `name` string, required — Human-readable vault name from the yield provider.
    - `provider` 'aave', required
    - `tvl_usd` number, nullable, required — Total value locked in USD.
    - `user_apy` number, nullable, required — Annual percentage yield available to the user, after fees and excluding rewards, in basis points (e.g. 500 for 5%). 1 basis point = 0.01%.
    - `vault_address` string, required — Onchain vault contract address.
  - object — Vault details for a Morpho earn vault.
    - `admin_wallet_address` string, required — EVM address of the vault admin wallet.
    - `admin_wallet_id` string, required — Privy wallet ID of the vault admin.
    - `app_apy` number, nullable, required — Annual percentage yield earned by the app from fee wrapper fees, in basis points.
    - `asset` EarnAsset, required — Asset metadata for an earn vault position.
      - `address` string, required — Token contract address.
      - `decimals` integer, required — Number of decimals for the asset (e.g. 6 for USDC).
      - `symbol` string, required — Lowercase token symbol (e.g. "usdc").
    - `available_liquidity_usd` number, nullable, required — Available liquidity in USD.
    - `caip2` string, required — CAIP-2 chain identifier (e.g. "eip155:8453").
    - `id` string, required — Vault identifier.
    - `name` string, required — Human-readable vault name from the yield provider.
    - `provider` 'morpho', required
    - `total_rewards_apr` number, required — Total rewards annual percentage rate in basis points.
    - `tvl_usd` number, nullable, required — Total value locked in USD.
    - `user_apy` number, nullable, required — Annual percentage yield available to the user, after fees and excluding rewards, in basis points (e.g. 500 for 5%). 1 basis point = 0.01%.
    - `vault_address` string, required — Onchain vault contract address.
  - object — Vault details for a Veda (BoringVault) earn vault.
    - `admin_wallet_address` string, required — EVM address of the vault admin wallet.
    - `admin_wallet_id` string, required — Privy wallet ID of the vault admin.
    - `app_apy` number, nullable, required — Annual percentage yield earned by the app from fee wrapper fees, in basis points.
    - `asset` EarnAsset, required — Asset metadata for an earn vault position.
      - `address` string, required — Token contract address.
      - `decimals` integer, required — Number of decimals for the asset (e.g. 6 for USDC).
      - `symbol` string, required — Lowercase token symbol (e.g. "usdc").
    - `available_liquidity_usd` number, nullable, required — Available liquidity in USD.
    - `caip2` string, required — CAIP-2 chain identifier (e.g. "eip155:8453").
    - `id` string, required — Vault identifier.
    - `name` string, required — Human-readable vault name from the yield provider.
    - `provider` 'veda', required
    - `tvl_usd` number, nullable, required — Total value locked in USD.
    - `user_apy` number, nullable, required — Annual percentage yield available to the user, after fees and excluding rewards, in basis points (e.g. 500 for 5%). 1 basis point = 0.01%.
    - `vault_address` string, required — Onchain vault contract address.

---

[API](https://skmtc.net/privy-io/apis/privy-api.md) · [All operations](https://skmtc.net/privy-io/apis/privy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/privy-io/privy-api/revisions/bb2eb34156cc/schema)