> For the complete documentation index, see [llms.txt](https://docs.bigbeluga.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bigbeluga.com/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="/files/31Y8lwDdOId8WogqImmN" 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="/files/UfpSDC9Bxv4xUCiVbzjV" 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="/files/fpu034pE13wPynAo6YLN" 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="/files/ffiGD0caZPbJe0BCpvry" 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="/files/Y9hH5l4gMLkf8RsGLOrc" 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="/files/8GwY6Hdz62xw8GOup9sS" 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="/files/WU76vYKZnnuvTh04M4Pu" 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.

***