Events Overview

In a traditional API, customers request data from the blockchain using the API. This process involves continuous polling where customers request new blocks, transactions, and related information. The system retrieves data on demand, creating a continuous query process cycle.

Event streaming flips the interaction model by delivering blockchain events directly to customers. Currently, the delivery is limited to webhooks. Customers will have to register a webhook in order to receive blockchain events.

Blockchain events are delivered in near real-time as they happen on the chain. This enables an event-driven architecture where customers receive only the data they're interested in and only when relevant. Customers can control which events will be sent by event streaming. It works on a conditional basis that is reflected in the form of rules and variables.

📘

Info:

This API is part of the Chain Watch bundles.

❗️

Note

Each call incurs a fixed CU charge, plus additional CUs for API operations. See the Compute Units Usage page for details.

Supported Protocols

Protocol

Network

Bitcoin Cash

Mainnet

Bitcoin

Mainnet
Testnet
Testnet4

Dogecoin

Mainnet

Polkadot

Mainnet
Testnet

Ethereum

Mainnet
Holesky
Sepolia
Hoodi

Litecoin

Mainnet

Optimism

Mainnet

Polygon

Mainnet
Amoy

Event Streaming has two conditions to receive events:

Events

Conditions

Supported Event Types

Based on the Event Type

Receive events when a blockchain event of a specific type occurs.

unified_block
unified_reorg

Based on Address

Receive events when a blockchain event is related to a specific address.

unified_confirmed_tx
unified_confirmed_balance
unified_confirmed_tx_trace
unified_confirmed_tx_log
unified_staking_reward
unified_staking_status

Allow-listed IPs

To enhance security and prevent DDoS attacks, allow-list the following IP addresses that will hit your Events Webhook endpoints:

  • 35.245.225.131
  • 34.150.141.91
  • 34.85.141.205

👋 Need Help?

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