Documentation contents

Screener

Alerts

An alert is a rule for one bundle: a metric, a condition, a threshold and a trigger mode. It is created with the "Alert…" command at a screener row; the list is the "Alerts" subsection. In the bot — the "⏰Alerts" menu and the "⏰Alert" button on the card.

Metrics:

  • "Last price spread" = (last price A ÷ last price B − 1) × 100;
  • "Bid1/ask1 spread" = (bid1 A ÷ ask1 B − 1) × 100 — requires order book data;
  • "Funding diff (8h)" = rate A per 8 hours minus rate B; spot counts as zero.

Legs A and B follow the order of the mode's roles: in "Price spread" A is the more expensive one, in "Funding · Rate" — the one with the higher rate, in "Funding · Payout" — the early one; so in the funding modes the sign of the alert's spread may be the opposite of the table's. A metric without data for the pair is unavailable.

Conditions: "above", "below" — strict; "within" — bounds included; "outside" — strictly outside. The threshold is in percent, can be negative and is rounded to 0.01.

Triggering:

  • by default — once;
  • repeat — every N minutes (1–1,440 in the app, 5 by default), no more than 60 times in a row; the counter resets when the condition stops being met;
  • a completed alert is deleted unless "Keep after it fires" is checked; otherwise it becomes inactive;
  • validity period — 30 days after creation or enabling, after which the alert becomes inactive; enabling it again resets the period and the counter.

The bot checks alerts once a second. If a leg has disappeared from the market, the alert is deleted with a notification in Telegram. An identical active alert is not created a second time.

Where triggers are delivered:

  • Telegram — always: the bundle, the condition, the current value and the repeat number;
  • app — a notification on the device if "Screener alert fired" → "In the app" is on (on by default), while the app is running.

The number of alerts is limited by the subscription plan (see "App → Account → Subscription"); if the plan no longer allows them, existing alerts are turned off but not deleted.