v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB

Wallet Actions

Get earn vault position

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

get/v1/wallets/{wallet_id}/earn/ethereum/vaults

Path parameters

wallet_idstring required

ID of the wallet.

Query parameters

vault_idstring required

The vault ID to get position for.

include_archivedboolean

Include archived wallets in lookup. Defaults to false.

Headers

privy-app-idstring required

ID of your Privy app.

Response

Earn vault position retrieved successfully.

assets_in_vaultstring required

Current asset value in the vault (realtime from ERC-4626), in smallest unit.

shares_in_vaultstring required

Current vault shares held (realtime from ERC-4626).

total_depositedstring required

Total amount deposited into the vault, in smallest unit.

total_withdrawnstring required

Total amount withdrawn from the vault, in smallest unit.

Example response

{
  "asset": {
    "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "decimals": 6,
    "symbol": "usdc"
  },
  "assets_in_vault": "1050000",
  "shares_in_vault": "1000000000000000000",
  "total_deposited": "1000000",
  "total_withdrawn": "0"
}