Account Balance
/blockchain-v2/{asset}/accounts/{account}/balance-updates
Last updated
/blockchain-v2/{asset}/accounts/{account}/balance-updates
Last updated
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