Account Balance

/blockchain-v2/{asset}/accounts/{account}/balance-updates

The account balance endpoint allows users to query balance-updates and counter-parties by account with a single request. The endpoint will include full account transaction history and counter-party data.

Field
Description

account

Counterparty account for the transaction that occurred (Account as described in the Atlas overview)

account_creation_height

Block height at creation of account

change

Balance change after this update

previous_balance

Balance of the account prior to the application of this update

new_balance

Balance of the account after this update

transaction_sequence_number

Order of this update inside the transaction that contains it

n_debits

Number of debits

n_credits

Number of credits

previous_debit_height

Block height of the last debit

previous_credit_height

Block height of the last credit

previous_chain_sequence_number

Orders balance updates inside a single transaction to distinguish between serial and parallel balance updates.

sub_account

Sub-account value depends on the asset. Bitcoin value is set to be the reference of the unspent output (concatenation of txHash + offset) Other assets will show values like FREE, FROZEN, STAKED, LOCKED, etc

stale

Indicator if the block is stale

block_hash

Hash of that block (unique per block)

height

Height of that block (number of confirmed blocks since Genesis block)

consensus_time

Consensus timestamp; always increases monotonically

txid

Hash of transaction (transaction ID)

credit

Indicator whether the balance update is a credit or debit of the account

total_received

Total amount received

total_sent

Total amount sent

Last updated