Get account balance

A query that returns the account balance for the specified account. Requesting an account balance is currently free of charge. Queries do not change the state of the account or require network consensus. The information is returned from a single node processing the query.

Query Fees

  • Please see the transaction and query fees table for base transaction fee

  • Please use the Hedera fee estimator to estimate your query fee cost

Query Signing Requirements

  • The client operator private key is required to sign the query request

Constructor
Description

new AccountBalanceQuery()

Initializes the AccountBalanceQuery object

new AccountBalanceQuery

Methods

Method
Type
Description

setAccountId(<accountId>)

AccountID

The account ID to return the current balance for.

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

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

System.out.println(accountBalance);

//v1.3.2
JavaScript
//Create the query
const query = new AccountBalanceQuery()
     .setAccountId(newAccountId);

//Sign with the client operator account private key and submit to a Hedera network
Hbar accountBalance = await query.execute(client);

console.log(accountBalance);

//v1.4.4

Last updated

#2871: HIP-423 long term scheduled transactions

Change request updated