> ## Documentation Index
> Fetch the complete documentation index at: https://docs.privy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get account balance

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



## OpenAPI

````yaml get /v1/accounts/{account_id}/balance
openapi: 3.1.0
info:
  version: 0.0.1
  title: Privy API
  description: >-
    REST API for Privy's wallet infrastructure — provision and manage wallets
    across EVM, Solana, and Bitcoin, authenticate users, sign transactions, and
    configure programmable policies and authorization intents.
  contact:
    name: Privy
    url: https://www.privy.io/
    email: support@privy.io
servers:
  - url: https://api.privy.io
security: []
tags:
  - name: Accounts
    description: Operations related to asset accounts
  - name: Aggregations
    description: Operations related to aggregations for tracking and measuring metrics
  - name: Apps
    description: Operations related to app settings and allowlist management
  - name: Client Auth
    description: OAuth token exchange and device authorization operations
  - name: Condition Sets
    description: Operations related to condition sets
  - name: Embedded wallets
    description: Operations related to embedded wallet creation and authentication
  - name: Fiat
    description: Operations related to fiat onramping and offramping
  - name: Intents
    description: Operations related to authorization intents for wallet actions
  - name: Key quorums
    description: Operations related to key quorums
  - name: Kraken Embed
    description: >-
      Operations for Kraken Embed integration, including quotes, trades, user
      management, and portfolio operations
  - name: OAuth
    description: >-
      OAuth 2.0 endpoints including Device Authorization Grant (RFC 8628) for
      CLI and limited-input device login flows
  - name: Organizations
    description: Operations related to organization secret management
  - name: Policies
    description: Operations related to policies
  - name: Shared
    description: Common schemas shared across resources
  - name: Swaps
    description: Operations for swapping tokens within wallets
  - name: Transactions
    description: Operations related to transactions
  - name: User signers
    description: Operations related to user signers
  - name: Users
    description: Operations related to users
  - name: Wallet Actions
    description: Operations related to wallet actions
  - name: Wallets
    description: Operations related to wallets
  - name: Webhooks
    description: >-
      Webhook events that Privy sends to your configured endpoint when specific
      actions occur in your app
  - name: Yield
    description: >-
      Operations for depositing and withdrawing funds from ERC-4626 yield vaults
      (Morpho, Aave)
paths:
  /v1/accounts/{account_id}/balance:
    get:
      tags:
        - Accounts
      summary: Get account balance
      description: >-
        Get the balance of an account, aggregated across all wallets and
        supported chains.
      operationId: getAccountBalance
      parameters:
        - schema:
            type: string
            minLength: 1
            description: ID of the account.
          required: true
          name: account_id
          in: path
        - schema:
            $ref: '#/components/schemas/ChainTestnetMode'
          required: false
          name: testnet_mode
          in: query
        - schema:
            type: string
            description: ID of your Privy app.
          required: true
          name: privy-app-id
          in: header
      responses:
        '200':
          description: The account balance.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountBalanceResponse'
      security:
        - appSecretAuth: []
components:
  schemas:
    ChainTestnetMode:
      type: string
      enum:
        - 'true'
        - 'false'
      description: >-
        When set to true, returns balances from testnet chains instead of
        mainnets.
      title: ChainTestnetMode
      x-stainless-model: accounts.chain_testnet_mode
    AccountBalanceResponse:
      type: object
      properties:
        total:
          allOf:
            - $ref: '#/components/schemas/CurrencyAmount'
            - description: The total balance across all assets.
        assets:
          type: array
          items:
            $ref: '#/components/schemas/BalanceAsset'
          description: >-
            The individual asset balances, each computed across all supported
            chains.
        assets_by_chain:
          type: array
          items:
            $ref: '#/components/schemas/BalanceAssetByChain'
          description: Individual asset balances per chain.
      required:
        - total
        - assets
      description: >-
        The balance of a digital asset account, aggregated across all wallets
        and supported chains.
      title: AccountBalanceResponse
      x-stainless-model: accounts.account_balance_response
    CurrencyAmount:
      type: object
      properties:
        value:
          type: string
          description: The monetary value as a string.
        currency:
          type: string
          enum:
            - usd
          description: Currency code
      required:
        - value
        - currency
      description: A monetary value with its currency denomination.
      title: CurrencyAmount
      example:
        value: '100.00'
        currency: usd
      x-stainless-model: shared.currency_amount
    BalanceAsset:
      type: object
      properties:
        symbol:
          type: string
          description: The symbol of the asset (e.g. USDC, ETH).
        amount:
          type: string
          description: >-
            The amount of the asset held, denominated in the unit of the asset
            itself, with 1 decimal of precision.
        price:
          allOf:
            - $ref: '#/components/schemas/CurrencyAmount'
            - description: The price of the asset in the provided currency.
      required:
        - symbol
        - amount
        - price
      description: >-
        A single asset entry in a balance, representing holdings across all
        supported chains.
      title: BalanceAsset
      x-stainless-model: accounts.balance_asset
    BalanceAssetByChain:
      type: object
      properties:
        symbol:
          type: string
          description: The symbol of the asset (e.g. USDC, ETH).
        amount:
          type: string
          description: >-
            The amount of the asset held on this chain, denominated in the unit
            of the asset itself.
        price:
          allOf:
            - $ref: '#/components/schemas/CurrencyAmount'
            - description: The price of the asset in the provided currency.
        chain_id:
          type: string
          description: The CAIP-2 chain identifier (e.g. eip155:8453).
      required:
        - symbol
        - amount
        - price
        - chain_id
      description: A single asset entry scoped to a specific chain.
      title: BalanceAssetByChain
      x-stainless-model: accounts.balance_asset_by_chain
  securitySchemes:
    appSecretAuth:
      type: http
      scheme: basic
      description: >-
        Basic Auth header with your app ID as the username and your app secret
        as the password.

````