getAddressBalance | TON v2

The getAddressBalance method retrieves the balance of a specific address on the TON blockchain. This method provides a straightforward way to check the current balance of any TON address.

👍

Get you own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

JSON-RPC example

curl -X POST \
  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/jsonRPC' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getAddressBalance",
    "params": {
      "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"
    }
  }'

Parameters

• address (string, required) — The address for which to retrieve the balance. Example: EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2.

Response

• balance (string) — The balance of the address in nanotons. 1 TON = 1,000,000,000 nanotons.

Use case

A possible use case for the getAddressBalance method in TON is for wallet applications, blockchain explorers, or any DApp that needs to display or work with account balances. This method can be used to:

1. Show users their current balance.
2. Check if an account has sufficient funds before initiating a transaction.
3. Monitor balance changes over time for analytics purposes.

Try the getAddressBalance RPC method yourself