Skip to main content
All CollectionsAPIStreams API
Understanding Webhooks for Transaction Confirmation
Understanding Webhooks for Transaction Confirmation

This article will help you understand how to interpret the two webhooks that you receive when a transaction is mined and confirmed.

Jonathan Blackburn avatar
Written by Jonathan Blackburn
Updated over 7 months ago

The Streams API provides two webhooks for each block that contains the event you are interested in.
โ€‹
One with confirmed: false when the transaction is initially mined and one with confirmed: true when the transaction is confirmed after a certain number of blocks. By understanding these webhooks and the number of confirmations required for your blockchain, you can effectively monitor and track your transactions.

When a block is initially mined, you will receive a webhook with confirmed: false. This webhook indicates that the transaction has been added to a block but has not yet been reached the number of block confirmations required. You can use this webhook to track the progress of the transaction and take necessary actions, such as sending notifications to users or updating a database.

Once the block is confirmed, you will receive a second webhook with confirmed: true. This webhook indicates that the transaction has been successfully executed and fulfilled the number of confirmations required by the network. The number of confirmations required varies based on the blockchain you are using.

To determine the number of confirmations required for your blockchain, please refer to the table below. You can find this information under the Confirmation Blocks column for each supported chain.

REORGANIZATION BEFORE CONFIRMATION

Until a block is confirmed, it is possible that a re-organization of the chain may occur, invalidating some information. If a re-organization does occur before a block is confirmed, the information associated with the block is deleted and the updated block is inserted in its place.

Chain

Blocks until confirmed

ETH

12

ETH SEPOLIA

18

ETH HOLESKY

18

BSC

18

BSC TESTNET

18

POLYGON

100

POLYGON AMOY

100

FANTOM

100

FANTOM TESTNET

100

AVAX

100

CRONOS

100

RONIN

100

ARBITRUM

100

ARBITRUM SEPOLIA

100

PALM

GNOSIS

100

GNOSIS CHIADO

100

BASE

100

BASE SEPOLIA

100

OPTIMISM

100

OPTIMISM SEPOLIA

600

LINEA

100

LINEA SEPOLIA

100

Did this answer your question?