Was sind Solana Webhooks?
Solana Webhooks sind HTTP-Echtzeitbenachrichtigungen, die an deine Anwendung gesendet werden, wenn On-Chain-Events auftreten. Anstatt die Blockchain kontinuierlich abzufragen, sendet Helius geparste Transaktionsdaten direkt an deinen endpoint, sobald ein Wallet Guthaben überträgt, ein NFT verkauft wird oder ein überwachter Transaktionstyp ausgelöst wird. Nutze Webhooks für Trading-Bots, Analyse-Dashboards, Compliance-Pipelines und ereignisgesteuerte Automatisierungen. Wir bieten eine benutzerfreundliche Oberfläche sowie Zugriff über eine API und SDKs, damit du Webhooks einfach erstellen und verwalten kannst. Antworten auf häufig gestellte Fragen findest du in den häufig gestellten Fragen zu Webhooks. Für neue Builds, die geparste Transaktionen in Echtzeit benötigen, solltest du Parsed Streams verwenden. Sie sind der Nachfolger von Enhanced Transaction Webhooks, dekodieren jede Anweisung mithilfe des IDL-Katalogs, filtern serverseitig nach Programm, Konto und Anweisungsname und kosten in allen Tarifen ebenfalls 1 Credit pro Ereignis.Preise
Webhook-Ereignisse kosten 1 Credit, sobald Helius das Ereignis verarbeitet und an dein endpoint sendet. Die Kosten fallen unabhängig davon an, ob dein endpoint den webhook erfolgreich verarbeitet. Das Bearbeiten, Hinzufügen oder Löschen eines webhook über die API kostet 100 Credits/request.Webhook-Typen
Wir bieten derzeit mehrere Arten von webhooks für unterschiedliche Anforderungen an:Webhooks für erweiterte Transaktionen
Sie liefern menschenlesbare, geparste Daten für bestimmte Transaktionstypen (z. B. NFT-Verkäufe), die mit den von dir überwachten Adressen zusammenhängen. Das ist ideal, wenn du gefilterte, direkt nutzbare Erkenntnisse benötigst.Webhooks für Rohtransaktionen
Diese Option liefert rohe Transaktionsdaten für alle Transaktionen, an denen die von dir überwachten Adressen beteiligt sind. Eine Filterung nach Transaktionstyp ist nicht möglich.Webhooks für Rohtransaktionen bieten eine geringere Latenz, da Ereignistypen nicht geparst werden.
Discord-Webhooks
Streame Aktualisierungen für bestimmte Transaktionstypen als formatierte Nachrichten direkt in einen festgelegten Discord-Kanal. Um diese Option zu verwenden, musst du die URL deines Discord-webhook angeben.Beispiel für einen Event-Payload
Enhanced
Enhanced
Raw
Raw
Erste Schritte
Webhooks Quickstart
Erstelle deinen ersten webhook über das Dashboard, die REST API oder das offizielle TypeScript- bzw. Rust-SDK.
Fehlerhafte Webhooks automatisch deaktivieren
Helius überwacht, ob webhook endpoints erreichbar sind, und deaktiviert automatisch webhooks, bei denen Zustellungen dauerhaft fehlschlagen. So werden keine weiteren Zustellversuche an nicht erreichbare oder defekte endpoints verschwendet.Funktionsweise
- Kostenpflichtige Tarife (Dev und höher): Webhooks mit einer Fehlerrate von ≥ 95 % über 7 Tage werden automatisch deaktiviert.
- Kostenloser Tarif: Webhooks werden über ein 24-Stunden-Zeitfenster mit demselben Schwellenwert für Fehler ausgewertet.
E-Mail-Benachrichtigungen
Nutzer mit dem Dev-Tarif oder höher erhalten eine E-Mail-Benachrichtigung, wenn ein webhook automatisch deaktiviert wird.Einen deaktivierten Webhook wieder aktivieren
1
Fix your endpoint
Behebe das Problem, das die Zustellfehler verursacht (z. B. Serverausfall, falsche URL oder Fehler am endpoint).
2
Log in to the Helius Dashboard
Öffne das Helius Dashboard.
3
Re-enable the webhook
Suche den deaktivierten webhook und aktiviere ihn wieder.
Nach der erneuten Aktivierung beginnt für den webhook eine 24-stündige Schonfrist, in der er nicht erneut automatisch deaktiviert wird. So hast du Zeit, zu prüfen, ob dein endpoint ordnungsgemäß funktioniert.
Anwendungsbeispiele
Bots
- Wenn ein NFT auf Marktplatz X gelistet wird, löse die Aktion „NFT kaufen“ aus.
- Wenn eine Margin-Position gefährdet ist, löse eine „Liquidation“ aus.
Überwachung und Warnmeldungen
- Wenn ein Programm ein bestimmtes Log ausgibt, löst es die PagerDuty-Integration aus.
- Wenn sich der Saldo eines token-Kontos um mehr als X % ändert, verwende Dialect, um eine Warnung zu senden.
Ereignisgesteuerte Indexierung
- Wenn für ein bestimmtes Programm eine Transaktion stattfindet, sende sie direkt an deine Datenbank oder dein Backend.
Benachrichtigungen und Aktivitätsverfolgung
- Wenn eine Übertragung von Wallet X an Wallet Y erfolgt, sende eine Slack-Benachrichtigung oder E-Mail.
Analysen und Logs
- Wenn Ereignis X eintritt, sende es an eine ETL-Pipeline oder speichere es direkt in Helius, um Trends im Zeitverlauf anzuzeigen.
Workflow-Automatisierung
- Wenn Ereignis X eintritt, löse eine beliebige Reihe von Aktionen aus.