Get Account Balance

In preparation for querying an account for its crypto balance, the first step is to create a Hiero ConsensusClient object. The ConsensusClient object orchestrates the request construction and communication with the Hedera network. It requires a small amount of configuration when created. At a minimum to retrieve an account balance, the client must be configured with a ConsensusNodeEndpoint. The ConsensusNodeEndpoint object represents the internet network address and account for the node processing requests. Querying the balance of an account is free. After creating and configuring the client object, the GetAccountBalanceAsync method submits the request to the network and returns the balance of the account in tinybars. The following code example illustrates a small program performing these actions:

class Program
{
    static async Task Main(string[] args)
    {
        // Usage: dotnet run -- https://2.testnet.hedera.com:50211 0.0.5 0.0.98
        var endpointUrl = args[0];
        if (!EntityId.TryParseShardRealmNum(args[1], out var nodeAccount))
            throw new ArgumentException($"Invalid node account: {args[1]}");
        if (!EntityId.TryParseShardRealmNum(args[2], out var queryAccount))
            throw new ArgumentException($"Invalid query account: {args[2]}");

        try
        {
            await using var client = new ConsensusClient(ctx =>
            {
                ctx.Endpoint = new ConsensusNodeEndpoint(nodeAccount, new Uri(endpointUrl));
            });
            var balance = await client.GetAccountBalanceAsync(queryAccount);
            Console.WriteLine($"Account Balance for {queryAccount} is {balance:#,#} tinybars.");
        }
        catch (Exception ex)
        {
            Console.Error.WriteLine(ex.Message);
            Console.Error.WriteLine(ex.StackTrace);
        }
    }
}