> 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/toolkits-pro-plus/market-waves-pro/custom-step-alerts.md).

# Custom Step Alerts

Custom Step Alerts chain several conditions into one sequenced trigger: the alert only fires when your
steps happen in the order you defined, inside a bar limit you set.

A single event tells you very little on its own. An AlphaWave flip followed by a pixel retest inside
the OTE zone tells you that the new trend was confirmed by structure — and that is the kind of
sequence this engine is built to capture.

<div data-with-frame="true"><figure><img src="/assets/pro-plus-market-waves-custom-step-alerts.png" alt=""><figcaption>A two-step example: a bullish reversal sweep on step 1, then the AlphaWave trend flip on step 2 within a 10 bar window</figcaption></figure></div>

In the example above the sequence is **Reversal Sweep on step 1** and **AlphaWave Trend on step 2**,
with the bar window set to 10. The sweep marks the exhaustion, the trend flip confirms it, and the
tracker at the bottom of the chart shows the window between the two steps.

## Setup controls

- **Use Custom Alerts** — turns the whole sequence engine on or off.
- **Max Bars allowed between steps** — the countdown. Once step 1 fires, the engine starts counting
  bars; if the next step does not happen within that window, the sequence resets to step 1.

<div align="left" data-with-frame="true"><figure><img src="/assets/pro-plus-market-waves-custom-step-controls.png" alt=""><figcaption>Use Custom Alerts, the bar window and the six condition rows with their step fields</figcaption></figure></div>

{% hint style="info" %}
Reset behaviour is the point of the bar limit. Without it, a condition from last week could still
complete a sequence with a fresh signal today.
{% endhint %}

## Steps 1 to 5

Every condition is assigned a step number between 1 and 5. That number is what turns a list of
conditions into a sequence.

- **Sequential steps** — different step numbers run in order. Step 2 must arrive on a later bar than
  step 1 before the sequence moves forward.
- **Simultaneous steps** — the same step number means both conditions have to hit on the exact same
  candle to satisfy that step.

Six conditions are available, each with its own step field:

| Condition         | What it fires on                                                          |
| ----------------- | -------------------------------------------------------------------------- |
| AlphaWave Trend   | Any trend flip, bullish enter or bearish exit                               |
| AlphaWave Retest  | Any, bullish or bearish retest of the wave                                  |
| Pixel Flip        | Any flip, pixel bull flip or pixel bear flip                                |
| Pixel Retest      | Any, bullish or bearish pixel retest inside the OTE zone                    |
| Reversal Signal   | Any, bull or bear reversal                                                 |
| Reversal Sweep    | Any, bull or bear sweep of an invalidation level                            |

{% hint style="info" %}
A condition can only be used in a sequence while its module is enabled in the main settings. The Pixel
rows need Pixel Trend on, and Pixel Retest also needs Fibonacci OTE and Mean Reversion.
{% endhint %}

## External source conditions

Three external sources let you pull other series into the sequence — another indicator, a moving
average, price itself.

<div align="left" data-with-frame="true"><figure><img src="/assets/pro-plus-market-waves-custom-step-external.png" alt=""><figcaption>External Source 1 to 3: source, condition, comparison value and step number</figcaption></figure></div>

| Setting           | Description                                                                                   |
| ----------------- | --------------------------------------------------------------------------------------------- |
| Source            | The series that is evaluated.                                                                  |
| Condition         | Equal, Greater Than, Less Than, Crossing Over, Crossing Under, Crossing, True or False.        |
| Comparison target | The value the source is compared with. Not used by True or False.                              |
| Step              | Which step of the sequence this source belongs to.                                             |

Selecting True or False turns the source into a binary condition, which is how you require a state
("price above the 200 EMA") rather than an event.

## Time filter

**Enable Time Filter** restricts the whole sequence to a session window, with its own timezone — the
default is `1600-0100` on `UTC+4`, which is the New York session in Dubai time. Any step that fires
outside the window is ignored, so an overnight sequence cannot complete before you are watching.

<div align="left" data-with-frame="true"><figure><img src="/assets/pro-plus-market-waves-custom-step-time.png" alt=""><figcaption>The time filter row: session window and timezone</figcaption></figure></div>

## How to create a Custom Step Alert

{% stepper %}
{% step %}

### Turn the sequence engine on

Check **Use Custom Alerts** and set **Max Bars allowed between steps** — 20 bars by default. Until the
engine is on, the condition dropdowns are only display filters and no sequence is tracked.
{% endstep %}

{% step %}

### Assign the steps

Move every condition you want to use from Disabled to its event, then type a step number next to it.
In the example at the top of this page **Reversal Sweep** is set to a bull sweep on step `1` and
**AlphaWave Trend** to a bullish enter on step `2`, so the trend flip only counts once a sweep has
already opened the window. Anything you leave on Disabled is ignored by the sequence.
{% endstep %}

{% step %}

### Add outside filters (optional)

Enable any of the three external sources, pick the series, choose the condition, type the comparison
value and give it a step number.
{% endstep %}

{% step %}

### Restrict the sequence to a session (optional)

Enable **Time Filter**, set the session window and pick the timezone.
{% endstep %}

{% step %}

### Create the alert in TradingView

Press Alt + A (or the clock icon in the right toolbar) and configure the dialog:

<div align="left" data-with-frame="true"><figure><img src="/assets/pro-plus-market-waves-custom-step-dialog.png" alt=""><figcaption>Market Waves PRO+ with the Custom Alert() option selected in the second dropdown</figcaption></figure></div>

- **Condition:** `Market Waves PRO+`
- **Second dropdown:** `Custom Alert()`
- **Trigger:** once only, so the alert keeps watching for new sequences
- **Name / Message:** name the alert after the sequence it watches, and write a message that tells you
  which sequence completed.

Create the alert once. The engine now watches for your steps and fires when the whole chain completes
inside the bar window.
{% endstep %}
{% endstepper %}

## Settings

| Settings                        | Description                                                                    |
| ------------------------------- | ------------------------------------------------------------------------------ |
| Use Custom Alerts               | Enable the multi-step sequence engine.                                          |
| Max Bars Between Steps          | Bars allowed between two steps before the sequence resets.                      |
| Module rows                     | Condition plus step number for AlphaWave, Pixel, reversals and sweeps.          |
| External Source 1 / 2 / 3       | Source, condition, comparison target and step for outside series.               |
| Enable Time Filter              | Limit the sequence to a session, with its own timezone.                         |
