---
title: "Get Balance"
method: GET
path: "/defi/v1/chain/getbalance"
tags: ["chain"]
---

# Get Balance

`GET /defi/v1/chain/getbalance`

## Request

- Base URL: `https://svc.blockdaemon.com`
- URL: `https://svc.blockdaemon.com/defi/v1/chain/getbalance`
- Auth: API key in header `X-API-Key`

retrieves the current token balance for a specified wallet address on supported blockchain networks, with optional filtering by asset codes and issuers. It returns precise balance data essential for real-time portfolio tracking, fee calculations, and wallet-related operations in decentralized applications

> 💡 
**Compute Unit Value:** `50` (Fixed)

## Query parameters

- `chainId` '1' | '11155111' | '56' | '25' | '97' | '43114' | '338' | '900' | '901' | '1000' | '1002' | '1200' | '1201' | '43113' | '42161' | '421614' | '10' | '11155420' | '4002' | '324' | '300' | '1300' | '1301' | 'cosmoshub-4' | '1600' | '1601' | '1700' | '1701' | 'osmosis-1' | 'osmo-test-5' | '1800' | '137' | '80002' | '250' | '8453' | '84532' | '1400' | '1401' | '400' | '401' | '1100' | '1101' | '1500' | '1501' | '17000' | '5000' | '5003' | '560048' | '8217' | '1001': The unique ID to direct queries or transactions to the correct blockchain. Find more [here](https://docs.blockdaemon.com/docs/defi-api-supported-protocols#supported-chains).
- `chainSymbol` string: The abbreviated chain name for queries or transactions.
- `blockNumber` string: Block number for which the balance needs to be retrieved. Defaults to the latest block if not specified.
- `address` string, required: The public address to get the balance of.
- `tokenAddress` string: The address of the token to get the balance of.
- `timestamp` string: Timestamp of the block number. Takes precedence over block number if both are provided.
- `vsCurrencies` string: A comma-separated list of currency symbols to convert the amount into, such as 'USD,EUR'. This parameter is optional and allows retrieving values in multiple fiat currencies.
- `issuer` string: The public address of the issuer.
- `assetCode` string: The code of the asset to get the balance of. Required if issuer address is provided.

## Response `200`

Successful response

- object
  - `status` number: Numeric status code indicating success or failure of the API call
  - `msg` string: Human-readable message describing the API result or error
  - `data` object
    - `balance` string, required: Account or token balance
    - `totalReceived` string: Total received amount
    - `totalSent` string: Total sent amount
    - `utxos` object[]: List of unspent transaction outputs
      - `block` string, required: Block number
      - `txHash` string, required: Transaction hash
      - `value` string, required: Amount being transferred or involved in a transaction
      - `refBalance` string, required: Reference balance at the time of UTXO
      - `txInputN` string, required: Transaction input index
      - `txOutputN` string, required: Transaction output index
      - `confirmations` string, required: Number of confirmations
      - `spent` boolean: Boolean indicating whether the UTXO is spent
    - `assetCode` string: Unique asset code (e.g., for Stellar or other chains)
    - `issuer` string: Entity or address issuing the token
    - `usdPrice` string: Price of the asset in USD
    - `logoUrl` string, nullable: URL for the asset's logo
    - `tags` string[], nullable: List of category or classification tags
    - `prices` object: Price data object
      - `usd` object[], required: USD-denominated price or array of price points

---

[API](https://skmtc.dev/blockdaemon/apis/blockdaemon-defi-api.md) - [All operations](https://skmtc.dev/blockdaemon/apis/blockdaemon-defi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blockdaemon/apis/blockdaemon-defi-api/revisions/ec053b7c8041?raw)