Credits and Rate Limits
How many addresses can I input for 1 webhook?
How many addresses can I input for 1 webhook?
Up to 100,000 addresses using the API.
Will I be charged credits if I change the webhook URL in the Helius dashboard after creating the webhook?
Will I be charged credits if I change the webhook URL in the Helius dashboard after creating the webhook?
Yes, editing a webhook via the API or dashboard costs 100 credits per request. This applies to any modification including URL changes, adding/removing addresses, or updating transaction types.
How many credits does it cost to receive a webhook notification?
How many credits does it cost to receive a webhook notification?
Each webhook event costs 1 credit when Helius processes and sends the event to your endpoint. You are charged regardless of whether your endpoint successfully processes the webhook or returns an error.
How much does it cost to create, edit, and delete webhooks?
How much does it cost to create, edit, and delete webhooks?
All webhook management operations (create, edit, delete) cost 100 credits per request when performed via the API. This covers the processing required to update your webhook configurations.
Supported Networks
Are webhooks available on Solana Devnet?
Are webhooks available on Solana Devnet?
Yes! Set
"network":"devnet" when creating your webhook to monitor Devnet transactions and events.Can I input 'localhost' for my webhook URL?
Can I input 'localhost' for my webhook URL?
No—the URL must be publicly reachable over HTTPS. Helius cannot access local development servers via localhost URLs.
Using Webhooks
How can I verify that the webhook came from Helius?
How can I verify that the webhook came from Helius?
Set an authorization header when creating or updating the webhook. Helius echoes this value in the
Authorization header when sending data to your webhook endpoint, allowing you to verify the request’s authenticity.What is the difference between 'raw' and 'enhanced' webhooks?
What is the difference between 'raw' and 'enhanced' webhooks?
Raw webhooks return regular Solana transaction data directly from the blockchain. When a transaction occurs for the monitored addresses, the raw transaction data is sent to your webhook URL.Enhanced webhooks provide Helius’ interpreted transaction types. We parse over 100 types of Solana transactions (NFT listings, DeFi swaps, transfers, etc.) and abstract them into our own schema.Use raw webhooks if you want all transaction data without abstractions, or enhanced webhooks if you want built-in transaction type detection and parsing.
When does the Webhook send a notification?
When does the Webhook send a notification?
Webhooks send notifications immediately after a matching transaction is confirmed on the blockchain.
Retries
What is the retry policy for webhooks?
What is the retry policy for webhooks?
Helius retries unacknowledged webhook events up to 3 times with a 1-minute interval between attempts. We also offer customizable retry policies for enterprise plans.
Do webhooks post failed transactions?
Do webhooks post failed transactions?
It depends on the webhook type. Enhanced webhooks do not send failed transactions, but raw webhooks do include both successful and failed transactions.
Troubleshooting Webhooks
Why is my webhook dropping data?
Why is my webhook dropping data?
Data dropping typically occurs when your endpoint encounters an error, causing webhook retries that eventually fail and lead to data loss. Check your webhook logs in the dashboard, ensure sufficient client-side logging is in place, and contact support if the problem persists.
Why aren't my webhooks working?
Why aren't my webhooks working?
Ensure the selected transaction type matches the transactions you’re monitoring. Start with the “ANY” transaction type to identify if it’s a general issue or a type mismatch. Use webhook.site to test if the problem lies with your endpoint configuration.
Why does my webhook not send me all transactions of a certain type (such as TOKEN_MINT)?
Why does my webhook not send me all transactions of a certain type (such as TOKEN_MINT)?
The
TOKEN_MINT webhook only triggers for specific programs like Candy Machine V1, and Solana Program Library. It doesn’t cover all token minting events across the entire blockchain. For broader monitoring, consider using a more general account or program subscription via webhooks with “ANY” transaction type filtering.