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

---

[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)