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:

OptionFires
On crossingWhen the condition becomes true. Again only after it turns false.
Every matchOn every new value that matches.
OnceOn 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.

FormatWhat you getPlan
TextSent as writtenFree
MarkdownBold, links, lists; formatted in TelegramPro
JSONValues go in as JSON; for webhooks and agentsPro

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

FreePro
Alerts5100
Comparisons per condition210
Stream against stream, arithmeticโ€”โœ“
IndicatorsPrices, SMA, EMA, RSIAll
Every new valueโ€”โœ“
Message formatsTextText, Markdown, JSON
History24 hours3 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.