Nano Node RPC icon

Nano Node RPC

Interact with Nano cryptocurrency network

Actions111

Wallet → Get Wallet Balances

AI-generated

Summary

Retrieve balances for accounts in a specified Nano wallet, optionally filtering by a minimum raw balance threshold.

Inputs

  • manualWalletId — Specify the wallet ID to query; if omitted, defaults to the wallet defined in the node's credentials.
  • balanceThreshold — Set a minimum balance in raw units to filter accounts; accounts with balances below this threshold will be excluded.
  • options.timeout — Configure the request timeout in milliseconds. Defaults to 15000 ms, with allowed range from 1000 to 600000.
  • options.maxRetries — Set how many times to retry the RPC call on transient failures before aborting. Defaults to 2 retries.

Output shape

a JSON object listing accounts in the specified wallet with their balances, filtered according to the optional balance threshold

The balance threshold input is provided as a string representing the minimum raw amount. The output includes only accounts with balances equal to or exceeding this threshold if set. Requests may retry transient RPC failures up to the configured maxRetries; request timeouts adhere to the specified timeout option.

Examples

Example 1: Retrieve balances for the default credential wallet without filtering

Omit manualWalletId and balanceThreshold inputs to get balances of all accounts in the default wallet.

Example 2: Get wallet balances with a minimum balance filter

Set manualWalletId to a specific wallet ID and define balanceThreshold (e.g., 1000000000000000000000000) to list only accounts meeting or exceeding this raw balance.

Links

Discussion