# 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="https://3353728891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1dlOGDREop4WMfLcctYT%2Fuploads%2FzRrgBRvM61A9fLioZiqH%2Fimage.png?alt=media&#x26;token=177b0cde-599c-4e1e-8c30-2f2294fe802c" 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="https://3353728891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1dlOGDREop4WMfLcctYT%2Fuploads%2FBPNiRyVBNIdHsMiQto3i%2Fimage.png?alt=media&#x26;token=989e538d-0a6f-4c05-95a9-fd66f92cfaf6" 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="https://3353728891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1dlOGDREop4WMfLcctYT%2Fuploads%2FyMHtNZv7DWfR0eEJlk9Q%2Fimage.png?alt=media&#x26;token=1ae418f0-cf1b-4df1-85fe-c17a4f705a4f" 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="https://3353728891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1dlOGDREop4WMfLcctYT%2Fuploads%2FeBNT127u359QueLaVWY2%2Fimage.png?alt=media&#x26;token=8a57f54f-e396-4534-9f21-48233e001abc" 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="https://3353728891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1dlOGDREop4WMfLcctYT%2Fuploads%2FdiUiBz4epjnAHCaRIqoZ%2Fimage.png?alt=media&#x26;token=b040fb70-9d4d-4689-8083-c913d6821b25" 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="https://3353728891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1dlOGDREop4WMfLcctYT%2Fuploads%2Fiuh0DhTEuiHteZ4z7oDO%2Fimage.png?alt=media&#x26;token=0915404a-af1c-4335-b58d-e23d7c39a685" 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="https://3353728891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1dlOGDREop4WMfLcctYT%2Fuploads%2FISAdTdeJOQvUlPG1f7gO%2Fimage.png?alt=media&#x26;token=a5542413-d986-40c1-a1ee-7438695130bc" 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.

***
