> ## 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: 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/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'
              - 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:
              - $ref: '#/components/schemas/WalletAssetChainNameInput'
              - type: array
                items:
                  $ref: '#/components/schemas/WalletAssetChainNameInput'
                maxItems: 10
            description: >-
              Chain(s) to query named assets on (e.g. `base`, `ethereum`). 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., "base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" 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'
                            - 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: base
                    asset: eth
                    raw_value: '1000000000000000000'
                    raw_value_decimals: 18
                    display_values:
                      eth: '0.001'
                      usd: '2.56'
      security:
        - appSecretAuth: []
components:
  schemas:
    WalletEthereumAsset:
      type: string
      enum:
        - usdc
        - usdc.e
        - eth
        - avax
        - pol
        - usdt
        - eurc
        - usdb
      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
      description: A named asset on Solana.
      title: WalletSolanaAsset
      x-stainless-model: wallets.wallet_solana_asset
    WalletAsset:
      anyOf:
        - $ref: '#/components/schemas/WalletEthereumAsset'
        - $ref: '#/components/schemas/WalletSolanaAsset'
      description: A named asset supported across all chains.
      title: WalletAsset
      x-stainless-model: wallets.wallet_asset
    WalletAssetChainNameInput:
      type: string
      enum:
        - ethereum
        - arbitrum
        - avalanche
        - base
        - tempo
        - linea
        - optimism
        - polygon
        - solana
        - zksync_era
        - sepolia
        - arbitrum_sepolia
        - avalanche_fuji
        - base_sepolia
        - linea_testnet
        - optimism_sepolia
        - polygon_amoy
        - solana_devnet
        - solana_testnet
      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.

````