Skip to main content

Getting Started with Webhooks

Updated on
Jul 14, 2025

Overview

QuickNode Webhooks is a real-time blockchain event delivery service that sends filtered on-chain data directly to your HTTP endpoints. It makes it easy to get the data you need like token transfers or contract events, without constantly polling or building complex infrastructure.

Common Use Cases


Webhooks is ideal for building:

  • Trading Bots: Monitor DEX swaps and liquidity changes in real-time
  • Analytics Dashboards: Track token movements, whale activity, and protocol metrics
  • Notification Systems: Alert users about on-chain activity
  • Wallet Tracking: Follow specific wallet activity such as token transfers
  • Contract Event Tracking: Monitor specific events emitted by smart contracts, such as new mints, approvals, or function calls
  • DeFi Monitoring: Watch lending positions, yield farming rewards, and liquidation events
  • NFT Trackers: Follow mints, transfers, and marketplace activity for collections

Key Capabilities


  • Real‑time delivery: Receive events just after they land on‑chain
  • Guided wizard: Pick a chain, select a no-code template or write your own filter, set your URL, and that's it
  • Templates: One‑click no-code forms support common patterns such as token transfers, contract events, and more
  • Retry logic: Automatic retries for non‑200 responses
  • Compression: Compress payloads with gzip to reduce payload size
  • Reorg handling: Automatically handle blockchain reorganizations to ensure data consistency
  • Upgrade to Streams: Do you need historical backfilling, batching, or different destinations? Check out Streams

Getting Started with QuickNode Webhooks

Setting up a webhook is a straightforward process. Here's how you can get started:

Step 1: Access the Webhooks Dashboard

Log in to your QuickNode account and navigate to the Webhooks section in your dashboard.

Step 2: Create Your First Webhook

Click Create Webhook to launch the guided wizard to get started right away. This wizard will guide you through the process of setting up your webhook, from selecting your network to defining your filters and target URL.

Step 3: Configure Your Webhook

Chain Selection

Select the blockchain network you want to monitor. This is the first step in telling Webhooks where to listen for events.

Filter Selection

Next, you'll define what kind of events you want to receive. You have two main options:

  • Select a template: Webhooks provides one-click starters for common patterns like "Wallet transfers" or "Contract events." These templates pre-configure the necessary filters and just require you to specify the relevant parameters, such as wallet addresses or contract addresses.
  • Write a custom filter: For more specific or complex needs, you can write your own custom conditions using JavaScript-based server-side filtering.

You can use the Wallet transfers template on Ethereum Mainnet to get alerted when new activity across ETH, ERC-20, and ERC-721 transfers occurs for a specific wallet address.

Need help with filters?

Visit our Filters documentation or Streams Guides to learn more about advanced filters.

Step 4: Test Your Filter

Before activating your webhook, it's crucial to test your filter to ensure it's working correctly and capturing the events you intend. To test your filter:

  • Select a block number for testing
  • Click Run next to the test block number input field
  • Review example payload to test everything is working as expected

Step 5: Set Up Your Webhook URL

Enter the URL where you want to receive the payloads. QuickNode will send POST requests to this URL. The payload format will be the same as the one you see in the test payload, so you can easily parse it on your server.

You can use services like TypedWebhook, Webhook.site, or ngrok to test your webhook configuration before implementing your own endpoint.

Before creating your webhook, let's explore some additional options you can configure.

Validation Token

Each webhook has a validation token that you can use to verify the authenticity of the webhook. This token is generated automatically and can be found in the Webhooks dashboard. By using the validation token, you can validate incoming webhook messages and ensure they originate from your webhook.

Compression

QuickNode Webhooks provides a compression option to optimize your data delivery. You can choose to compress payloads with gzip to reduce their size.

While the cost for Webhooks is based on the number of alerts received, using compression can still offer benefits for your infrastructure. Smaller payload sizes lead to:

  • Reduced Bandwidth Usage: This can lower your data transfer costs if you're charged based on the amount of data transferred.
  • Faster Processing: Smaller payloads transmit quicker and may be processed more efficiently by your receiving server, reducing server load.
Learn more about compression

For detailed strategies on reducing costs with data compression, check out our Reduce Streams Costs with Data Compression guide.

Step 6: Create Your Webhook

Finally, give your webhook a descriptive name to recognize it later, and click the button to create your webhook. Your webhook will now be live and streaming real-time data to your specified URL whenever your conditional filter is met.

Additional Resources

Share this doc