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.13134.150.141.9134.85.141.205
👋 Need Help?
Contact us through email or our support page for any issues, bugs, or assistance you may need.
Updated 8 days ago