Spectra
Docs durchsuchen

webhooks

Secret einrichten

Erstelle ein Webhook-Secret, scope es und speichere die IP-Allowlist.


Ein Spectra-Webhook-Secret ist das, was ein externes Alerting-System — dein eigener Server, ein Screener, ein Skript oder eine beliebige HTTP-fähige Alert-Quelle — mit einem Spectra-Konto verbindet. Jedes Secret ist auf eine Broker-Verbindung und eine Tagesverlustgrenze gescoped.

Secret erstellen

Profil → Webhooks → Add. Jedes Secret trägt:

Name              →  menschliches Label, z. B. „TV BTC alerts"
Broker connection →  zu welchem Broker Auto-Orders routen
Daily-loss cap    →  USD-Decke pro Secret (Pflicht)
IP allowlist      →  CIDR-Bereiche, die POSTen dürfen
Active            →  Toggle aus zum Deaktivieren ohne zu löschen

Nach dem Speichern wird der Secret-Wert einmal angezeigt. Sofort kopieren — Spectra speichert nur eine AES-GCM versiegelte Kopie und zeigt ihn nicht erneut an. Verloren? Rotieren.

Tagesverlustgrenze

Die Decke wird am Cloud-Worker durchgesetzt, bevor irgendeine Order an den Broker geroutet wird. Wenn realisiertes + offenes Tages-P&L die Decke verletzt, pausiert das Secret den Rest des Tages und ein Alert feuert.

Du setzt die Decke beim Erstellen des Secrets; jederzeit änderbar. Es gibt keinen Weg, sie zu deaktivieren — das Feld ist Pflicht, das Minimum ist $100 (klein genug, um beim Testen nicht zu stören, groß genug, um aufzufallen, falls jemand 0 setzen will).

IP-Allowlist

CIDR-Bereiche, die zum Webhook POSTen dürfen. Standardmäßig darf jede IP POSTen, aber zusammen mit HMAC-Verifikation ist das selten eine echte Angriffsfläche. Beschränke es auf die veröffentlichten IPs deiner Alert-Quelle für strengere Isolation.

Rotieren

Webhooks → Secret → Rotate. Das alte Secret wird sofort widerrufen; das neue wird angezeigt. Aktualisiere deinen Sender innerhalb von 5 Minuten — Replay-Schutz (siehe Replay) ist zeitstempel-gebunden, alte Nachrichten replayen sowieso nicht.