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

# Get earn vault position

`GET /v1/wallets/{wallet_id}/earn/ethereum/vaults`

Retrieve a wallet's current position in a specific earn vault, including deposit/withdraw totals and current onchain vault shares.

## Path parameters

- `wallet_id` string, required — ID of the wallet.

## Query parameters

- `vault_id` string, required — The vault ID to get position for.
- `include_archived` boolean — Include archived wallets in lookup. Defaults to false.

## Headers

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

## Response `200`

Earn vault position retrieved successfully.

- EthereumEarnPositionResponse — A wallet's position in an earn vault.
  - `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").
  - `assets_in_vault` string, required — Current asset value in the vault (realtime from ERC-4626), in smallest unit.
  - `shares_in_vault` string, required — Current vault shares held (realtime from ERC-4626).
  - `total_deposited` string, required — Total amount deposited into the vault, in smallest unit.
  - `total_withdrawn` string, required — Total amount withdrawn from the vault, in smallest unit.

---

[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/versions/bb2eb34156cc/schema)