Balance Updates
/blockchain/{asset}/balance-updates
Balance updates represent the change in the balance of an account. If the change is grater-or-equal to 0, it is considered a credit. Otherwise, it is considered a debit. In certain circumstances, there can be 0-valued balance updates (used to represent 0 fee transactions, for example, which were frequent in Bitcoin's early history).
The Balance Updates endpoint returns a list of accounts, which have the following fields:
Field
Description
block_hash
Hash of block containing the transaction affecting the balance
height
Height of the block containing the transaction affecting the balance
consensus_time
Consensus timestamp; always increases monotonically
chain_sequence_number
Global sequence number or ordering of this update relative to all other updates recorded on the ledger up until this point
account
Account receiving a balance change
account_creation_height
Block height at account creation
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
Order of this update inside the transaction that contains it
previous_n_debits
Number of times this account has been debited prior to this update
previous_n_credits
Number of times this account has been credited prior to this update
transaction_hash
Hash of the transaction containing the balance update
previous_debit_height
Block height of the last debit from this account (null if no prior debit)
previous_credit_height
Block height of the last credit from this account (null if no prior credit)
previous_chain_sequence_number
The positioning of the last transaction that took place for this account relative to all other transactions that have taken place on this chain
Last modified 5mo ago
Copy link