---
title: "Get account balance"
method: GET
path: "/v1/accounts/{account_id}/balance"
tags: ["Accounts"]
---

# Get account balance

`GET /v1/accounts/{account_id}/balance`

Get the balance of an account, aggregated across all wallets and supported chains.

## Path parameters

- `account_id` string, required — ID of the account.

## Query parameters

- `testnet_mode` 'true' | 'false' — When set to true, returns balances from testnet chains instead of mainnets.

## Headers

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

## Response `200`

The account balance.

- AccountBalanceResponse — The balance of a digital asset account, aggregated across all wallets and supported chains.
  - `assets` BalanceAsset[], required — The individual asset balances, each computed across all supported chains.
    - `amount` string, required — The amount of the asset held, denominated in the unit of the asset itself, with 1 decimal of precision.
    - `price` object, required — The price of the asset in the provided currency.
      - `currency` 'usd', required — Currency code
      - `value` string, required — The monetary value as a string.
    - `symbol` string, required — The symbol of the asset (e.g. USDC, ETH).
  - `assets_by_chain` BalanceAssetByChain[] — Individual asset balances per chain.
    - `amount` string, required — The amount of the asset held on this chain, denominated in the unit of the asset itself.
    - `chain_id` string, required — The CAIP-2 chain identifier (e.g. eip155:8453).
    - `price` object, required — The price of the asset in the provided currency.
      - `currency` 'usd', required — Currency code
      - `value` string, required — The monetary value as a string.
    - `symbol` string, required — The symbol of the asset (e.g. USDC, ETH).
  - `total` object, required — The total balance across all assets.
    - `currency` 'usd', required — Currency code
    - `value` string, required — The monetary value as a string.

---

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