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

> Get the balance of a wallet by wallet ID.

### SDK methods

Learn more about fetching wallet balances using our SDKs [here](/wallets/gas-and-asset-management/assets/fetch-balance).


## OpenAPI

````yaml get /v1/wallets/{wallet_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: Actions
    description: Operations related to looking up wallet actions across an app
  - name: Aggregations
    description: Operations related to aggregations for tracking and measuring metrics
  - name: Apps
    description: Operations related to app settings and allowlist management
  - name: Cards
    description: Operations related to stablecoin-backed card issuing
  - 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 organizations
  - 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: Teams
    description: Operations related to dashboard team management
  - 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: Wallet Automations
    description: Operations related to wallet automations
  - 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/wallets/{wallet_id}/balance:
    get:
      tags:
        - Wallets
      summary: Get balance
      description: Get the balance of a wallet by wallet ID.
      operationId: getWalletBalance
      parameters:
        - schema:
            type: string
            description: ID of the wallet.
          required: true
          name: wallet_id
          in: path
        - schema:
            anyOf:
              - $ref: '#/components/schemas/WalletEthereumAsset'
              - $ref: '#/components/schemas/WalletSolanaAsset'
              - $ref: '#/components/schemas/WalletTronAsset'
              - type: array
                items:
                  $ref: '#/components/schemas/WalletAsset'
                maxItems: 10
            description: >-
              Named asset(s) to query (e.g. `eth`, `usdc`). Use together with
              `chain` to scope the query. Cannot be used with `token`.
          required: false
          name: asset
          in: query
        - schema:
            anyOf:
              - type: string
                enum:
                  - ethereum
                  - arbitrum
                  - avalanche
                  - base
                  - tempo
                  - linea
                  - optimism
                  - polygon
                  - bsc
                  - solana
                  - tron
                  - zksync_era
                  - robinhood
                  - unichain
                  - worldchain
                  - ink
                  - soneium
                  - megaeth
                  - hyperevm
                  - hypercore
                  - arc
                  - tempo_testnet
                  - hoodi
                  - sepolia
                  - arbitrum_sepolia
                  - avalanche_fuji
                  - base_sepolia
                  - linea_testnet
                  - optimism_sepolia
                  - polygon_amoy
                  - bsc_testnet
                  - solana_devnet
                  - solana_testnet
                  - tron_nile
                  - robinhood_testnet
                  - ink_sepolia
              - type: string
              - type: array
                items:
                  $ref: '#/components/schemas/WalletAssetChainNameInput'
                maxItems: 10
            description: >-
              Chain(s) to query named assets on (e.g. `tempo`, `base`). Use
              together with `asset`. Cannot be used with `token`.
          required: false
          name: chain
          in: query
        - schema:
            type: string
            enum:
              - usd
              - eur
            description: >-
              If set, balances are converted to the specified fiat currency. Not
              supported when `token` is provided.
          required: false
          name: include_currency
          in: query
        - schema:
            anyOf:
              - type: string
              - type: array
                items:
                  type: string
                maxItems: 10
            description: >-
              The token contract address(es) to query in format "chain:address"
              (e.g., "tempo:0x20c000000000000000000000b9537d11c60e8b50" or
              "solana:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"). Cannot be
              used together with `asset`/`chain` or with `include_currency`.
          required: false
          name: token
          in: query
        - schema:
            type: boolean
            description: Include archived wallets in lookup. Defaults to false.
          required: false
          name: include_archived
          in: query
        - schema:
            type: string
            description: ID of your Privy app.
          required: true
          name: privy-app-id
          in: header
      responses:
        '200':
          description: Latest wallet balance.
          content:
            application/json:
              schema:
                type: object
                properties:
                  balances:
                    type: array
                    items:
                      type: object
                      properties:
                        chain:
                          $ref: '#/components/schemas/WalletAssetChainNameInput'
                        asset:
                          anyOf:
                            - $ref: '#/components/schemas/WalletEthereumAsset'
                            - $ref: '#/components/schemas/WalletSolanaAsset'
                            - $ref: '#/components/schemas/WalletTronAsset'
                            - type: string
                        raw_value:
                          type: string
                        raw_value_decimals:
                          type: number
                        display_values:
                          type: object
                          additionalProperties:
                            type: string
                      required:
                        - chain
                        - asset
                        - raw_value
                        - raw_value_decimals
                        - display_values
                required:
                  - balances
              example:
                balances:
                  - chain: tempo
                    asset: ousd
                    raw_value: '1000000'
                    raw_value_decimals: 6
                    display_values:
                      ousd: '1'
                      usd: '1'
      security:
        - appSecretAuth: []
components:
  schemas:
    WalletEthereumAsset:
      type: string
      enum:
        - usdc
        - usdc.e
        - eth
        - avax
        - pol
        - bnb
        - usdt
        - eurc
        - usdb
        - ousd
        - pathusd
      description: A named asset on Ethereum-compatible chains.
      title: WalletEthereumAsset
      x-stainless-model: wallets.wallet_ethereum_asset
    WalletSolanaAsset:
      type: string
      enum:
        - sol
        - usdc
        - eurc
        - usdb
        - ousd
      description: A named asset on Solana.
      title: WalletSolanaAsset
      x-stainless-model: wallets.wallet_solana_asset
    WalletTronAsset:
      type: string
      enum:
        - trx
        - usdt
        - usdc
      description: A named asset on Tron.
      title: WalletTronAsset
      x-stainless-model: wallets.wallet_tron_asset
    WalletAsset:
      anyOf:
        - $ref: '#/components/schemas/WalletEthereumAsset'
        - $ref: '#/components/schemas/WalletSolanaAsset'
        - $ref: '#/components/schemas/WalletTronAsset'
      description: A named asset supported across all chains.
      title: WalletAsset
      x-stainless-model: wallets.wallet_asset
    WalletAssetChainNameInput:
      anyOf:
        - type: string
          enum:
            - ethereum
            - arbitrum
            - avalanche
            - base
            - tempo
            - linea
            - optimism
            - polygon
            - bsc
            - solana
            - tron
            - zksync_era
            - robinhood
            - unichain
            - worldchain
            - ink
            - soneium
            - megaeth
            - hyperevm
            - hypercore
            - arc
            - tempo_testnet
            - hoodi
            - sepolia
            - arbitrum_sepolia
            - avalanche_fuji
            - base_sepolia
            - linea_testnet
            - optimism_sepolia
            - polygon_amoy
            - bsc_testnet
            - solana_devnet
            - solana_testnet
            - tron_nile
            - robinhood_testnet
            - ink_sepolia
        - type: string
      description: >-
        Supported blockchain network names for wallet balance and transaction
        queries.
      title: WalletAssetChainNameInput
      x-stainless-model: wallets.wallet_asset_chain_name_input
  securitySchemes:
    appSecretAuth:
      type: http
      scheme: basic
      description: >-
        Basic Auth header with your app ID as the username and your app secret
        as the password.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.