GET
/
getAddressBalance
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getAddressBalance
{
  "balance": "<string>"
}

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.

TON pricing is the same for full, archive, v2, v3

There’s no difference between a full node an archive node in data availability or pricing.
All data is always available and all node requests are consumed as 1 request unit.

JSON-RPC example

Shell
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.

Query Parameters

address
string
default:EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2
required

The address to get the balance for

Response

200 - application/json
The balance of the specified address
balance
string

The balance of the address in nanotons