> For the complete documentation index, see [llms.txt](https://docs.bigbeluga.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bigbeluga.org/ai-extension-sonar-tm/home/smart-alert-engine.md).

# Smart Alert Engine

<mark style="color:$info;">The Smart Alert Engine is a real-time market monitoring system integrated into the Sonar Extension. It acts as an automated analyst, scanning live Order Book (OB) and Long/Short (L/S) data feeds to identify high-probability trading signals and structural market shifts.</mark>

<div data-with-frame="true"><figure><img src="/assets/bc0f5a3a173f0ebc09457491479d1552855a5ce5096c4b0db034f5db08d30e69.png" alt="" width="563"><figcaption></figcaption></figure></div>

### Real-Time Dashboard Metrics

<mark style="color:$info;">At the top of the engine, you get an instant "health check" of the current symbol (e.g., BTCUSDT):</mark>

<div data-with-frame="true"><figure><img src="/assets/d38c08be66248d16dcccf0e0184d86284fecceb9371fe117022fb5ae6c6bc34f.png" alt=""><figcaption></figcaption></figure></div>

* <mark style="color:$info;">Spread (bps): Tracks the gap between the highest bid and lowest ask in basis points.</mark>
* <mark style="color:$info;">Imbalance (%): Measures the discrepancy between buy and sell pressure in the order book.</mark>
* <mark style="color:$info;">Long Flow (%): A live look at the percentage of aggressive buying vs. selling momentum.</mark>

### Automated Signal Feed

<mark style="color:$info;">The engine generates three levels of alerts (INFO, WARN, CRITICAL) based on market behavior:</mark>

* <mark style="color:$info;">Bid/Ask Wall Detection: Automatically detects when a large volume of liquidity (e.g., 1000+ ETH) is placed near the current price. This helps identify potential support and resistance levels before they are hit.</mark>

<div data-with-frame="true"><figure><img src="/assets/ffba7af8a9ee18c0c612cd61664a078b8a416f5942a98afd7cbd36f00cd13d0d.png" alt="" width="539"><figcaption></figcaption></figure></div>

* <mark style="color:$info;">Flow Bias Flips: Notifies you the moment the market sentiment shifts from Long to Short (or vice versa) as the bias crosses the 50% threshold.</mark>

<div data-with-frame="true"><figure><img src="/assets/6409dab730245e5b4bb537a4e3102c297bf5a0150df2b7ccfd546338b2e22cff.png" alt="" width="539"><figcaption></figcaption></figure></div>

* <mark style="color:$info;">Sentiment Extremes: Flags "Critical" alerts when market pressure hits extreme levels (approaching 100%). This often precedes a short-squeeze or a rapid price reversal.</mark>

<div data-with-frame="true"><figure><img src="/assets/8dcae39ee2c40c647c739916322786a07172deeb430e49d16d9ac0bcf09bf94d.png" alt="" width="539"><figcaption></figcaption></figure></div>

* <mark style="color:$info;">Momentum Shifts: Tracks the speed of order flow. If buying or selling pressure spikes significantly over recent "buckets" of time, the engine flags a momentum shift.</mark>

<figure><img src="/assets/365913d4309ca096c0b8ccb019f63fa136687ea9649ae70aa847eb11f258ac4f.png" alt="" width="539"><figcaption></figcaption></figure>

* <mark style="color:$info;">Order Book Imbalance: A warning system that triggers when one side of the book becomes significantly heavier than the other, suggesting an impulsive move is imminent.</mark>

<figure><img src="/assets/6cb8d761040c1a620beb8bc34b8d977191862084087712b7d148ba870f1c59b9.png" alt=""><figcaption></figcaption></figure>

### Engine Status

* <mark style="color:$info;">Engine Armed: Indicates the system is connected to live feeds and actively scanning for signals.</mark>
* <mark style="color:$info;">Partial Signal Feed: Displayed when one or more data feeds (like L/S) are toggled off or unavailable, providing limited intelligence.</mark>

> Note: All signals are probabilistic and generated based on live order flow data. They are designed to supplement your strategy, not act as financial advice.

***