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 todayStart 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, v3There’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.
All data is always available and all node requests are consumed as 1 request unit.
JSON-RPC example
Shell
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 thegetAddressBalance
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:
- Show users their current balance.
- Check if an account has sufficient funds before initiating a transaction.
- Monitor balance changes over time for analytics purposes.
Query Parameters
The address to get the balance for
Response
200 - application/json
The balance of the specified address
The balance of the address in nanotons