Notifications: Transaction Confirmations and Process Time
Tatum sends notifications (webhooks) to keep you informed about blockchain activity on addresses you monitor.
For a given blockchain transaction, Tatum can send up to three webhook notifications based on:
- Mempool: The transaction enters the mempool (currently BTC only).
- Confirmations: The transaction reaches required confirmations or finalization.
- Reorg: The transaction was affected by a blockchain reorganization.
What Are Confirmations?
When a blockchain transaction is broadcast, it first enters the mempool, awaiting inclusion in a block by miners or validators. Once the transaction is added to a block, it receives its first confirmation.
Each subsequent block appended to the blockchain provides an additional confirmation, increasing the transaction's permanence and security.
Why Are Confirmations Necessary?
-
Prevention of Block Reorganizations (Reorgs):
Confirmations protect transactions from becoming invalid due to blockchain reorganizations. -
Avoidance of Double Spending:
Confirmations ensure transaction finality and prevent the same assets from being spent more than once.
How Long Does Tatum Take to Fire a Webhook?
The following table indicates the approximate time it takes Tatum to send a webhook notification after a transaction has the required number of confirmations. Note that actual timing may vary based on blockchain network conditions, miner activity, and transaction fees.
| Blockchain | Confirmations Needed | Approx. Notification Time |
|---|---|---|
| arb-one-mainnet (Arbitrum) | 50 | ≈ 20 minutes |
| avax-mainnet | 25 | ≈ 1 minute |
| avax-testnet | 25 | ≈ 1 minute |
| base-mainnet | 70 | ≈ 25 minutes |
| base-sepolia | 70 | ≈ 25 minutes |
| bera-mainnet | 1 | ≈ 2 minutes |
| bch-mainnet | 15 | ≈ 150 minutes |
| bch-testnet | 15 | ≈ 150 minutes |
| bsc-mainnet | 60 | ≈ 5 minutes |
| bsc-testnet | 60 | ≈ 5 minutes |
| bitcoin-mainnet | 4 | ≈ 40 minutes |
| bitcoin-testnet | 4 | ≈ 40 minutes |
| celo-mainnet | 1 | ≈ 1 minute |
| celo-testnet | 1 | ≈ 1 minute |
| cro-mainnet | 1 | ≈ 1 minute |
| cro-testnet | 1 | ≈ 1 minute |
| doge-mainnet | 10 | ≈ 10 minutes |
| doge-testnet | 10 | ≈ 10 minutes |
| eon-mainnet | 1 | ≈ 2 minutes |
| eon-testnet | 1 | ≈ 2 minutes |
| ethereum-holesky | 70 | ≈ 25 minutes |
| ethereum-mainnet | 70 | ≈ 25 minutes |
| ethereum-sepolia | 70 | ≈ 25 minutes |
| fantom-mainnet | 1 | ≈ 2 minutes |
| fantom-testnet | 1 | ≈ 2 minutes |
| flare-coston | 1 | ≈ 2 minutes |
| flare-coston2 | 1 | ≈ 2 minutes |
| flare-mainnet | 1 | ≈ 2 minutes |
| flare-songbird | 1 | ≈ 2 minutes |
| kaia-mainnet | 1 | ≈ 2 minutes |
| kaia-kairos | 1 | ≈ 2 minutes |
| klaytn-baobab | 1 | ≈ 2 minutes |
| klaytn-cypress | 1 | ≈ 2 minutes |
| litecoin-core-mainnet | 12 | ≈ 30 minutes |
| litecoin-core-testnet | 12 | ≈ 30 minutes |
| optimism-mainnet | 700 | ≈ 30 minutes |
| optimism-testnet | 700 | ≈ 30 minutes |
| polygon-amoy | 127 | ≈ 5 minutes |
| polygon-mainnet | 127 | ≈ 5 minutes |
| ripple-mainnet | 1 | ≈ 2 minutes |
| ripple-testnet | 1 | ≈ 2 minutes |
| solana-devnet | 1 | ≈ 2 minutes |
| solana-mainnet | 1 | ≈ 2 minutes |
| tezos-mainnet | 1 | ≈ 2 minutes |
| tezos-testnet | 1 | ≈ 2 minutes |
| tron-mainnet | 20 | ≈ 1 minute |
| tron-testnet | 20 | ≈ 1 minute |
Mempool Notifications
Transactions that enter the mempool (but not yet confirmed) trigger notifications immediately. Enable mempool notifications via This endpoint.
Note
Mempool Notificartions are currently available only for Bitcoin (BTC).
Reorg Notifications
Blockchain reorganizations can invalidate previously confirmed transactions. Tatum sends notifications whenever a blockchain reorg affects your monitored transactions.
Find more about Notification Reorg in This article.
Important Notes
- Ethereum-based chains (Ethereum, Base, Arbitrum, Optimism) use "block finalization" (approx. 70 confirmations) to ensure permanent transaction finality post-Ethereum Merge.
- The above processing times are estimates. High network congestion or low gas fees may significantly extend transaction confirmation and webhook notification delays.
- To accelerate confirmations, consider paying higher transaction (gas) fees.
Updated 1 day ago