Skip to main content

Was sind Solana-Webhooks?

Solana-Webhooks sind Echtzeit-HTTP-Benachrichtigungen, die an Ihre Anwendung gesendet werden, wenn On-Chain-Ereignisse auftreten. Anstatt die Blockchain ständig abzufragen, sendet Helius die analysierten Transaktionsdaten direkt an Ihren Endpunkt, wann immer ein Wallet Mittel überträgt, ein NFT verkauft wird oder ein überwachter Transaktionstyp ausgeführt wird. Nutzen Sie Webhooks zur Unterstützung von Trading-Bots, Analyse-Dashboards, Compliance-Pipelines und ereignisgesteuerter Automatisierung. Wir bieten eine benutzerfreundliche Oberfläche, eine programmgesteuerte API und SDK-Zugriff zur einfachen Erstellung und Verwaltung von Webhooks. Für häufig gestellte Fragen sehen Sie sich die Webhooks FAQ an.
Helius kann Webhook-Zustellungen erneut versuchen, wenn Ihr Server nicht erfolgreich antwortet, und Sie könnten doppelte Ereignisse erhalten. Für Details zu Wiederholungen und dem Umgang mit Duplikaten siehe die Webhooks FAQ.

Preisgestaltung

Webhook-Ereignisse werden mit 1 Kredit berechnet, wenn Helius das Ereignis verarbeitet und an Ihren Endpunkt sendet. Ihnen werden Kosten berechnet, unabhängig davon, ob Ihr Endpunkt den Webhook erfolgreich verarbeitet oder nicht. Das Bearbeiten, Hinzufügen oder Löschen eines Webhooks über die API kostet 100 Credits/Anfrage.

Arten von Webhooks

Wir bieten derzeit mehrere Arten von Webhooks an, die auf unterschiedliche Bedürfnisse zugeschnitten sind:

Erweiterte Transaktionswebhooks

Bieten menschenlesbare, analysierte Daten für bestimmte Transaktionstypen (z. B. NFT-Verkäufe), die sich auf die von Ihnen überwachten Adressen beziehen. Dies ist ideal, wenn Sie gefilterte, umsetzbare Einblicke wünschen.

Rohe Transaktionswebhooks

Diese Option liefert rohe Transaktionsdaten für alle Transaktionen, die die von Ihnen überwachten Adressen betreffen. Es ist keine Filterung nach Transaktionstyp möglich.
Rohe Transaktionswebhooks bieten geringere Latenz, da sie keine Ereignistypen analysieren.

Discord-Webhooks

Streamen Sie Updates für bestimmte Transaktionstypen direkt an einen festgelegten Discord-Kanal als formatierte Nachrichten. Um diese Option zu nutzen, müssen Sie Ihre Discord-Webhook-URL einreichen.

Beispiel für ein Ereignis-Payload

Erste Schritte

Webhooks Schnellstart

Erstellen Sie Ihren ersten Webhook über das Dashboard, die REST-API oder das offizielle TypeScript/Rust-SDK.

Automatisches Deaktivieren fehlerhafter Webhooks

Helius überwacht die Gesundheit von Webhook-Endpunkten und deaktiviert automatisch Webhooks, die kontinuierlich keine Zustellungen empfangen. Dies verhindert verschwendete Zustellungsversuche an nicht erreichbare oder defekte Endpunkte.

So funktioniert es

  • Bezahlte Pläne (Dev und höher): Webhooks mit einer ≥ 95% Fehlerquote über 7 Tage werden automatisch deaktiviert.
  • Gratisplan: Webhooks werden über ein 24-Stunden-Fenster mit dem gleichen Fehlerlimit bewertet.
Das System überprüft die Gesundheit von Webhooks alle 4 Stunden. Wenn ein Webhook deaktiviert wird, stoppen die Zustellungen innerhalb von Sekunden.

E-Mail-Benachrichtigungen

Benutzer mit dem Dev-Plan und höher erhalten eine E-Mail-Benachrichtigung, wenn ein Webhook automatisch deaktiviert wird.

Wiederaktivieren eines deaktivierten Webhooks

1

Beheben Sie Ihren Endpunkt

Beheben Sie das Problem, das Zustellungsfehler verursacht (z. B. Serverausfallzeit, falsche URL, Endpunktfehler).
2

Melden Sie sich im Helius-Dashboard an

Gehen Sie zum Helius-Dashboard.
3

Reaktivieren Sie den Webhook

Finden Sie den deaktivierten Webhook und schalten Sie ihn wieder ein.
Sie können Webhooks auch programmgesteuert über den Toggle Webhook API-Endpunkt wieder aktivieren.
Nach der Reaktivierung hat der Webhook eine 24-stündige Schonfrist, während der er nicht erneut automatisch deaktiviert wird. Dies gibt Ihnen Zeit, um zu überprüfen, dass Ihr Endpunkt gesund ist.

Beispielanwendungen

Bots

  • Wenn ein NFT auf dem Marktplatz X gelistet wird, lösen Sie eine “NFT-Kauf”-Aktion aus.
  • Wenn eine Margin-Position ungesund ist, lösen Sie eine “Liquidation”-Aktion aus.

Überwachung & Warnungen

  • Wenn ein Programm ein bestimmtes Log ausgibt, wird eine PagerDuty-Integration ausgelöst.
  • Wenn sich der Saldo eines Token-Kontos um mehr als X% ändert, verwenden Sie Dialect, um eine Warnaktion zu kommunizieren.

Ereignisgesteuertes Indexieren

  • Wenn eine Transaktion für ein gegebenes Programm auftritt, senden Sie sie direkt an Ihre Datenbank oder Ihr Backend.

Benachrichtigungen & Aktivitätsverfolgung

  • Beim Übertragen von Wallet X zu Wallet Y — senden Sie eine Slack-Benachrichtigung oder E-Mail.

Analytik & Protokolle

  • Wenn Ereignis X eintritt, senden Sie es an eine ETL-Pipeline oder speichern Sie es direkt auf Helius, um Trends im Laufe der Zeit zu sehen.

Workflow-Automatisierung

  • Wenn Ereignis X eintritt, lösen Sie eine beliebige Aktion aus.