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.

免責聲明

這些資訊和出版物並非旨在提供,也不構成TradingView提供或認可的任何形式的財務、投資、交易或其他類型的建議或推薦。請閱讀使用條款以了解更多資訊。