Unified Confirmed Balance

This event is sent under the following conditions:

Balance events are emitted once per block whenever a balance changes.
Balances are emitted per asset, per address, and per block. If multiple transactions within the same block change a balance, the balance event reflects all changes in a single event.
A customer must have a rule with the address variable type, and the variable must contain the address of the balance as its value.

Supported Protocols

base/mainnet
base/sepolia
bitcoin/mainnet
bitcoin/testnet
bitcoin/testnet4
bitcoincash/mainnet
bitcoincash/testnet
bnb/mainnet
bnb/testnet
dogecoin/mainnet
dogecoin/testnet
ethereum/mainnet
ethereum/sepolia
ethereum/hoodi
kaia/mainnet
kaia/testnet
litecoin/mainnet
litecoin/testnet
monad/mainnet
monad/testnet
polkadot/mainnet
polkadot/westend
polygon/mainnet
polygon/amoy
stellar/mainnet
stellar/testnet
tron/mainnet
tron/nile
xrp/mainnet
xrp/testnet

Schema

{
  "data": {
    "block_hash": "string",
    "block_number": "integer",
    "block_timestamp": "integer",
    "address": "string",
    "asset": "string",
    "value": "integer"
  }
}

Field	Type	Description
`block_hash`	string	(Required) The block hash.
`block_number`	integer	(Required) The block number.
`block_timestamp`	integer	(Required) The UNIX timestamp when the block was mined/validated.
`address`	string	(Required) The account address. This matches the address in a customer's variable values for the `address` variable type.
`asset`	string	(Required) The asset type of the balance. For native tokens, such as ETH on Ethereum, `asset` is set to `native`. Non-native tokens (e.g. ERC-20) use their specific denomination or contract address.
`value`	integer	The value of the balance for the address and asset at this block height, in the lowest denomination of the asset (e.g. wei for ETH, satoshi for BTC).

This schema applies to the UNIFIED_V1 and UNIFIED_V1_RAW templates. ALL_DATA returns the chain's native balance-check payload unmodified, with its own fields, shown below per protocol.

❗️
Important Note
Bitcoin Cash (BCH) address events use the Cash Address format with the bitcoincash: prefix. To convert between formats, you can use this Cash Address Converter.

Examples

Base

MainnetSepolia

Base is an Ethereum L2, so block_number and block_hash refer to Base's own execution-layer block, not L1 Ethereum. Balances for the native asset are returned in wei, the same as Ethereum mainnet. A unified_confirmed_balance event fires whenever the balance for a watched address changes within a block.

{
  "protocol": "base",
  "network": "mainnet",
  "event_type": "unified_confirmed_balance",
  "chain_id": "eip155:8453",
  "data": {
    "block_number": 36784069,
    "block_hash": "0x9272992b9389b7473d25515c5f4207064dfa19d53b79b94b6f8cc96ae0c653db",
    "block_timestamp": 1760357485,
    "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "asset": "native",
    "value": 9800646158085844
  }
}

Supported Protocols

Schema

Important Note

Examples

Base

👋 Need Help?