unified_confirmed_balance

Event Trigger

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.

Bitcoin Example

{
    "event_type": "unified_confirmed_balance",
    "protocol": "bitcoin",
    "network": "mainnet",
    "data": {
        "block_number": 831401,
        "block_hash": "0000000000000000000004264eb2cfa81bdd04998932e960644fa979030f5fda",
        "block_timestamp": 1708519012,
        "address": "bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h",
        "value": 1118789134970,
        "asset":"native"
    }
}

Polkadot Example

{
    "protocol": "polkadot",
    "network": "mainnet",
    "event_type": "unified_confirmed_balance",
    "data": {
        "block_number": 19581221,
        "block_hash": "0xcca09c910a765a515befdaede371e4cf65d48eaf48714ed76a031b64ba4c603e",
        "block_timestamp": 1708518792,
        "address": "12xtAYsRUrmbniiWQqJtECiBQrMn8AypQcXhnQAc6RB6XkLW",
        "asset": "native",
        "value": 345709198148936143
    }
}

Schema

FieldTypeDescription
block_hashstringThe block hash.
block_numberintegerThe block number.
block_timestampintegerThe UNIX timestamp when the block was mined/validated.
addressstringThe account address.

This matches the address in a customer’s variable values for the address variable type.
assetstringThe asset type of the balance.

- For native tokens like ETH for Ethereum, the asset will be set to native.
- For non-native tokens like ERC20 tokens will have their specific denomination.
valueintegerThe value of the balance for the address and asset at this block height. The value is in the lowest denomination of the asset.

For example:
- For ETH, the value is in wei.
- For BTC, the value is in satoshi.

👋 Need Help?

Contact us through email or our support page for any issues, bugs, or assistance you may need.