v46

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

Get account balance

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

get/v1/accounts/{account_id}/balance

Path parameters

account_idstring 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-idstring required

ID of your Privy app.

Response

The account balance.

Example response

{
  "assets": [
    {
      "price": {
        "currency": "usd",
        "value": "100.00"
      }
    }
  ],
  "assets_by_chain": [
    {
      "price": {
        "currency": "usd",
        "value": "100.00"
      }
    }
  ],
  "total": {
    "currency": "usd",
    "value": "100.00"
  }
}