---
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`

## Request

- Base URL: `https://api.privy.io`
- URL: `https://api.privy.io/v1/wallets/{wallet_id}/earn/ethereum/vaults`
- Auth: HTTP basic

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.
    - `symbol` string, required: Lowercase token symbol (e.g. "usdc").
    - `decimals` integer, required: Number of decimals for the asset (e.g. 6 for USDC).
  - `apy_bps` integer: Wallet-specific net APY in basis points, rounded to the nearest integer. Returned together with apy_allocation when available.
  - `apy_allocation` EarnPositionApyAllocation[]: Vault APY allocations by origin, returned together with apy_bps when available.
    - `apy_bps` integer, required: Net APY in basis points, rounded to the nearest integer.
    - `assets_in_vault` string, required: Allocated assets in the smallest unit of the underlying asset.
    - `type` 'boost' | 'base', required: Whether an APY allocation earns the base or boosted rate.
  - `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.
  - `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).

## Changes

- **2026-10-16** `4facbfa7f9d4`: 2 info
  - added the optional property `apy_allocation` to the response with the `200` status
  - added the optional property `apy_bps` to the response with the `200` status
- **2026-06-12** `41cbc1e43b72`: 1 info
  - added the new optional `query` request parameter `include_archived`

[Operation history](https://skmtc.dev/privy-io/apis/privy-api/changes/v1/wallets/:wallet_id/earn/ethereum/vaults/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)