Skip to main content

​
Credits and Rate Limits

Up to 100,000 addresses using the API.
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.
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.
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

Yes. If you create a webhook through the UI, choose “devnet” as “Network”. If you create it through the Webhook API, set the “webhookType” parameter to “rawDevnet”, “enhancedDevnet” or “discordDevnet” depending on your desired webhook type.
No—the URL must be publicly reachable over HTTPS. Helius cannot access local development servers via localhost URLs.

​
Using Webhooks

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.
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.
Webhooks send notifications immediately after a matching transaction is confirmed on the blockchain.

​
Retries

Your endpoint must return a 200 status code within 1 second to acknowledge successful receipt. As a best practice, respond with 200 immediately and handle any processing asynchronously — this prevents timeouts caused by slow business logic.
Helius retries delivery when your endpoint returns a 5xx error, a 4xx error (except 403), times out, or fails due to a connection error or DNS failure. We retry up to 3 times with a 1-second gap between each attempt.If all retry attempts fail, the event is permanently lost — there is no re-queue or second delivery cycle.Monitor your webhook logs in the Helius Dashboard to identify delivery failures and investigate endpoint issues.We also offer customizable retry policies for enterprise plans.
Helius may deliver the same webhook event multiple times. This may happen due to retry logic or network issues.Your webhook handler must be prepared to handle duplicates gracefully — processing the same event multiple times should produce the same result as processing it once.To handle duplicates, use the transaction signature or a unique event identifier to track which events you’ve already processed.
It depends on the webhook type. Enhanced webhooks do not send failed transactions, but raw webhooks do include both successful and failed transactions.

​
Auto-Disabling

Helius monitors endpoint health and automatically disables webhooks with a ≥ 95% delivery failure rate. Paid plans (Dev and above) are evaluated over a 7-day window, while Free plan webhooks are evaluated over a 24-hour window. This prevents wasted delivery attempts against unreachable endpoints.Common causes include an unreachable endpoint URL, your server returning consistent error responses, or network/firewall issues blocking Helius deliveries.
  1. Fix the underlying issue with your endpoint.
  2. Log in to the Helius Dashboard.
  3. Find the disabled webhook and toggle it back on.
You can also re-enable webhooks programmatically via the Toggle Webhook API endpoint by sending a PATCH request with { "active": true }.
No. After re-enabling, the webhook enters a 24-hour grace period during which it will not be automatically disabled. This gives you time to verify your endpoint is healthy before the next evaluation.
Yes — users on the Dev plan and above receive an email notification when a webhook is automatically disabled. Free plan users can monitor webhook status in the Helius Dashboard.
Yes. You can toggle webhooks on and off from the Helius Dashboard or via the Toggle Webhook API endpoint. This lets you temporarily pause deliveries without losing your webhook configuration.

​
Troubleshooting Webhooks

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.
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.
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.

​
Need More Help?

Contact Support

Get help from our team through Discord, chat, or email support.

Status Page

Check real-time service availability and performance information.