Get account token balance

To get the balance of tokens for an account, you can submit an account balance query. The account balance query will return the tokens the account holds in a list format.

DEPRECATION NOTICE: AccountBalanceQuery

The AccountBalanceQuery is deprecated and will be completely removed in July 2026. This is the only SDK method presented on this page and it will no longer function after this date.

A gradual throttle reduction begins in May 2026. To avoid rate limiting and future service disruptions, you must migrate to the Mirror Node REST API.

📚 For the full migration guide, read: Migrating from AccountBalanceQuery: What You Need to Know

Recommend Using Mirror Node REST API

For obtaining token information and historical data, consider using the Mirror Node REST API endpoint List Token Balances which offers several advantages:

• Cost-effective and scalable: Mirror node providers offer paid plans with a large number of queries included. The Hedera-hosted mirror node offers free queries with specific throttles for testing. While some SDK queries are currently free, these are subject to change in the future.
• Performance: Mirror nodes don’t burden consensus nodes, allowing them to focus on processing transactions and providing efficient access to historical data without impacting network performance.
• Historical data: Mirror nodes store complete transaction history, records, and events - ideal for analytics, auditing, and monitoring past activity.

📚 For more details on querying data, read: Querying Data on Hedera: SDK vs Mirror Node REST API.

Query Fees

• Please see the transaction and query fees table for the base transaction fee
• Please use the Hedera fee estimator to estimate your query fee cost

Method	Type	Requirement
setAccountId(<accountId>)	AccountId	Required

Java

//Create the query
AccountBalanceQuery query = new AccountBalanceQuery()
    .setAccountId(accountId);

//Sign with the operator private key and submit to a Hedera network
AccountBalance tokenBalance = query.execute(client);

System.out.println("The token balance(s) for this account: " +tokenBalance.tokens);

//v2.0.9