Unified Block

This event is triggered when:

A customer has a rule using the event_type as a variable type, with the variable set to block.
A new block is mined or validated on the blockchain.

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
optimism/mainnet
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",
    "parent_hash": "string"
  }
}

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.
`parent_hash`	string	(Required) The hash of the parent block.

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

Examples

Ethereum

MainnetSepoliaHoodi

On Ethereum, block_number and block_hash refer to the execution-layer block, not the consensus-layer slot. parent_hash links to the previous block, so you can walk the chain backward without extra RPC calls. Blocks are produced roughly every 12 seconds, and a unified_block event fires as soon as a block is seen, before it's necessarily finalized. Use the unified_reorg event to detect when a previously-seen block gets replaced.

{
  "event_type": "unified_block",
  "protocol": "ethereum",
  "network": "mainnet",
  "chain_id": "eip155:1",
  "data": {
    "block_number": 19471718,
    "block_hash": "0x6c3663ecee19749e28c098c34211e3f06d5538108458442d4d74cb139f471b40",
    "parent_hash": "0xe46f13f48d767eb62e19e2b7333c2a34286f29851ac93db358bb0d5728ed7738",
    "block_timestamp": 1710886763
  }
}

👋 Need Help?

Updated 7 days ago

Did this page help you?