Spectra
Parcourir la doc

alerts

Alertes scriptées

Alertes dirigées par DSL qui tirent sur n'importe quelle expression exprimable dans le langage de scripting.


Une alerte scriptée est un script de type Alert (voir Types de script) marqué pour évaluation en direct. L'output est un booléen ; le runtime appelle notify(...) quand il devient true à la clôture d'une barre.

Exemple minimal

let oversold = rsi(close, 14) < 30
let near_vwap = abs(close - vwap()) < atr(14) * 0.5
let trigger = oversold and near_vwap

notify(when: trigger, channel: "discord")
output trigger

Symboles et unités de temps

Par défaut, une alerte scriptée évalue sur le graphique auquel elle est attachée. À changer depuis Alert settings :

Symbol     →  same as chart  |  named: ES1!, BTCUSDT, ...
Timeframe  →  same as chart  |  fixed: 1m, 5m, 1h, 1d

Vous pouvez lancer la même alerte sur toute une watchlist en réglant Symbol = watchlist:<name>. Le runtime fait du fan-out : une évaluation par symbole par clôture de barre.

Cooldown

Les alertes default à tirer une fois et désactiver pour éviter le spam. Override :

Cooldown  →  off  |  fire once  |  re-arm after N bars  |  always

always plus une expression debouncée (p. ex. trigger and not trigger[1]) est le pattern le plus propre pour les alertes de changement d'état.

Fonctionnalités Pro

Pro ajoute :

  • Évaluation 24/7 sur le cloud worker (runs_on: vps).
  • Sorties webhook capables de déclencher des ordres en aval — voir Webhooks.
  • Mode digest email qui batche plusieurs déclenchements par jour.

Débogage

Ouvrez Alert settings → Diagnostics pour un log d'évaluation par barre : les 50 dernières évaluations, l'output booléen, et le temps pris. Utile quand une alerte ne tire pas et que vous suspectez une faute de frappe.