# Bubble Magic Window Manual

This manual explains how to read the Bubble Magic window inside the 01DTE app. It is written for the trader/operator looking at the screen, not for code changes.

Bubble Magic is a live tape-pressure window. It is designed to answer:

```text
Who is pressing right now?
Where is price inside the current cycle?
Is pressure expanding, fading, trapping, or chopping?
Is the current move worth following, fading, or waiting on?
```

It is not a standalone buy/sell signal. It is a pressure and location tool. Use it with the chart, Wall Hunter, Omega Link path, OR Telemetry, and your normal risk rules.

## Where It Is

In the app, the Bubble Magic area has two visible parts:

1. The large `BUBBLE MAGIC · 01DTE PRICE MAP` window.
2. The `15M RANGE` strip directly under it, with the 6M bubble pressure puck.

The large window shows the current tape map. The strip underneath tells where that pressure sits inside the rolling 15-minute range.

## Big Picture

Read Bubble Magic in this order:

1. Confirm the selected asset: `ES`, `NQ`, `RTY`, or `YM`.
2. Check the live price and bid/ask at the top of the Bubble Magic window.
3. Locate price between `U`, `L`, and `LC`.
4. Read the recent bubbles: color, size, age, and price location.
5. Read the live cycle ball and the right-side `CYCLE` rail.
6. Check the right-side `PRESSURE` rail.
7. Check the `PATH` rail for active Omega Link target, reclaim, and fail.
8. Read the `15M RANGE` strip and the 6M puck.

The safest read comes when the window, the pressure rail, the range strip, and the path rail agree.

## The Price Map

The large chart is labeled:

```text
BUBBLE MAGIC · 01DTE PRICE MAP
3M CONTEXT 90M
```

It shows a compact price map using recent live tape, bubble buckets, cycle range, and structure context.

Important lines:

- `U`: current cycle high / upper range.
- `L`: current cycle low / lower range.
- `LC`: last closed cycle price.
- Live price line: where the current tape is trading.

How to interpret it:

- Price near `U` means the tape is testing the upper edge of the current cycle.
- Price near `L` means the tape is testing the lower edge.
- Price around `LC` means price is near the prior cycle close and may still be undecided.
- Price outside or pinned near an edge needs confirmation from pressure and path before chasing.

## Bubble Colors

Small bubbles show recent participation around price.

- Green bubbles: buy/ask pressure.
- Red bubbles: sell/bid pressure.
- Yellow bubbles: mixed or balanced tape.

The color is based on live trade-side pressure, not candle color.

## Bubble Size And Fade

Bubble size reflects participation strength. More prints and stronger recent participation make the bubble larger.

Bubble opacity fades with age. Fresh bubbles matter more than old faint bubbles.

Asset-specific visible windows:

```text
NQ  about 90 seconds
RTY about 120 seconds
ES  about 150 seconds
YM  about 150 seconds
```

Do not overread an old faded bubble. The edge is in fresh pressure.

## The Live Cycle Ball

The moving ball in the Bubble Magic chart and the matching ball in the right-side `CYCLE` rail show current tape position inside the active cycle.

Cycle timing:

```text
NQ  3 minutes
RTY 4 minutes
ES  5 minutes
YM  5 minutes
```

Typical cycle reads:

- Green ball: buyers have the current cycle advantage.
- Red ball: sellers have the current cycle advantage.
- Yellow/mixed ball: no clean cycle owner.

Interpretation:

- Green ball rising from lower/mid range can support continuation.
- Red ball falling from upper/mid range can support continuation lower.
- Green ball at the very top can also mean late buyers are pressing the high, so do not chase without acceptance.
- Red ball at the very bottom can also mean late sellers are pressing the low, so do not chase without acceptance.

## The Right-Side Pressure Rail

The `PRESSURE` rail is the live tape pressure score.

- Positive score: buy pressure.
- Negative score: sell pressure.
- Near zero: mixed pressure.

Use it as agreement or disagreement:

- Long continuation is cleaner when the pressure rail is positive and the bubbles are green.
- Short continuation is cleaner when the pressure rail is negative and the bubbles are red.
- If bubbles say buy but the pressure rail is weak or negative, the move may be fading or trapping.
- If bubbles say sell but the pressure rail is weak or positive, the downside push may be losing control.

## The Right-Side Cycle Rail

The `CYCLE` rail is the vertical version of the current cycle.

It shows:

- `RANGE HI`
- current tape price
- `RANGE LO`
- live colored cycle bubble

Use it to avoid bad location:

- Do not blindly chase longs into `RANGE HI`.
- Do not blindly chase shorts into `RANGE LO`.
- The best information often appears when price reaches an edge and the bubbles either confirm acceptance or reveal failure.

## The Right-Side Path Rail

The `PATH` rail shows Omega Link context when there is an active path.

When active, it can show:

- `TARGET`: the forward level.
- `RECLAIM`: the zone/entry area that supports the path.
- `FAIL`: the invalidation level.
- `TAPE`: current live price.

Interpretation:

- If Bubble Magic pressure points toward the target and price holds the reclaim/zone, the path has support.
- If Bubble Magic pressure flips against the path near the fail level, the path is weakening.
- If the path rail says waiting, Bubble Magic can still show tape pressure, but the system has no confirmed forward path.

## The 01DTE Read Box

The `01DTE READ` box below the price map summarizes structure:

- `RESISTANCE`: nearest meaningful upper wall/structure.
- `SUPPORT`: nearest meaningful lower wall/structure.
- `TARGET`: next mapped destination.
- `RANGE`: current cycle high and low.
- `EVENT`: latest mapped event.
- `FLOW`: current flow summary.

Use it as the map. Use bubbles as the live pressure. Use the path rail as the tactical route.

## The 15M Range Strip

The `15M RANGE` strip is the rolling 15-minute battlefield.

It tracks:

- rolling 15-minute low
- rolling 15-minute high
- prior 15-minute close
- current live price
- current position inside the range
- bubble/trade pressure over the recent pressure window

The header has this shape:

```text
UP +x.xx / DN -x.xx · 6M BUY/SELL/RANGE · RANGE x.xx
HIGH 49% +24T ES
```

The first part tells whether live price is above or below the prior 15-minute close.

- `UP`: price is above the prior 15-minute close.
- `DN`: price is below the prior 15-minute close.
- `AT CLOSE`: price is close to the prior 15-minute close.
- `COLLECTING`: not enough clean data yet.

The `RANGE` value is the width from rolling 15-minute low to rolling 15-minute high.

## The 15M Bar

The bar has three important references:

- `LOW`: rolling 15-minute low.
- `HIGH`: rolling 15-minute high.
- live knob/puck: current price location inside that range.

Position matters:

- 0% to 30%: lower range area.
- 30% to 70%: mid range.
- 70% to 100%: upper range area.

Mid range usually means wait unless another module gives a very clean setup.

## The 6M Bubble Puck

The round puck on the 15M strip is the recent 6-minute bubble pressure read.

It can show:

- `BUY`
- `SELL`
- `RANGE`
- `TRAP`
- `--` when collecting or stale

The puck size and `E%` number show edge strength. Higher `E%` means a stronger read, but it is not a win probability.

The foot text looks like:

```text
6M BUY SNAP - FOLLOW · RESP +6.25 · NET +42 · EDGE 67% · LIVE 23125.50
```

Meaning:

- `RESP`: price response from the recent bubble baseline.
- `NET`: buy minus sell pressure, normalized as a signed percent.
- `EDGE`: combined pressure dominance and price response strength.
- `LIVE`: current tape price.

## 6M Bubble States

Use these labels carefully:

### NO EDGE - RANGE

Pressure is mixed or not dominant enough.

Action: wait. Let price reach an edge or let pressure become clearer.

### BUY PRESSURE - NEED LIFT

Buy prints are stronger, but price response is not yet strong enough.

Action: do not chase. Look for lift, acceptance above a level, or path confirmation.

### SELL PRESSURE - NEED DROP

Sell prints are stronger, but price response is not yet strong enough.

Action: do not chase. Look for drop, acceptance below a level, or path confirmation.

### BUY SNAP - FOLLOW

Buy pressure and price response are aligned.

Action: follow only if location is not poor and the path/pressure rail agree. Be careful if price is already at range high.

### SELL SNAP - FOLLOW

Sell pressure and price response are aligned.

Action: follow only if location is not poor and the path/pressure rail agree. Be careful if price is already at range low.

### BUY ABSORB - NO LIFT

Buy pressure is appearing, but price is not lifting. Buyers may be getting absorbed.

Action: watch for a top failure or short fade setup, especially near range high.

### SELL ABSORB - NO DROP

Sell pressure is appearing, but price is not dropping. Sellers may be getting absorbed.

Action: watch for a bottom lift or long fade setup, especially near range low.

### BUY SNAP - HOLD PRESSURE / SELL SNAP - HOLD PRESSURE

This is mainly an NQ latch behavior. After a snap, pressure can stay latched briefly if the same side keeps pressing.

Action: treat it as a continuation read only while location and path still agree.

## 15M Range Edge Reads

The right side of the 15M header can show:

```text
HIGH 61% +18T
LOW 57% -14T
```

This means the system currently sees the stronger pressure profile toward that edge.

- `HIGH`: the high edge has the stronger reach score.
- `LOW`: the low edge has the stronger reach score.
- `%`: pressure/location score toward that edge.
- `+18T` or `-14T`: tick distance to that edge.

This is not a guaranteed probability. It is a context score built from distance, slope, flow, and prior-close bias.

## Important Range Modes

These are the main 15M conditions behind the strip and alerts:

### TOP_WATCH

Price is near the 15-minute high.

Action: watch for acceptance above the high or failure back inside.

### TOP_PRESSURE_WAIT

Buy pressure is pressing the high, but there is not a clean rollover or acceptance yet.

Action: wait. This is the danger zone for chasing.

### TOP_FADE_RISK

Price is near the high and sell pressure or fading buy pressure is appearing.

Action: possible short fade context. Confirm with red bubbles, pressure rail, failed path, or rejection on chart.

### BREAKOUT_WATCH

Price is at/near high with buy pressure, rising slope, and response.

Action: possible continuation, but it still needs acceptance. Do not short just because price is high.

### BOTTOM_WATCH

Price is near the 15-minute low.

Action: watch for acceptance below the low or lift back inside.

### BOTTOM_PRESSURE_WAIT

Sell pressure is pressing the low, but there is not a clean rollover or acceptance yet.

Action: wait. This is the danger zone for chasing shorts.

### BOTTOM_BOUNCE_RISK

Price is near the low and lifting pressure is appearing.

Action: possible long fade/bounce context. Confirm with green bubbles, pressure rail, failed downside path, or reclaim on chart.

### BREAKDOWN_WATCH

Price is at/near low with sell pressure, falling slope, and downside response.

Action: possible continuation, but it still needs acceptance. Do not go long just because price is low.

### MID_RANGE / TIGHT_RANGE / NO_EDGE

Price is not at a good edge, or pressure is not strong enough.

Action: wait. Mid-range trades are usually lower quality.

### PRESSURE_FADING

Pressure is changing but the current flow is weak or mixed.

Action: avoid chasing. Watch for trap or reversal confirmation.

## Common Reads

### Clean Long Continuation

Look for:

- price above prior 15-minute close
- green bubbles
- positive pressure rail
- 6M `BUY SNAP - FOLLOW` or strong `BUY PRESSURE - NEED LIFT` that resolves upward
- path rail target above, if active
- price not already exhausted into range high unless accepted above it

Best action: follow pullbacks/reclaims, not late vertical candles.

### Clean Short Continuation

Look for:

- price below prior 15-minute close
- red bubbles
- negative pressure rail
- 6M `SELL SNAP - FOLLOW` or strong `SELL PRESSURE - NEED DROP` that resolves downward
- path rail target below, if active
- price not already exhausted into range low unless accepted below it

Best action: follow failed reclaims/acceptance lower, not late flushes.

### Top Fade Setup

Look for:

- price at upper 15M range, usually 70% to 100%
- 6M `BUY ABSORB - NO LIFT`, `TRAP`, or fading buy pressure
- red bubbles begin appearing near range high
- pressure rail weakens or turns negative
- path rail fails or target is no longer being accepted

Best action: short only after failure/rejection, not simply because price is high.

### Bottom Bounce Setup

Look for:

- price at lower 15M range, usually 0% to 30%
- 6M `SELL ABSORB - NO DROP`, `TRAP`, or fading sell pressure
- green bubbles begin appearing near range low
- pressure rail strengthens or turns positive
- price reclaims the low/zone or the downside path fails

Best action: long only after lift/reclaim, not simply because price is low.

### No Trade / Wait

Wait when:

- 6M says `NO EDGE - RANGE`
- the 15M strip says mid range
- the pressure rail is near zero
- bubbles are yellow or alternating red/green
- path rail says waiting
- price is between major references with no acceptance

The best Bubble Magic reads usually happen at edges, not in the middle.

## Fast Operator Checklist

Use this 10-second checklist:

1. Is live price fresh and moving?
2. Is price near `U`, `L`, `LC`, range high, or range low?
3. Are fresh bubbles mostly green, red, or yellow?
4. Is the pressure rail agreeing?
5. Does 6M say follow, wait, trap, or range?
6. Is 15M near an edge or stuck mid-range?
7. Does the path rail support the same direction?
8. If entering, where is the fail/invalidation?

If you cannot answer all eight, the trade is probably not clean yet.

## What Not To Do

- Do not buy only because the puck says `BUY`.
- Do not sell only because the puck says `SELL`.
- Do not fade only because price is at the high or low.
- Do not chase a snap after price has already reached an edge unless acceptance confirms.
- Do not trust stale/collecting reads.
- Do not ignore Wall Hunter, OR Telemetry, chart structure, or path invalidation.

## Reliability Notes

Bubble Magic is strongest during live liquid sessions when DOM/tape telemetry is fresh.

It can be weaker when:

- market is closed or thin
- websocket/DOM data is stale
- the selected asset has no recent bubbles
- price is mid-range and alternating
- a fast move already happened before the read updated

When in doubt, treat Bubble Magic as context, not permission.

## Source Notes

Main operator UI:

```text
Components/OmegaCloudBook.razor
Components/OmegaDashboard.razor
```

15M range and pressure classifier:

```text
Services/OmegaFifteenMinuteBubbleIntentEngine.cs
```

Bubble burst detector:

```text
Services/OmegaBubbleBurstDetector.cs
```

Existing supporting notes:

```text
CSHARP_OMEGA_CLOUD_PRICE_MAP_MANUAL.md
BUBBLE_MAGIC_SALES_PAGE.md
FIFTEEN_MINUTE_RANGE_SALES_PAGE.md
```

## Bottom Line

Bubble Magic shows live pressure and location.

Use it to decide whether the tape is:

- driving
- accepting
- failing
- trapping
- fading
- chopping

The cleanest trades come when Bubble Magic, 15M Range, pressure rail, path rail, and chart structure all tell the same story.

