KESTREL docs
v1.0.0
Get help
● Use · Stay informed

Alerts and notifications
in the app, by push, Telegram and email.

Price alerts with four conditions, and notifications for fills, take-profit and stop hits, bot events and security events, delivered where each user wants them.

Above · below · cross · % movePushTelegramEmail

01Price alerts

Alerts, New price alert, or Set alert on a market. Alerts only notify; they never place orders.

ConditionFires when
Above / BelowThe last price is at or beyond the price (also on the first check)
CrossThe price moves through the level between two checks, in either direction
% moveThe price moved at least this %, up or down, from any price within the window (1 to 1440 minutes)
  • Repeat: off, the alert fires once and becomes "triggered". On, it re-arms when the price is back on the other side, at most once every 5 minutes.
  • Notify me by: my preferences (Notification settings), in-app only, or chosen channels. Email needs a verified address.
  • Note (up to 200 characters): shown in the app, push and Telegram, never in email.
  • Pause, Resume, Edit the trigger value. The condition itself cannot change; delete the alert and create a new one.
  • Up to 100 alerts per user (the plan can set fewer in SaaS mode). The server checks alerts every few seconds.

02What users are notified about

GroupEvents
TradesTake-profit filled, stop loss hit, trade closed, trade error
BotsBot started, stopped, max loss reached, error, health change (stalled, degraded, error and recovery), copy link paused
AlertsPrice alert triggered
SecurityKill switch changed, new sign-in, close-all, risk limit breached, an action taken from Telegram (in-app and push only)

Every notification is kept in the app's Inbox (the newest 200) and appears live while the app is open.

03Notification settings

Settings, Notification settings: for each group, switch push, Telegram and email on or off. Defaults: push and Telegram on everywhere, email only for security.

  • Email: Send me a code, enter the 6-digit code (valid 30 minutes), and the address is verified. Email goes only to a verified address, at most 20 an hour.
  • Telegram: Connect Telegram gives a link to the operator's bot. Open it on the phone and press Start in the bot chat; the link works once, for 10 minutes. The private chat then receives notifications and can use the control commands (Telegram control). Unlink stops both.
  • Push: Devices shows whether this device is registered (Push notifications).

A channel the operator has not set up is shown as "Not set up by the operator of this server".

04What the operator sets up

ChannelNeedsCost
In-appNothingFree
PushA Firebase service account on the server and Firebase in the app build (Push)Free (Firebase Cloud Messaging)
TelegramYour Telegram bot token (Create the bot)Free
EmailAn SMTP URL and a sender address (Configuration)Your SMTP provider's free tier, then paid