Bitcoin Webhooks
Track UTXOs & Confirmations
Track Bitcoin addresses, receive real-time mempool notifications, and monitor transaction confirmation counts. Clean, reliable JSON webhooks without managing bulky Electrum indexers.
Listen and react to Bitcoin events
Define address watchlists, configure confirmation workflows, and verify webhook signatures natively in your TypeScript projects.
// 1. Initialize Blockferry SDK
import { Blockferry } from '@blockferry/sdk';
const sdk = new Blockferry({
apiKey: process.env.BLOCKFERRY_API_KEY!,
});
// 2. Setup Watchlist for Bitcoin address tracking
const watchlist = await sdk.watchlists.create({
name: 'Bitcoin Cold Wallet Watch',
chains: ['bitcoin'], // targets the bitcoin network
webhookUrl: 'https://api.mybackend.com/webhooks/bitcoin'
});
await sdk.watchlists.addAddresses(watchlist.id, {
addresses: [
{
address: 'bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh',
metadata: { customerId: 'cust-940384' }
}
]
});How Blockferry delivers Bitcoin events
Mempool Listening
Our indexers monitor the global peer-to-peer Bitcoin mempool, alerting you of zero-conf transactions instantly.
UTXO Aggregation
Inputs and outputs are grouped and indexed, translating complex coin tracking structures into clean address lists.
Confirmation Tickers
As blocks are mined, we update confirmation tallies, sending you callbacks at block inclusion stages.
Durable Delivery
All webhooks include secure HMAC signatures, with full automatic retries if your API is unavailable.
Mempool & RBF Monitoring
Bitcoin's mempool state changes continuously before transactions are mined. Blockferry tracks changes and updates your backend in real-time:
- Zero-Conf Alerts: Detects incoming payments seconds after they are broadcasted on the network.
- Replace-By-Fee (RBF): Automatically monitors fee rate updates, warning your backend if a transaction is replaced with a higher-priority duplicate.
UTXO Change Tracking
Bitcoin spends inputs entirely, returning left-over coins to a change address. Blockferry parses transaction outputs natively so you don't have to keep track of change addresses:
- Output Splitting: The engine isolates outputs belonging to your monitored wallets from standard change address outputs.
- Metadata Tags: Payloads return custom watchlists tags, preserving account context throughout UTXO operations.