Skip to content
Nocterm Docs

Alerts

Alerts turn what you’re watching into notifications — an in-app toast always, plus Telegram and Discord when configured. There are two ways to raise one: a price level on a chart, or an alert() call in any bar-driven script.

Where: chart right-click · scriptsDelivery: toast · Telegram · DiscordConfigure: Settings ▸ Data & Signals ▸ Alerts

Price alerts

Section titled “Price alerts”

Right-click empty chart space and pick Alert @ price. A dashed line marks the level; when a trade crosses it (direction inferred from where the level sat when you set it — touch counts), the alert fires once and clears itself. Right-click the line to remove it early. Alerts persist across restarts until they fire.

📷
Screenshot needed
id: trading-alerts-line

A one-shot price alert resting on the chart

suggested 1280x400

Script alerts

Section titled “Script alerts”

Every bar-driven script type — indicators, signalers, scanners, screeners, and bots — can call:

alert("MA cross on volume", { id = "cross", cooldown = 300 })
  • Fires on the live bar only — history replay, the editor preview, and backtests stay silent, so recomputes never spam you.
  • Once per bar per alert: the message text doesn’t affect dedupe (a changing price in the message still fires once), so pass distinct ids if one bar should raise several different alerts.
  • cooldown (seconds) spaces refires of the same alert.
  • Chart scripts evaluate the forming bar (values can repaint); scanners, screeners, and bots evaluate once per closed bar.
  • Each script is capped at ~30 alerts/hour — alert on a condition, not every bar. The seeded Alert Heartbeat scanner is a deliberate exception: it fires every run so you can watch the delivery path work end to end.

Delivery

Section titled “Delivery”

Settings ▸ Data & Signals ▸ Alerts holds the routing: a Telegram bot (token + chat ID) and/or a Discord webhook, each with an enable toggle and a Send test button. Credentials are stored in your OS keychain, never synced — use Send test to confirm they stored and reach the channel.

Section titled “Related”