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