Alert Types

The Aegis bot sends Telegram alerts for key runtime events. The following table covers alerts that are live in the current beta — events that the runtime actively emits via the ALERT_TYPE contract in apps/bot/src/platform/notification/infrastructure/telegram-bot.adapter.ts.

Live alerts

Alert type	Trigger condition
`SHORT_OPENED`	A hedging position (short futures) was successfully opened at the exchange
`SHORT_CLOSED`	A hedging position was closed, with final realized PnL and close reason
`ERROR`	A bot execution error occurred (unhandled exception or adapter failure)
`MARGIN_WARNING`	Exchange margin ratio dropped below the configured threshold
`FUNDING_WARNING`	Futures funding rate exceeded the configured warning level
`INSUFFICIENT_BALANCE`	Exchange account balance is insufficient to open or maintain a position

All six types are sent to the operator-configured Telegram chat. No per-user filtering or routing is available in the current beta.

Alert content

Each alert message includes contextual data relevant to the event type:

SHORT_OPENED / SHORT_CLOSED — hedge position details (symbol, side, size, entry/exit price) and the close reason. SHORT_CLOSED also includes realized PnL.
ERROR — error message and stack trace (when available).
MARGIN_WARNING — exchange venue and current margin ratio.
FUNDING_WARNING — exchange venue and current funding rate.
INSUFFICIENT_BALANCE — exchange venue, required amount, and available amount.

Activity events (not Telegram alerts)

Strategy activity events such as leg trigger fired (an LP range leg reaching its trigger price) are tracked internally by the bot FSM but are not sent as Telegram alerts in the current beta. They may appear in the dashboard activity log.