chain

Get Balance

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)

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

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.

Example:1

chainSymbolstring

The abbreviated chain name for queries or transactions.

Example:ETH

blockNumberstring

Block number for which the balance needs to be retrieved. Defaults to the latest block if not specified.

Example:100000

addressstring required

The public address to get the balance of.

Example:0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402

tokenAddressstring

The address of the token to get the balance of.

Example:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

timestampstring

Timestamp of the block number. Takes precedence over block number if both are provided.

Example:1741869257

vsCurrenciesstring

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.

Example:usd,eur,gbp

issuerstring

The public address of the issuer.

Example:GDM4RQUQQUVSKQA7S6EM7XBZP3FCGH4Q7CL6TABQ7B2BEJ5ERARM2M5M

assetCodestring

The code of the asset to get the balance of. Required if issuer address is provided.

Example:VELO

Response

Successful response

statusnumber

Numeric status code indicating success or failure of the API call

msgstring

Human-readable message describing the API result or error

Example response

{
  "status": 200,
  "msg": "success",
  "data": {
    "balance": "0",
    "usdPrice": "4603.59265991327",
    "prices": {
      "usd": [
        {
          "eth": "4603.59265991327"
        }
      ]
    },
    "logoUrl": "https://images.ctfassets.net/hwqnbx905qdp/KB7lTVf04F9d0YQx7Ui4h/589c2efc739b0babc0074dab61d11e71/eip155_1-0x0000000000000000000000000000000000000000.webp",
    "tags": [
      "native"
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.