webhooks
Configurer un secret
Créez un secret webhook, scopez-le et stockez l'allowlist d'IP.
Un secret webhook Spectra est ce qui connecte un système d'alertes externe — votre propre serveur, un screener, un script, ou toute source d'alertes capable de parler HTTP — à un compte Spectra. Chaque secret est scopé à une seule connexion broker et un plafond de perte journalière.
Créer un secret
Profil → Webhooks → Add. Chaque secret porte :
Name → libellé humain, p. ex. « TV BTC alerts »
Broker connection → vers quel broker routent les auto-orders
Daily-loss cap → plafond USD par secret (obligatoire)
IP allowlist → plages CIDR autorisées à POSTer
Active → toggle off pour désactiver sans supprimer
Après sauvegarde, la valeur du secret est affichée une fois. Copiez-la immédiatement — Spectra ne stocke qu'une copie scellée AES-GCM et ne l'affichera plus. Si vous la perdez, rotez.
Plafond de perte journalière
Le cap est appliqué au cloud worker avant qu'aucun ordre ne route au broker. Si le P&L réalisé + ouvert du jour franchit le cap, le secret se met en pause pour le reste de la journée et tire une alerte.
Vous fixez le cap à la création du secret ; modifiez-le à tout moment. Aucun moyen de le désactiver — le champ est obligatoire, et le minimum est $100 (assez petit pour ne pas freiner les tests, assez grand pour être visible si quelqu'un essaie de mettre 0).
Allowlist IP
Plages CIDR qui peuvent POSTer au webhook. Par défaut n'importe quelle IP le peut, mais combinée à la vérification HMAC c'est rarement une vraie surface d'attaque. Restreignez-la aux IPs publiées par votre source d'alertes pour un isolement plus strict.
Rotation
Webhooks → secret → Rotate. L'ancien secret est révoqué immédiatement ; le nouveau s'affiche. Mettez à jour votre émetteur dans les 5 minutes — la protection anti-replay (voir Replay) est liée au timestamp, donc les vieux messages ne re-jouent pas de toute façon.