---
title: "Get balance"
method: GET
path: "/v1/wallets/{wallet_id}/balance"
tags: ["Wallets"]
---

# Get balance

`GET /v1/wallets/{wallet_id}/balance`

Get the balance of a wallet by wallet ID.

## Path parameters

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

## Query parameters

- `asset` union — Named asset(s) to query (e.g. `eth`, `usdc`). Use together with `chain` to scope the query. Cannot be used with `token`.
  - 'usdc' | 'usdc.e' | 'eth' | 'avax' | 'pol' | 'bnb' | 'usdt' | 'eurc' | 'usdb' — A named asset on Ethereum-compatible chains.
  - 'sol' | 'usdc' | 'eurc' | 'usdb' — A named asset on Solana.
  - 'trx' | 'usdt' | 'usdc' — A named asset on Tron.
  - WalletAsset[]
    - union — A named asset supported across all chains.
      - 'usdc' | 'usdc.e' | 'eth' | 'avax' | 'pol' | 'bnb' | 'usdt' | 'eurc' | 'usdb' — A named asset on Ethereum-compatible chains.
      - 'sol' | 'usdc' | 'eurc' | 'usdb' — A named asset on Solana.
      - 'trx' | 'usdt' | 'usdc' — A named asset on Tron.
- `chain` union — Chain(s) to query named assets on (e.g. `base`, `ethereum`). Use together with `asset`. Cannot be used with `token`.
  - 'ethereum' | 'arbitrum' | 'avalanche' | 'base' | 'tempo' | 'linea' | 'optimism' | 'polygon' | 'bsc' | 'solana' | 'tron' | 'zksync_era' | 'sepolia' | 'arbitrum_sepolia' | 'avalanche_fuji' | 'base_sepolia' | 'linea_testnet' | 'optimism_sepolia' | 'polygon_amoy' | 'solana_devnet' | 'solana_testnet' | 'tron_nile' — Supported blockchain network names for wallet balance and transaction queries.
  - WalletAssetChainNameInput[]
- `include_currency` 'usd' | 'eur' — If set, balances are converted to the specified fiat currency. Not supported when `token` is provided.
- `token` union — The token contract address(es) to query in format "chain:address" (e.g., "base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" or "solana:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"). Cannot be used together with `asset`/`chain` or with `include_currency`.
  - string
  - string[]
- `include_archived` boolean — Include archived wallets in lookup. Defaults to false.

## Headers

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

## Response `200`

Latest wallet balance.

- object
  - `balances` object[], required
    - `asset` union, required
      - 'usdc' | 'usdc.e' | 'eth' | 'avax' | 'pol' | 'bnb' | 'usdt' | 'eurc' | 'usdb' — A named asset on Ethereum-compatible chains.
      - 'sol' | 'usdc' | 'eurc' | 'usdb' — A named asset on Solana.
      - 'trx' | 'usdt' | 'usdc' — A named asset on Tron.
      - string
    - `chain` 'ethereum' | 'arbitrum' | 'avalanche' | 'base' | 'tempo' | 'linea' | 'optimism' | 'polygon' | 'bsc' | 'solana' | 'tron' | 'zksync_era' | 'sepolia' | 'arbitrum_sepolia' | 'avalanche_fuji' | 'base_sepolia' | 'linea_testnet' | 'optimism_sepolia' | 'polygon_amoy' | 'solana_devnet' | 'solana_testnet' | 'tron_nile', required — Supported blockchain network names for wallet balance and transaction queries.
    - `display_values` object, required
    - `raw_value` string, required
    - `raw_value_decimals` number, required

## Changes

- **2026-07-02** `21829d464e9b` — 4 warning, 9 info
  - added the new `bnb` enum value to the `balances/items/asset/anyOf[subschema #1: WalletEthereumAsset]/` response property for the response status `200`
  - added the new `bsc` enum value to the `balances/items/chain` response property for the response status `200`
  - added the new `tron` enum value to the `balances/items/chain` response property for the response status `200`
  - added the new `tron_nile` enum value to the `balances/items/chain` response property for the response status `200`
  - …9 more
- **2026-06-12** `41cbc1e43b72` — 1 info
  - added the new optional `query` request parameter `include_archived`
- **2026-06-05** `2e6aabd41a3c` — 3 warning, 2 info
  - added the new `avalanche` enum value to the `balances/items/chain` response property for the response status `200`
  - added the new `avalanche_fuji` enum value to the `balances/items/chain` response property for the response status `200`
  - added the new `avax` enum value to the `balances/items/asset/anyOf[subschema #1: WalletEthereumAsset]/` response property for the response status `200`
  - added the enum value `avax` to the property `anyOf[subschema #1: WalletEthereumAsset]/` of the `query` request parameter `asset`
  - …1 more

[Change history](https://skmtc.dev/privy-io/apis/privy-api/changes/v1/wallets/:wallet_id/balance/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-service-production.skmtc.workers.dev/v1/apis/privy-io/privy-api/revisions/bb2eb34156cc/schema)