Skip to main content


Fetch the historical AccountBalances of a given Account.

Only accounts created with the history flag set retain historical balances. This is off by default.

  • Each balance returned has a corresponding transfer with the same timestamp. See the get_account_transfers operation for more details.

  • The amounts refer to the account balance recorded after the transfer execution.

  • Pending balances automatically removed due to timeout expiration don't change historical balances.


The query filter. See AccountFilter for constraints.


  • If the account has the flag history set and any matching balances exist, return an array of AccountBalances.
  • If the account does not have the flag history set, return nothing.
  • If no matching balances exist, return nothing.
  • If any constraint is violated, return nothing.

Client libraries

For language-specific docs see: