API Reference
SupportStatus

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

Two Column List
  • bitcoin/mainnet
  • bitcoin/testnet
  • bitcoin/testnet4
  • bitcoincash/mainnet
  • dogecoin/mainnet
  • ethereum/mainnet
  • ethereum/holesky
  • ethereum/sepolia
  • ethereum/hoodi
  • litecoin/mainnet
  • optimism/mainnet
  • polkadot/mainnet
  • polkadot/westend
  • polygon/mainnet
  • polygon/amoy

Schema

{
  "data": {
    "block_hash": "string",
    "block_number": "integer",
    "block_timestamp": "integer",
    "parent_hash": "string"
  }
}

The table below shows the schema breakdown:

FieldTypeDescription
block_hashstring(Required) The block hash.
block_numberinteger(Required) The block number.
block_timestampinteger(Required) The UNIX timestamp when the block was mined/validated.
parent_hashstring(Required) The hash of the parent block.

Examples

{
    "protocol": "bitcoin",
    "network": "mainnet",
    "event_type": "unified_block",
    "chain_id": "bip122:000000000019d6689c085ae165831e93",
    "data":{
        "block_hash": "0000000000000000000278b53131091627eaa00f772f3c7b2a59c374666520d7",
        "block_number": 831663,
        "block_timestamp": 1708679008,
        "parent_hash": "00000000000000000001030ba3d1016bd94e4c48b90b3fd64d1b18bdb29c4f6f"
    }
}

{
    "protocol": "bitcoincash",
    "network": "mainnet",
    "event_type": "unified_block",
    "chain_id": "bip122:000000000000000000651ef99cb9fcbe",
    "data": {
        "block_hash": "0000000000000000016cbf11bbdba1f50bc5f3a66518b18608bf336921b6a1d4",
        "block_number": 865738,
        "block_timestamp": 1727716896,
        "parent_hash": "000000000000000000b1bc726d47c1b5eeeeafe129e7fe69e49aa7d933d67eb6"
  	}
}

{
    "protocol": "polkadot",
    "network": "mainnet",
    "event_type": "unified_block",
    "chain_id":"polkadot:91b171bb158e2d3848fa23a9f1c25182",
    "data": {
        "block_number": 19583058,
        "block_hash": "0x5763259919f255eb0330a9820182edabe42e5de4297ad7b49824f9a591d8a8a8",
        "parent_hash": "0x2a63ee5fb4a22f41e7bdc481aa3f67cb7155f2de7d25c959a28110e2f00d466d",
        "block_timestamp": 1708529886
    }
}

❗️

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.

👋 Need Help?

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