Alerts
How alerts work
Alert modes, triggers, cooldown, comparing streams and message templates in Subtrigger, and what is free or on Pro.
3 min readUpdated
An alert watches market data for you and sends a message to your sinks when something happens: BTC goes above 100,000, RSI drops below 30, Binance lists a new coin. Subtrigger checks it on every new value, around the clock.
Modes
First you choose When to fire.
When a condition matches
The everyday mode. Write a condition in the builder, such as BTCUSDT Price ยท Binance > 100,000, and the alert fires when it matches. Join comparisons with and (all must match) or or (any can match).
When something happens
For news: a new listing, a trading halt, an exchange incident. Pick an event and get a message each time it happens. This mode is free. See Alerts on events.
On every new value
Sends each update of one stream, such as every new ETH price. This mode is on Pro. On Free, a proxy sends a value now and then.
Triggers
In condition mode, How often decides when a match becomes a message:
| Option | Fires |
|---|---|
| On crossing | When the condition becomes true. Again only after it turns false. |
| Every match | On every new value that matches. |
| Once | On the first match, then the alert pauses. |
On crossing suits levels: "BTC crossed 100k" sends one message, not one per tick. Every match suits events and rare values. After Once, resume the alert to arm it again.
Cooldown
After each message, new matches are skipped for the cooldown: from 0 (none) up to 7 days. A match during the cooldown is dropped, not saved for later.
Use it with Every match, or when a value wobbles around your level: RSI on 1-minute bars can cross 30 several times in a few minutes, and a 15-minute cooldown turns that into one message per dip.
Comparing streams
The right side of a comparison can be:
- A value: a number, or text for contains.
- Another stream (Pro): price above its SMA 50, or Binance against Bybit.
- A stream with arithmetic (Pro):
+ โ ร รทa number, as in BTCUSDT Price ยท Binance > BTCUSDT Price ยท Bybit + 200. - changed: nothing on the right; fires whenever the value changes.
Free allows 2 comparisons per condition, Pro 10. Prices, SMA, EMA and RSI are free; other indicators are on Pro. See How indicators work.
Messages
Next to the form you see the message and a live preview. Write any text and drop values in: the alert name, the time it fired, each stream's name, value and time, and each comparison. In the template they look like {{alert.name}}, {{trigger.value}} or {{cond.1}}, which becomes BTCUSDT Price 100,250 > 100,000.
| Format | What you get | Plan |
|---|---|---|
| Text | Sent as written | Free |
| Markdown | Bold, links, lists; formatted in Telegram | Pro |
| JSON | Values go in as JSON; for webhooks and agents | Pro |
History
An alert's page shows every time it fired: a chart over 1 hour, 6 hours, 24 hours or 3 days, and a table with the values of all streams and every comparison. Click a bar or drag across the chart to narrow the table. Free shows the last 24 hours, Pro 3 days.
Free and Pro
| Free | Pro | |
|---|---|---|
| Alerts | 5 | 100 |
| Comparisons per condition | 2 | 10 |
| Stream against stream, arithmetic | โ | โ |
| Indicators | Prices, SMA, EMA, RSI | All |
| Every new value | โ | โ |
| Message formats | Text | Text, Markdown, JSON |
| History | 24 hours | 3 days |
FAQ
Why did my alert fire only once when the price stayed above my level?
It uses On crossing, which waits for the condition to turn false before firing again. Choose Every match with a cooldown to hear while it holds.
How do I get one message per day at most?
Set the cooldown to 1 day.
What happens to my alert after "Once" fires?
It pauses. Resume it to fire again on the next match.
Keep reading
- AlertsEventsEvents are streams where every value is news: new listings, delistings, trading halts, exchange incidents. One step, free.
- DeliverySinksWhere Subtrigger sends messages: Telegram, browser notifications, signed webhooks and AI agents, and how to test them.
- DeliveryProxiesA proxy sends the values of one stream to a sink as often as you choose: what it sends, the throttle, proxy or alert.