BreakScan FX

404
# BreakScan FX — User Manual
Pine Script v6 · Overlay Indicator · 7-symbol range-break monitor

## 1. OVERVIEW
BreakScan FX is a flat, white-background monitoring panel that tracks 7 manually
configurable FX / gold symbols and tells you, at a glance, whether each one is
BREAKING, TESTING, or IDLE against its own recent high/low range.

Instead of flipping between 7 charts, you get one compact table in the top-right
corner of your chart that ranks symbols by urgency — the ones actually doing
something float to the top.

## 2. WHAT EACH ROW TELLS YOU
Columns: SYMBOL / GIMIC / MEANING

States:
BREAK Close above range high (up) or below range low (down)
BREAK+ Same as BREAK, but occurred within last N bars (flash)
TEST Not breaking, but within proximity threshold of a boundary
IDLE Neither — mid-range

Row ordering: BREAK first, then TEST, then IDLE.
Header row sits above everything in crimson red.

## 3. SETTINGS REFERENCE

### Group 1 — Symbols (7)
Each slot: Symbol N (EXCHANGE:TICKER) + Display N (table label).
Defaults: EURUSD / GBPUSD / AUDUSD / NZDUSD / USDJPY / USDCHF / USDCAD (all OANDA:).
Display label is free text — cosmetic only, no effect on detection.

### Group 2 — Detection
Detection Timeframe default 60 (1H)
Timeframe on which the range is measured. INDEPENDENT of chart timeframe.
Range Lookback Bars default 20
Bars back the range high/low is calculated from.
Test Proximity (%) default 0.15
How close to a boundary (in %) counts as TEST.

Range is built from the PREVIOUS N bars, EXCLUDING the current bar ([1] offset) —
prevents the current bar from defining its own breakout level.

Tuning:
Tighter proximity (0.05–0.10) → fewer TEST rows. Quiet markets.
Looser proximity (0.20–0.30) → more TEST rows, earlier warning. Volatile sessions.
Shorter lookback (10) → minor swing breaks; more noise.
Longer lookback (50–100) → significant breaks only; higher quality.

### Group 3 — Display
Text Size default small (tiny/small/normal/large)
Show Parameter Values on Status Line default OFF
NOT YET IMPLEMENTED — toggling has no effect. Leave off.

### Group 4 — Gimmick (all cosmetic)
Enable Gimmick default ON — master switch
Pulse Period (bars) default 6, range 2–20
Blink Period (bars) default 2, range 1–10
Break Flash Duration (bars) default 3, range 1–20
After this many bars, BREAK+ reverts to plain BREAK.
For a completely static panel, turn Enable Gimmick OFF.

## 4. READING THE PANEL
1. Top row first — a fresh BREAK flash is your immediate candidate.
2. Count TEST rows. Multiple correlated TESTs (EURUSD + GBPUSD highs) = broad
USD weakness, not a single-pair move.
3. Ignore IDLE rows unless hunting range-bound setups.
4. Direction glyph: up = testing/breaking the HIGH; down = the LOW.

Combinations:
EURUSD up-TEST + GBPUSD up-TEST + USDCHF down-TEST → broad USD weakness
USDJPY BREAK up alone → idiosyncratic JPY move
All 7 IDLE → dead session
Multiple BREAK rows → momentum / trend day

## 5. DETECTION LOGIC (TECHNICAL)
rangeHigh = highest(high, lookback)[1] // excludes current bar
rangeLow = lowest(low, lookback)[1]
isBreakUp = close > rangeHigh
isBreakDn = close < rangeLow
isBreak = isBreakUp or isBreakDn
distHighPct = abs(close - rangeHigh) / rangeHigh * 100
distLowPct = abs(close - rangeLow) / rangeLow * 100
isTest = not isBreak AND (distHighPct <= proximity OR distLowPct <= proximity)

State code: 2 = BREAK, 1 = TEST, 0 = IDLE.
gaps=barmerge.gaps_off, lookahead=barmerge.lookahead_off → no repaint, no leakage.

## 6. LIMITATIONS
- 7 symbols maximum (hard-coded).
- Single detection timeframe shared by all 7 slots.
- Table is top-right and overlays price. Move via source if it obscures candles.
- Rounded corners NOT possible in Pine (table has no border radius).
- Status line not yet implemented.
- Short title now "BreakScan" (9 chars) — 0 compile warnings.

## 7. QUICK-START
1. Add BreakScan FX to any chart (panel is symbol-independent).
2. Settings → 1. Symbols (7): set instruments + labels.
3. Settings → 2. Detection: timeframe, lookback, proximity.
4. Gimmick ON for pulse, OFF for static.
5. Read the top row first.

---
Educational tool for range-break monitoring. Flags where price sits relative to a
recent range — does not generate buy/sell signals or place orders.
Verify all levels independently before acting.

Penafian

Maklumat dan penerbitan adalah tidak bertujuan, dan tidak membentuk, nasihat atau cadangan kewangan, pelaburan, dagangan atau jenis lain yang diberikan atau disahkan oleh TradingView. Baca lebih dalam Terma Penggunaan.