Spectra
Explorar docs

alerts

Alertas por script

Alertas dirigidas por DSL que disparan ante cualquier expresión que puedas escribir en el lenguaje.


Una alerta por script es un script tipo Alert (ver Tipos de script) etiquetado para evaluación en vivo. El output es booleano; el runtime llama a notify(...) cuando se vuelve true en cierre de barra.

Ejemplo mínimo

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

Símbolos y marcos temporales

Por defecto una alerta por script evalúa contra el gráfico al que se adjuntó. Cámbialo desde Alert settings:

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

Puedes correr la misma alerta sobre toda una watchlist con Symbol = watchlist:<name>. El runtime hace fan-out: una evaluación por símbolo por cierre de barra.

Cooldown

Las alertas defaultean a fire once and disable para evitar spam. Override:

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

always más una expresión deboucncada (p. ej. trigger and not trigger[1]) es el patrón más limpio para alertas de cambio de estado.

Funciones Pro

Pro añade:

  • Evaluación 24/7 en el cloud worker (runs_on: vps).
  • Outputs webhook que pueden disparar órdenes downstream — ver Webhooks.
  • Modo email digest que batchea múltiples disparos al día.

Debug

Abre Alert settings → Diagnostics para un log de evaluación por barra: las últimas 50 evaluaciones, el output booleano y el tiempo gastado. Útil cuando una alerta no dispara y sospechas de un typo.