GoldenRobber EA

MQL5 Expert Advisor · XAUUSD · DCA Hedging · SR / Trend / Sideway / Pivot Point (4 methods + Auto) Filters · Tia Cluster + DCA TP synergy · EA v1.41.1 (config pass58) · doc v2.3

1. Tổng quan

2. Cách EA vận hànhHow the EA works

Chu kỳ vòng lệnhTrade Round Cycle

Mỗi round bắt đầu khi EA mở một cặp Init (cùng R{n}): Buy và Sell với nhãn P hoặc N trong comment — UP: Buy=P (lot DCAPos), Sell=N (lot DCANeg); DOWN: Sell=P, Buy=N. MA neutral khi vẫn Init: phân P/N theo nến M1 vừa đóng. Add mở rộng round theo DCAPos hoặc DCANeg (xem mục 3). Vòng có thể kết thúc khi Global TP, Tia cluster / partial, hoặc TP từng lệnh (nếu bật).

Each round starts with one Init pair (same R{n}): Buy and Sell tagged P or N in the comment — uptrend: Buy=P (DCAPos lot), Sell=N (DCANeg lot); downtrend: Sell=P, Buy=N. If MA is neutral but Init is still allowed, P/N follows the last closed M1 candle. Add extends the round as DCAPos or DCANeg (see §3). Rounds may end on Global TP, Tia cluster/partial, or per-order TP (if enabled).

Sơ đồ: Chu kỳ vòng lệnh của GoldenRobber

Diagram: GoldenRobber trade round lifecycle

Logic mở InitInit trigger logic

3. DCA Positive vs DCA Negative

Init luôn có hai chân trong một R: một lệnh gắn P (theo trend tại thời điểm Init, lot/TP DCAPos) và một lệnh N (ngược trend, lot/TP DCANeg). Add thêm lệnh theo loại round suy ra từ comment (DCAPos hoặc DCANeg) và quy tắc MinPips/SR bên dưới.

Init always has two legs in one R: one order tagged P (with trend at Init time, DCAPos lot/TP) and one N (counter-trend, DCANeg lot/TP). Add extends the round per inferred type (DCAPos or DCANeg) using the rules below.

DCAPos thêm lệnh cùng chiều giá | DCANeg thêm lệnh ngược chiều — chờ hồi giá

DCAPos adds with price direction | DCANeg adds against price — waits for reversal

4. Order Execution

5. Lot Balance

Lot Balance giúp duy trì sự cân bằng giữa tổng lot Buy và Sell, giảm nguy cơ bị kẹt lệnh khi giá di chuyển một chiều mạnh. Thay vì mở lệnh "Balance" riêng, EA thiên lệch (bias) các lệnh Add DCA về phía yếu hơn.

Lot Balance keeps total Buy and Sell lots approximately equal, reducing stuck-order risk when price moves strongly in one direction. Instead of opening separate "Balance" orders, the EA biases DCA Add orders towards the weaker side.

Khi |Buy−Sell| vượt Trigger → EA chỉ Add về phía yếu hơn cho đến khi đạt Target

When |Buy−Sell| exceeds Trigger → EA only Adds to weaker side until Target is reached

5b. Flash Crash Protection

Phát hiện biến động giá cực mạnh (flash crash) và đóng băng EA để bảo toàn cấu trúc lệnh. Khi trigger: freeze Tia (ngăn đóng cluster non), freeze Init/Add, chạy Fast Balance để cân bằng lot nhanh.

Detects extreme price movements (flash crash) and freezes the EA to preserve order structure. When triggered: freeze Tia (prevent premature cluster closes), freeze Init/Add, run Fast Balance to quickly equalize lots.

5c. Exposure Scale (MaxTotalLot)

Giới hạn tổng lot (Buy+Sell) bằng cách giảm dần lot mới khi gần ngưỡng — không bao giờ block hoàn toàn, tránh deadlock. Áp dụng cho Init, DCA Add, và Hedge.

Limits total lots (Buy+Sell) by gradually reducing new lot sizes as exposure approaches the cap — never fully blocks, avoiding deadlock. Applies to Init, DCA Add, and Hedge.

5d. Single Round Mode

Chế độ chạy 1 round tại 1 thời điểm — chỉ Init round mới sau khi round trước đã đóng hết tất cả lệnh. Giới hạn số adds per round để kiểm soát exposure.

One round at a time mode — only Init a new round after all positions from the previous round are fully closed. Limits adds per round to control exposure.

6. Support / Resistance

EA tự động phát hiện vùng S/R từ swing high/low và ưu tiên đặt lệnh tại các vùng này thay vì chỉ dựa vào khoảng cách MinPips. Vùng được chấm điểm dựa trên số lần touch, impulse sau swing và confluence với timeframe cao hơn.

The EA auto-detects S/R zones from swing highs/lows and prioritizes entries at these zones instead of relying solely on MinPips distance. Zones are scored by touch count, post-swing impulse, and higher timeframe confluence.

Cơ chế 3 lớp3-Layer mechanism

7. Trend Filter

Sử dụng EMA trên timeframe cao hơn để chặn Init khi trend không rõ. Vùng neutral (giá trong band quanh MA): không Init. Khi trend rõ (UP/DOWN), Init vẫn mở cả hai phía với nhãn P/N đúng chân (không còn “chỉ Buy” hay “chỉ Sell” Init). Add vẫn có thể dùng filter để hạn chế lệnh ngược trend (InpTrendFilterApplyAdd). Init tự nhiên + InpInitNaturalBypassTrend bỏ qua chặn neutral cho nhánh flat/noref/fallback.

Uses a higher timeframe EMA to block Init when trend is unclear. Neutral zone (price inside band around MA): no Init. When trend is clear (UP/DOWN), Init still opens both sides with correct P/N legs (no longer “Buy-only” or “Sell-only” Init). Add can still use the filter to limit counter-trend orders (InpTrendFilterApplyAdd). Natural init + InpInitNaturalBypassTrend bypasses the neutral block for flat/noref/fallback.

🎯 Tune Trend Filter — 2 input numeric quan trọng 🎯 Tune Trend Filter — 2 key numeric inputs

Section này focus vào 2 input bạn cần gõ số: InpTrendFilterMAPeriod (chu kỳ EMA) và InpTrendFilterNeutralPips (deadzone). Combo MA + Neutral quyết định Trend Filter responsive hay strict.

This section focuses on the 2 inputs you actually type numbers into: InpTrendFilterMAPeriod (EMA period) and InpTrendFilterNeutralPips (deadzone). The MA + Neutral combo determines whether Trend Filter is responsive or strict.

   ↑
   │  price > EMA + NeutralPips  →  trend = UP ✅
+N ─┼─────── ─────── ─────── ─── (EMA + NeutralPips)
   │  ┌─────────────────────┐
   │  │   NEUTRAL DEADZONE   │  ← price in band → trend = 0 (Init blocked)
   │  │   (trend not clear)  │
0  ─┼── ──── EMA line ──── ── (EMA, period = MAPeriod)
   │  │                      │
   │  └─────────────────────┘
-N ─┼─────── ─────── ─────── ─── (EMA - NeutralPips)
   │  price < EMA - NeutralPips  →  trend = DOWN ✅
   ↓

📊 Bảng khuyến nghị: MAPeriod + NeutralPips theo TF (XAU) 📊 Recommended values: MAPeriod + NeutralPips by TF (XAU)

Cho mỗi TF, chọn 1 trong 3 style. Số trong cell = giá trị bạn gõ trực tiếp vào EA Inputs. Cột Balanced ⭐ là default khuyến nghị.

For each TF, pick 1 of 3 styles. Numbers in cells = values you type directly into EA Inputs. Balanced ⭐ column is the recommended default.

📌 Configs đã backtest dùng số nào? 📌 What did backtested configs use?

🎚️ Hiểu hành vi của 2 input 🎚️ Understanding behavior of the 2 inputs

8. Sideway Filter (Bollinger)

Phát hiện thị trường đi ngang bằng Bollinger Bandwidth: (Upper−Lower)/Middle < ngưỡng = sideway. Có thể chọn chặn Init và/hoặc chặn Add khi sideway. Cache refresh mỗi bar M1 và trước khi cập nhật panel.

Detects ranging market via Bollinger Bandwidth: (Upper−Lower)/Middle < threshold = sideways. You can block Init and/or block Add when sideways. Cache refreshes on each M1 bar and before panel update.

8b. Pivot Point Filter (v1.19+, Auto-method v1.21+)

EA tính các mức Pivot Point (PP) + 3 cấp Support/Resistance (S1–S3 / R1–R3) từ H/L/C của bar đã đóng trên InpPivotTF (D1 / W1 / MN1). Logic gate: Buy chỉ được phép khi ask gần một level Support (PP/S1/S2/S3); Sell chỉ được khi bid gần một level Resistance (PP/R1/R2/R3). Khoảng "gần" cấu hình qua InpPivotProximityPips.

The EA computes Pivot Point (PP) + three S/R levels (S1–S3 / R1–R3) from the H/L/C of the previous closed bar on InpPivotTF (D1 / W1 / MN1). Gate logic: Buy allowed only when ask is near a Support level (PP/S1/S2/S3); Sell allowed only when bid is near a Resistance level (PP/R1/R2/R3). The "near" threshold is configured via InpPivotProximityPips.

4 phương pháp tính + Auto4 calculation methods + Auto

1. range_ratio < LowVolRatio (0.7)?           → Camarilla  [sideway, scalp tight zones]
2. body_ratio > BodyThresh (0.65)
   AND close_position ≥0.7 hoặc ≤0.3 ?       → Woodie     [strong momentum, close-weighted PP]
3. range_ratio > HighVolRatio (1.4)?         → Classic    [breakout day, wide levels]
4. default (medium range, no clear bias)     → Fibonacci  [conservative entry near PP]

Tham sốParameters

Auto-method tuning (chỉ dùng khi InpPivotMethod=4)Auto-method tuning (only when InpPivotMethod=4)

Init reason tag mớiNew Init reason tag

Khi Pivot là trigger cho phép Init (không gần S/R nhưng gần pivot level), comment lệnh sẽ chứa tag |init_pivot thay vì |init_sr. Dùng để phân biệt nguồn entry khi review history. Khi gần cả S/R và Pivot, ưu tiên tag |init_sr (giữ tương thích với log cũ).

When Pivot is the trigger that allows Init (price not near S/R but near a pivot level), the order comment carries |init_pivot instead of |init_sr. Useful for filtering entry sources during history review. When near both S/R and Pivot, the |init_sr tag wins (backward compatible with existing logs).

Hiển thị panelInfo Panel display

Khi InpPivotFilterEnable=true, panel hiện thêm dòng:

When InpPivotFilterEnable=true, the panel shows an extra line:

Manual:  Pivot[Cls/COOP]: SUPP | PP=2345.67
Auto:    Pivot[auto→Cam/INDEP]: RES | PP=2345.67

• [method/mode] — manual: Cls/Fib/Cam/Wood. Auto (v1.21+): prefix auto→ cho biết EA đang chọn method gì. Mode: COOP hoặc INDEP.
• [method/mode] — manual: Cls/Fib/Cam/Wood. Auto (v1.21+): auto→ prefix shows EA-resolved method. Mode: COOP or INDEP.
• SUPP / RES / BOTH / - — giá hiện tại đang gần Support / Resistance / cả 2 / không cái nào.
• SUPP / RES / BOTH / - — current price is near Support / Resistance / both / neither.
• PP=... — giá trị Pivot Point hiện tại (để cross-check với chart).
• PP=... — current Pivot Point value (cross-check with chart).

Màu xanh lá = đang gần ít nhất 1 level (có thể trade); xám = giá xa tất cả (filter chặn).

Lime = near at least one level (trades allowed); silver = price far from all (filter blocks).

Use cases khuyến nghịRecommended use cases

🤖 Khi nào dùng Auto-method (v1.21+)When to use Auto-method (v1.21+)

8c. Wick Rejection Filter (v1.24+)

Phân tích râu nến (wick/shadow) trên 2 TF cùng lúc để loại bỏ Init/Add ở vùng giá vừa bị từ chối. Logic Mode A directional: râu trên dài → sellers reject high → block BUY; râu dưới dài → buyers reject low → block SELL. Multi-TF AND: CẢ TF1 (default M15) và TF2 (default H1) phải đồng thuận có rejection → giảm false signals.

Analyzes candle wicks/shadows on 2 TFs simultaneously to skip Init/Add in price-rejection zones. Mode A directional: long upper wick → sellers reject high → block BUY; long lower wick → buyers reject low → block SELL. Multi-TF AND: BOTH TF1 (default M15) AND TF2 (default H1) must agree on rejection → reduced false signals.

        H ─┬─    H ─┬─        H ─┬─    H ─┬─
           │       │              │   ┌──┘
           │   ┌──┘               │   │
        ┌──┘   │                  │   └──┐
        │     │                   │      │
        └──┐  │                   └──┐   │
           │  └──┐                   │   │
           │     │                   │   │
        L ─┴─    L ─┴─               L ─┴─
        NORMAL   UPPER WICK         LOWER WICK
        candle    REJECT BUY ❌      REJECT SELL ❌
                  (sellers strong)   (buyers strong)

Khi RÂU TRÊN dài trên cả TF1 + TF2 → sellers thắng tại high → không Buy (vẫn cho Sell nếu thoả filter khác).

When UPPER WICK long on both TF1 + TF2 → sellers won at high → no Buy (Sell still allowed if other filters pass).

Công thức rejectionRejection formula

Tham sốParameters

Tham số tuning theo styleTuning by style

Ví dụ thực tế (XAU M15, InpPipPoints=10)Real example (XAU M15, InpPipPoints=10)

Multi-TF AND logicMulti-TF AND logic

TF1 (M15):  ✅ upper wick reject  ─┐
                                   ├── BOTH agree → BLOCK Buy
TF2 (H1):   ✅ upper wick reject  ─┘

TF1 (M15):  ✅ upper wick reject  ─┐
                                   ├── only TF1 → OK to Buy (need both)
TF2 (H1):   ❌ no rejection       ─┘

TF1 (M15):  ❌ no rejection       ─┐
                                   ├── neither → OK to Buy
TF2 (H1):   ✅ upper wick reject  ─┘

Hiển thị panelInfo Panel display

Khi InpWickFilterEnable=true, panel hiện thêm dòng:

When InpWickFilterEnable=true, the panel shows an extra line:

Clean:        Wick[PERIOD_M15+PERIOD_H1]: clean ✓        (lime — both sides OK)
Buy blocked:  Wick[PERIOD_M15+PERIOD_H1]: UP (block Buy)  (orange — upper wick reject)
Sell blocked: Wick[PERIOD_M15+PERIOD_H1]: DN (block Sell) (orange — lower wick reject)
Both blocked: Wick[PERIOD_M15+PERIOD_H1]: BOTH ❌         (red — round skipped)

Use cases khuyến nghịRecommended use cases

InpWickFilterEnable  = true
InpWickFilterTF1     = M15          # Match Trend Filter TF
InpWickFilterTF2     = H1           # Confirmation TF
InpWickLookbackBars  = 2            # Bar vừa đóng + bar trước
InpWickToBodyRatio   = 2.0          # Balanced default
InpWickToRangeMin    = 0.5
InpWickApplyInit     = true         # ✅ Gate Init quality
InpWickApplyAdd      = false        # ❌ Giữ DCA recovery free

9. DCA Parameters

9b. DCA Chain Persistent Mode (v1.35+)

Cách EA tính exponent multiplier khi mở lệnh Add. Quyết định lot = StartLot × Multiplier^exponent. Có 2 chế độ qua input InpDcaChainPersistent (default false = legacy):

How the EA calculates the multiplier exponent on Add orders. Determines lot = StartLot × Multiplier^exponent. Two modes via InpDcaChainPersistent (default false = legacy):

So sánh 2 modeTwo modes compared

Walkthrough scenario chi tiếtDetailed scenario walkthrough

Setup: InpDCAPosStartLot=0.10, InpDCAPosMultiplier=1.5. Round R đang chạy.

Setup: InpDCAPosStartLot=0.10, InpDCAPosMultiplier=1.5. Round R running.

ImplementationImplementation

// Struct lưu chain counter per round (persistent across partial closes)
struct RoundChainEntry {
   int roundId;
   int maxBuyNum;     // highest B#N ever assigned in round
   int maxSellNum;    // highest S#N ever assigned in round
};
RoundChainEntry g_roundChain[];

// Khi add fire:
int nextBuyNum = (InpDcaChainPersistent
                  ? MathMax(maxBuyNum, RoundChainGetMaxBuy(roundId)) + 1
                  : maxBuyNum + 1);
int lotExp = (InpDcaChainPersistent ? nextBuyNum : nBuy);
double rawLot = MathMin(StartLot * MathPow(Multiplier, lotExp), MaxLot);

// Sau khi add thành công:
if (InpDcaChainPersistent) RoundChainSetMaxBuy(roundId, nextBuyNum);

// Cleanup mỗi 30s (hook với TicketMapCleanup):
// Xóa entries của rounds không còn position nào (round dies)
RoundChainCleanup();

Khuyến nghị sử dụngUsage recommendations

📄 Tài liệu đầy đủ với 9 sections: CHAIN_PERSISTENT.md📄 Full documentation in 9 sections: CHAIN_PERSISTENT.md

9c. Whipsaw Defense Suite (v1.36-1.37+)

5 features adaptive để bảo vệ EA khỏi whipsaw chop markets (đặc biệt scenarios như 5-11/02/2025 gây stuck Pass 10 floating loss -$55k). Triết lý: preserve Pass 10 profit trong trending markets, block entries trong choppy markets.

5 adaptive features protecting EA against whipsaw chop markets (like the 5-11/02/2025 scenario which caused Pass 10 to accumulate -$55k floating loss). Philosophy: preserve Pass 10 profit in trending markets, block entries in choppy markets.

1. Choppy Filter (ADX-based)Choppy Filter (ADX-based)

Phát hiện chop bằng ADX (Average Directional Index). ADX đo trend STRENGTH (không quan tâm direction). ADX cao = trending, ADX thấp = range/chop.

Detects chop using ADX (Average Directional Index). ADX measures trend STRENGTH (regardless of direction). High ADX = trending, low ADX = range/chop.

2. Anti-Whipsaw CooldownAnti-Whipsaw Cooldown

Reactive feedback: nếu realized loss trong sliding window vượt ngưỡng → cooldown N giờ (block Init mới). Cho EA thời gian "thở" sau bad trades.

Reactive feedback: if realized loss in sliding window exceeds threshold → cooldown N hours (block new Init). Gives EA time to "breathe" after bad trades.

3. Adaptive Trend NeutralPips (regime-aware)Adaptive Trend NeutralPips (regime-aware)

Key innovation v1.37: TrendFilter NeutralPips tự động scale theo ADX. Strong trend → sensitive (giữ Pass 10 character). Chop → strict (block noise). Best balance giữa profit và defense.

Key innovation v1.37: TrendFilter NeutralPips automatically scales by ADX. Strong trend → sensitive (preserves Pass 10 character). Chop → strict (blocks noise). Best balance between profit and defense.

4. Multi-TF Trend Confirmation (default OFF)Multi-TF Trend Confirmation (default OFF)

Require HTF (vd H1) trend phải agree với primary TF trước khi vào lệnh. Strict defense layer. Default OFF vì có thể giảm profit 10-25%. v1.41: tách InpMultiTfTrendApplyInit / InpMultiTfTrendApplyAdd — áp HTF confirm cho Init và/hoặc Add riêng biệt (giống Trend Filter).

Require HTF (e.g. H1) trend agreement with primary TF before entering. Strict defense layer. Default OFF as it may reduce profit 10-25%. v1.41: split into InpMultiTfTrendApplyInit / InpMultiTfTrendApplyAdd — apply HTF confirm to Init and/or Add independently (like Trend Filter).

4b. Stair-Step Market Filter (v1.42, default OFF) — dynamic trend-TF overrideStair-Step Market Filter (v1.42, default OFF) — dynamic trend-TF override

Chuyển đổi động primary trend TF theo số lệnh mở: book khỏe → TF nhanh (vd M3, aggressive, profit cao); book phình (dấu hiệu kẹt trong staircase-trend) → override sang TF chậm (vd H4, defensive, survival). Mục tiêu: gộp profit của M3 (regime êm) + survival của H4 (trend bậc thang) trong một config.

Dynamically switches the primary trend TF by open-order count: healthy book → fast TF (e.g. M3, aggressive, high profit); bloated book (sign of being trapped in a staircase trend) → override to a slow TF (e.g. H4, defensive, survival). Goal: combine M3's profit (calm regime) with H4's survival (staircase trend) in one config.

v1.43 — full override: stair-step giờ override trọn bộ thông số direction của trend filter khi active: {TF, MAPeriod, NeutralPips, ApplyInit, ApplyAdd}. Tức nó là một "trend-filter thay thế" hoàn chỉnh, không chỉ đổi TF. Neutral riêng (static) giúp giữ cam kết trend, không lật ở pullback như adaptive neutral=5 của primary.

v1.43 — full override: stair-step now overrides the complete direction param set of the trend filter while active: {TF, MAPeriod, NeutralPips, ApplyInit, ApplyAdd} — a full drop-in replacement, not just a TF swap. Its own static neutral keeps the trend commitment instead of the primary's adaptive neutral=5.

Cơ chế: state cập nhật 1 lần/tick trong RefreshTickCache (đếm order). Khi active, GetTrendDirection() đọc EMA của InpStairStepTF thay vì primary → áp cho cả Init lẫn Add. Lưu ý reactive: tới lúc chạm Trigger thì rổ ngược trend đã dựng — override chỉ chặn dựng thêm, nên chọn Trigger đủ thấp để cap sớm; đây là biến cần optimize (thử 16/24/32).

Mechanism: state updates once/tick in RefreshTickCache (order count). When active, GetTrendDirection() reads the InpStairStepTF EMA instead of the primary → applies to both Init and Add. Note (reactive): by the time Trigger is hit the counter-trend basket is already built — the override only stops further growth, so pick a low enough Trigger to cap early; this is the key parameter to optimize (try 16/24/32).

Info panel (v1.44): dòng Stair: báo trạng thái — ẩn khi OFF; Stair: primary PERIOD_M3 (count/trigger) (bạc) khi chưa trigger; Stair: OVERRIDE PERIOD_H4 (count, rel<N) (cam) khi đang override.

Info panel (v1.44): a Stair: row shows state — hidden when OFF; Stair: primary PERIOD_M3 (count/trigger) (silver) when not yet triggered; Stair: OVERRIDE PERIOD_H4 (count, rel<N) (orange) while override is active. v1.45 adds [stable]/[flip].

Mỗi tick (RefreshTickCache):
  h4dir  = dir(price vs stair-EMA, InpStairStepNeutralPips)
  if h4dir đổi dấu:  lastFlipTime = now
  h4Stable = (now − lastFlipTime) ≥ StableBars × PeriodSeconds(StairStepTF)

  OFF (primary/M3):
     → BẬT override  nếu  count ≥ Trigger  AND  h4Stable      (staircase xác nhận)
  ON (override/H4):
     → TẮT về primary nếu  count < Release  OR  NOT h4Stable   (book vơi HOẶC whipsaw)

GetTrendDirection(): override ON → stair-EMA ; else → primary EMA

Vì sao vá được 2025: whipsaw làm stair-TF lật → h4Stable=false → EA không khoá trong H4 nữa, bail về M3 → M3 clear book nhanh (như config MEDIUM sống 2025). Staircase 2023: stair-TF ổn định nhiều tuần → override giữ nguyên → chặn counter-trend → sống. Cũng vá luôn cú đảo ở đỉnh staircase (H4 lật → bail về M3 xử lý reversal).

Why it fixes 2025: a whipsaw flips the stair-TF → h4Stable=false → the EA no longer locks into H4, bailing to M3 → M3 clears the book fast (like the MEDIUM config that survived 2025). In the 2023 staircase the stair-TF is stable for weeks → override holds → blocks counter-trend → survives. It also handles the staircase-top reversal (stair-TF flips → bail to M3 to manage the turn).

detector = ER ≥ InpStairStepERMin  AND  ADX ≥ InpStairStepDetAdxMin  AND  dir(stair-EMA) ≠ 0
  ER (Kaufman Efficiency Ratio) = |close[0]−close[N]| / Σ|close[i]−close[i-1]|   trên InpStairStepTF
     ER→1 = đi thẳng (staircase/trend sạch) ; ER→0 = chop

OFF (primary/M3):
   → BẬT override  nếu  detector≠0  AND  tổng_lot_rổ ≤ InpStairStepMaxBasketLots   (SỚM + rổ nhỏ)
ON (override/H4):
   → TẮT về primary nếu  detector=0                                               (staircase kết thúc)

InpTrendFilterEnable      = true          ; bắt buộc
InpTrendFilterTF          = PERIOD_M3      ; primary = M3 (profit ở regime êm)
InpTrendFilterMAPeriod    = 10
InpTrendFilterApplyInit   = true
InpTrendFilterApplyAdd    = false          ; M3 mode: để DCA recovery tự do (clear nhanh)

InpStairStepEnable        = true           ; bắt buộc
InpStairStepUseDetector   = true           ; ← BẬT detector (v1.47)
InpStairStepTF            = PERIOD_H4       ; override → H4 khi staircase
InpStairStepMAPeriod      = 30
InpStairStepNeutralPips   = 50
InpStairStepApplyInit     = true
InpStairStepApplyAdd      = true           ; override mode: H4 gác add (= H4-origin, 1 cổng, chống staircase)
InpStairStepERPeriod      = 20
InpStairStepERMin         = 0.55           ; tune 0.50–0.65
InpStairStepDetAdxPeriod  = 14
InpStairStepDetAdxMin     = 25.0           ; tune 22–28
InpStairStepMaxBasketLots = 3.0            ; tune theo lot ladder (start 0.1 → ~3 lot là "còn nhỏ")
InpStairStepStableBars    = 0              ; không dùng ở detector mode

5. Dual-Direction Prohibition during chop (default OFF)Dual-Direction Prohibition during chop (default OFF)

Khi chop detected + đã có positions side X → block Init side đối diện. Prevent bidirectional stuck. Default OFF vì kill hedge opportunity (DCA Hedging strategy core feature).

When chop detected + already have positions on side X → block Init opposite side. Prevents bidirectional stuck. Default OFF since it kills hedge opportunity (core DCA Hedging feature).

InpDualDirChopEnable = false (default)

6. Info Panel display — Whipsaw Defense statusInfo Panel display — Whipsaw Defense status

v1.37 thêm dòng "Whip: ..." trong info panel hiển thị real-time status của tất cả 5 features.

v1.37 adds "Whip: ..." row in info panel showing real-time status of all 5 features.

Whip: ADX=28.5(strong) NP=5 HTF↑✓
       │     │     │      │   │  └─ Agreement: ✓ (HTF agree với primary) hoặc ✗ (disagree)
       │     │     │      │   └──── HTF direction: ↑/↓/=  (Multi-TF feature)
       │     │     │      └──────── Effective NeutralPips (Adaptive feature)
       │     │     └─────────────── ADX regime: strong/mid/chop
       │     └───────────────────── Current ADX value
       └─────────────────────────── Combined status row label

Examples với active blocks:
  Whip: ADX=17.3(chop) NP=50 HTF=✗ [BLK: CHOP HTF-MISS ]     ← red — full block
  Whip: ADX=22.1(mid) NP=20 HTF↑✓ [BLK: AW 142m ]           ← red — cooldown
  Whip: ADX=24.8(mid) NP=20 HTF↑✗ [BLK: HTF-MISS ]          ← orange — partial

7. Recommended configsRecommended configs

InpChoppyFilterEnable    = true
InpChoppyFilterTF        = PERIOD_H1
InpChoppyAdxMinForTrend  = 22.0

InpAntiWhipsawEnable     = true
InpAntiWhipsawLookbackH  = 12
InpAntiWhipsawMaxLossUSD = 250
InpAntiWhipsawCooldownH  = 6

InpTrendAdaptive          = true
InpTrendAdaptiveADXStrong = 28.0
InpTrendAdaptiveADXWeak   = 18.0
InpTrendNeutralStrong     = 5
InpTrendNeutralMid        = 20
InpTrendNeutralWeak       = 50

InpMultiTfTrendEnable     = true
InpMultiTfTrendHigherTF   = PERIOD_H1

InpDualDirChopEnable      = true

InpChoppyFilterEnable     = true  (default)
InpChoppyFilterTF         = PERIOD_M15 (or H1)
InpChoppyAdxMinForTrend   = 22.0

InpAntiWhipsawEnable      = true  (default)
InpAntiWhipsawLookbackH   = 8     (default)
InpAntiWhipsawMaxLossUSD  = 200   (default)

InpTrendAdaptive          = true  (default)
InpTrendAdaptiveADXStrong = 30.0  (default)
InpTrendAdaptiveADXWeak   = 20.0  (default)

InpMultiTfTrendEnable     = false (default)
InpDualDirChopEnable      = false (default)

10. Hedging

Khi số lệnh cùng chiều đạt InpHedgeAfterTrades, EA mở lệnh ngược chiều (Hedge). Lot và cách kích hoạt phụ thuộc InpHedgeMode (v1.23+: dropdown 4 chế độ): ByMainRound (% volume round lớn nhất, 1 hedge/phía), ByTotal (% tổng lot, 1 hedge/phía), ByAccountProfit (lot theo lỗ USD), PerRound (1 hedge cho mỗi round đạt N, lot = % volume round đó). Mục đích: giảm đà loss khi giá đi ngược.

When same-direction orders reach InpHedgeAfterTrades, the EA opens a counter-direction order (Hedge). Lot and trigger depend on InpHedgeMode (v1.23+: dropdown with 4 modes): ByMainRound (% of largest round's volume, 1 hedge per side), ByTotal (% of total lot, 1 hedge per side), ByAccountProfit (lot by USD loss), PerRound (one hedge per round that reached N, lot = % of that round's volume). Purpose: cushion further losses if price moves against the position.

11. Tia (Cluster Scalping)

Tia là cơ chế tỉa lệnh theo cluster: khi tìm thấy một nhóm lệnh Buy + Sell hỗn hợp có tổng profit ≥ InpTiaProfitUSD, EA đóng toàn bộ cluster đó. Đây là cơ chế chốt lời chính của GoldenRobber — kết hợp partial close và fallback thông minh giúp xử lý lệnh kẹt ngay cả trong các điều kiện thị trường phức tạp.

Tia is a cluster scalping mechanism: when a group of mixed Buy+Sell orders has combined profit ≥ InpTiaProfitUSD, the EA closes the entire cluster. This is GoldenRobber's primary profit-harvesting mechanism — combining partial close and smart fallback to handle stuck orders even in complex market conditions.

11.1. Tia + DCA TP — cách hoạt động / How it works

Tia (đóng cụm theo profit) và TP từng lệnh trên sàn vẫn hoạt động độc lập: broker có thể khớp TP bất cứ lúc nào. Synergy không thay thế Tia; nó chỉ điều chỉnh ngưỡng $ và thứ tự / ưu tiên khi EA đang tính toán đóng theo logic Tia trong cùng một tick.

Tia (cluster profit closes) and per-order broker TPs still run independently: the server can fill a TP at any time. Synergy does not replace Tia; it only adjusts the USD threshold and ordering / tie-breaks while the EA evaluates Tia-style closes on a given tick.

Phân biệt InpTiaMaxPositions vs InpTiaClusterMaxInpTiaMaxPositions vs InpTiaClusterMax — common confusion

2 input nghe giống nhau nhưng làm việc ở 2 layer hoàn toàn khác trong mask pipeline:

Two inputs sound similar but operate at completely different layers in the mask pipeline:

Ví dụ với 100 positions mởExample with 100 open positions

• InpTiaMaxPositions = 14 → mask chỉ xét 14 positions oldest, bỏ qua 86 còn lạiInpTiaMaxPositions = 14 → mask only sees 14 oldest positions, ignores remaining 86
• InpTiaClusterMax = 5 → trong 14 positions đó, cluster mỗi tổ hợp tối đa 5 lệnhInpTiaClusterMax = 5 → among those 14, each cluster subset can have at most 5 positions
• InpTiaClusterMax = 0 → cluster size không giới hạn (max = 14 = sample size)InpTiaClusterMax = 0 → cluster size unbounded (max = 14 = sample size)

Pipeline minh hoạPipeline visualization

100 positions mở
       │
       ▼
[1] InpTiaMaxPositions cap (sample 14 oldest, drop 86)
       │
       ▼
14 positions cho mask iteration
       │
       ▼
2^14 = 16,384 subset tổ hợp
       │
       ▼
[2] InpTiaClusterMin / InpTiaClusterMax filter (size ∈ [Min, Max])
       │
       ▼
[3] BotDCA filter (≥3 Buy & ≥3 Sell)
       │
       ▼
[4] Profit filter (sum ≥ effectiveTarget)
       │
       ▼
[5] Side-balance guard
       │
       ▼
Best cluster → close

11.2 Ladder integrity — Anchor / Ladder-roll / Release valve

Bộ 3 input từ v1.07–v1.10 giải quyết một class lỗi sâu của cluster scalping: khi giá chạy 1 hướng dài, các hedge cũ ở chiều ngược dồn lại xa giá hiện tại. Cluster cũ chỉ chốt theo "P_sum ≥ target" sẽ có xu hướng đóng lệnh lỗ gần giá (lỗ nhỏ, fit budget) và để lệnh lỗ xa giá (lỗ lớn) cô lập → ladder bị gãy thành nhiều mảnh, mỗi rung lẻ là một anchor cô lập kéo equity. Các flag dưới đây bắt cluster "quấn chiếu" từ rung ngoài cùng vào, đồng thời cho release valve khi rung ngoài quá xa.

A trio of inputs from v1.07–v1.10 fixes a subtle failure mode in cluster scalping: when price runs one direction for a long stretch, old hedges on the opposite side drift far from the current price. The original "close when P_sum ≥ target" logic naturally picks the near losses (small, fit budget) and leaves far losses isolated → the ladder breaks into multiple stranded rungs, each acting as an equity-dragging mini-anchor. The flags below force cluster closes to "roll the mat" from the outermost rung inward, with a release valve when the outer rung is unreachable.

Ba thuật ngữ / Three concepts

Ví dụ trực quanWorked example

Giả sử ladder Sell (đối diện Buy đang lời), giá hiện tại 86, sắp xếp theo distance descending:

Suppose a Sell ladder (opposite to Buy profit-side), current price 86, sorted by distance descending:

Rank 0 (anchor)  Sell@100  → 14.00 distance (1400 pip @ InpPipPoints=1)
Rank 1           Sell@96   →  10.00 distance
Rank 2           Sell@94   →   8.00 distance
Rank 3           Sell@90   →   4.00 distance
Rank 4           Sell@88   →   2.00 distance

Deadlock & Release valveDeadlock & release valve

InpTiaAnchorMaxDistPips là release valve: positions xa hơn N pips bị loại khỏi anchor/ladder. Anchor mới sẽ là position xa nhất CÒN trong ngưỡng → cluster có thể đóng các rung trong ngưỡng mà không bị positions ngoài ngưỡng gate. Các positions ngoài ngưỡng trở thành "free agents" — cluster có thể chọn gom chúng (nếu budget cho phép) hoặc để dành Global SL Clear Stuck dọn.

InpTiaAnchorMaxDistPips is the release valve: positions farther than N pips are excluded from anchor/ladder. The new anchor becomes the farthest position WITHIN range → cluster can close in-range rungs without out-of-range positions gating it. Out-of-range positions become "free agents" — cluster may opt to bundle them (if budget allows) or defer them to Global SL Clear Stuck.

Đơn vị pip — chú ý quan trọngPip unit — critical caveat

Khuyến nghị giá trịRecommended values

12. Global TP / SL

Đóng toàn bộ lệnh khi tổng profit nổi đạt ngưỡng. Đây là lưới an toàn cuối cùng.

Closes all positions when total floating profit hits a threshold. This is the final safety net.

13. Clear Stuck Orders

Cơ chế cắt lệnh kẹt khi lỗ nổi vượt một khoảng cách pips nhất định. Khác với Global SL — chỉ nhắm vào lệnh xa giá, không đóng hết.

Mechanism to cut stuck orders when floating loss exceeds a pip distance threshold. Unlike Global SL — targets only orders far from price, not a full close.

14. Daily Profit LimitDaily Profit Limit

Khi bật: đạt target lời trong ngày (balance − balance đầu ngày) hoặc target lỗ (tổng profit nổi âm) thì EA đóng hết lệnh và không mở lệnh mới đến hết ngày. Sang ngày mới tự reset.

When enabled: when daily profit target (balance − start-of-day balance) or daily loss target (floating P/L) is reached, the EA closes all positions and stops opening new orders for the rest of the day. Resets at the start of the next day.

15. Risk Management

16. Thời gian giao dịch & Bảo vệ cuối tuầnTrading Time & Weekend Protection

Symbol & MagicSymbol & Magic

📐 Bảng quy đổi USD ↔ Pip (XAU 2-digit broker, _Point=0.01) 📐 USD ↔ Pip conversion tables (XAU 2-digit broker, _Point=0.01)

Công thức: pipSize = _Point × InpPipPoints. Mọi input có chứa Pips trong tên (vd InpDCAPosMinPips, InpPivotProximityPips) đều được nhân với pipSize này để ra giá trị USD price thực tế.

Formula: pipSize = _Point × InpPipPoints. Every input with Pips in its name (e.g. InpDCAPosMinPips, InpPivotProximityPips) is multiplied by this pipSize to get actual USD price distance.

🧮 Pip Calculator tương tác 🧮 Interactive Pip Calculator

Nhập lot size và InpPipPoints để tự động tính mỗi pip = bao nhiêu USD PnL. Dùng cho XAU 2-digit (_Point=0.01, contract size 100 oz).

Enter lot size and InpPipPoints to auto-calculate USD PnL per pip. For XAU 2-digit (_Point=0.01, contract size 100 oz).

17. Remote Config & Cloud Sync

Module này (input group === Remote Config & Cloud Sync ===) làm 2 việc trên cùng 1 kênh heartbeat: (1) Cloud Sync — đồng bộ Ticket Map để phục hồi khi MT5 sập; (2) Remote Config — nhận config chỉnh từ web (hot-reload) và đẩy telemetry panel lên console. EA dùng Ticket Mapping để track roundId/addNum/isDCAPos per ticket — cần thiết khi PositionClosePartial tạo position mới mất comment trên hedging account.

This module (input group === Remote Config & Cloud Sync ===) does two jobs over one heartbeat channel: (1) Cloud Sync — replicate the Ticket Map for crash recovery; (2) Remote Config — receive web-adjusted config (hot-reload) and push panel telemetry to the console. EA uses Ticket Mapping to track roundId/addNum/isDCAPos per ticket — required because PositionClosePartial creates a new position with lost comment on hedging accounts.

Kiến trúc 3 lớp3-Layer architecture

Tham số inputInput parameters

Remote Config & hot-reload (v1.41.2+)Remote Config & hot-reload (v1.41.2+)

Mỗi EA product được đăng ký ở web console /admin/easupported với 1 URL riêng (đặt vào InpCloudMyApiDomain) + 1 Secret token riêng (đặt vào InpCloudBearerToken). Qua heartbeat, EA tự khai báo danh sách config chỉnh được (config_schema) và đẩy toàn bộ Info Panel lên làm payload telemetry; server render UI động và trả về config đã chỉnh. EA đọc từ global mutable (không phải input) nên áp dụng ngay không cần gỡ EA. Server trả hot_keys (danh sách param đang override) làm nguồn chân lý → nút Clear revert param về default. 13 config hot-reload: manual_init, strong_bypass, strong_tf, strong_require_sr, lot_balance_enable/trigger/target, hedge_enable/after_trades/lot_percent, weekend_protect_enable/max_net_lot/balance_enable. Chi tiết standard + skeleton phát triển EA mới: xem EA-HOTRELOAD-STANDARD.md / .pdf.

Each EA product is registered in the web console /admin/easupported with its own URL (set as InpCloudMyApiDomain) + its own Secret token (set as InpCloudBearerToken). Over the heartbeat the EA self-declares its adjustable config list (config_schema) and pushes the whole Info Panel as payload telemetry; the server renders the UI dynamically and returns the adjusted config. The EA reads from mutable globals (not input), so changes apply live without re-attaching the EA. The server returns hot_keys (params currently overridden) as the source of truth → the Clear button reverts a param to its default. 13 hot-reloadable configs: manual_init, strong_bypass, strong_tf, strong_require_sr, lot_balance_enable/trigger/target, hedge_enable/after_trades/lot_percent, weekend_protect_enable/max_net_lot/balance_enable. Full standard + skeleton for building new EAs: see EA-HOTRELOAD-STANDARD.md / .pdf.

Save flowSave flow

Load priority (OnInit)Load priority (OnInit)

1. TicketMapLoad() — đọc file local (nhanh nhất)read local file (fastest)
2. Nếu file rỗng → If file empty → TicketMapLoadCloudflare()
3. Nếu CF cũng rỗng → If CF also empty → TicketMapLoadMyApi()
4. TicketMapRebuild() — fallback cuối: parse từ comment positions đang mởfinal fallback: parse from open position comments

https://gr-tmap.your-account.workers.dev
https://your-server.com

Disaster recovery scenariosDisaster recovery scenarios

• Scenario A: MT5 chính sập → mở MT5 ở máy khác cùng magic+account → OnInit load từ Cloudflare D1 → EA tiếp tục manage tickets như chưa từng sập.Main MT5 crashes → open MT5 on another machine with same magic+account → OnInit loads from Cloudflare D1 → EA continues managing tickets as if nothing happened.
• Scenario B: Cloudflare D1 sập → load fallback sang fxconsole MyApi → vẫn restore được.Cloudflare D1 down → load falls back to fxconsole MyApi → still restores.
• Scenario C: Cả 2 cloud sập → fallback TicketMapRebuild() từ comment positions đang mở. Mất data partial close trước đó nhưng EA vẫn track positions hiện tại.Both clouds down → fallback to TicketMapRebuild() from open position comments. Loses prior partial-close data but EA still tracks current positions.

Panel info — dòng "Cloud Sync"Panel info — "Cloud Sync" line

Khi InpCloudSyncEnable = true, panel hiển thị status HTTP của lần sync gần nhất:

When InpCloudSyncEnable = true, panel displays last sync HTTP status:

Cloud: CF=OK | MyApi=OK         (lime — cả 2 OK / both OK)
Cloud: CF=500 | MyApi=OK        (orange — CF lỗi 500 / CF 500 error)
Cloud: CF=OK | MyApi=-1         (orange — MyApi WebRequest fail)

Setup chi tiếtDetailed setup

Xem hướng dẫn từng bước (deploy CF Worker, migrate fxconsole, set Bearer token):

See step-by-step guide (deploy CF Worker, migrate fxconsole, set Bearer token):

• TMAP_DISASTER_RECOVERY_GUIDE.md — markdown chi tiết
• cloudflare-tmap-worker/README.md — CF Worker setup
• monitor/README.html — tổng quan kiến trúc 3 module

18. Multi-Node Leader Election

Khi chạy ≥ 2 node (cùng magic+account trên nhiều VPS/máy) để dự phòng, EA dùng cơ chế leader election theo priority + heartbeat để tránh mở lệnh trùng. Một node làm LEADER (full quyền giao dịch); các node còn lại làm FOLLOWER (chỉ đồng bộ dữ liệu, không gửi lệnh). Khi leader chết > InpCloudHeartbeatTimeoutSec, follower có priority thấp nhất tự động lên thay.

When running ≥ 2 nodes (same magic+account across multiple VPS/machines) for redundancy, the EA uses a priority + heartbeat leader-election mechanism to prevent duplicate trades. One node is the LEADER (full trading rights); the rest are FOLLOWERS (sync data only, send no orders). When the leader misses heartbeats for > InpCloudHeartbeatTimeoutSec, the surviving follower with the lowest priority takes over automatically.

Tham số inputInput parameters

Quy tắc bầu leaderElection rules

1. Mỗi node gửi POST /tmap/heartbeat mỗi InpCloudSyncIntervalSec giây (ghi đè last_heartbeat trên cloud).Each node sends POST /tmap/heartbeat every InpCloudSyncIntervalSec seconds (upserts last_heartbeat on cloud).
2. Server trả về danh sách alive nodes (heartbeat trong vòng timeout) đã sort theo priority ASC, rồi node_id ASC (tie-breaker).Server returns the list of alive nodes (heartbeat within timeout) sorted by priority ASC then node_id ASC (tie-breaker).
3. Phần tử đầu tiên = leader. Node tự nhận biết qua field is_leader trong response.First element = leader. Each node learns its role from the is_leader field in the response.
4. Khi leader chết → mất heartbeat > timeout → bị loại khỏi alive list → follower có priority nhỏ nhất kế tiếp tự động lên leader trong chu kỳ heartbeat tiếp theo.When leader dies → heartbeat lapses > timeout → removed from alive list → next-lowest-priority follower auto-promotes on the next heartbeat cycle.
5. Fail-safe: nếu cả heartbeat lẫn cloud đều fail (CF + MyApi đều chết) → node tự coi mình là leader để không treo giao dịch (CanTradeAsLeader() mặc định trả true khi không xác định được role).Fail-safe: if both heartbeat and cloud fail (CF + MyApi both down) → node assumes it is leader to avoid stalling trading (CanTradeAsLeader() defaults to true when role cannot be determined).

Quyền của Leader vs FollowerLeader vs Follower permissions

Kịch bản failoverFailover scenarios

Hiển thị panel — dòng "NodeRole"Panel display — "NodeRole" line

Khi InpCloudSyncEnable = true, panel hiển thị thêm dòng vai trò node:

When InpCloudSyncEnable = true, the panel shows an extra role line:

NodeRole: LEADER (P=1, alive=2)              (lime)
NodeRole: FOLLOWER (P=2, leader=<id> P=1, alive=2)   (orange)
NodeRole: LEADER (fallback, no cloud)        (yellow — heartbeat fail)

API endpointAPI endpoint

POST /tmap/heartbeat
Authorization: Bearer <TMAP_SECRET_KEY>
Content-Type: application/json

{
  "magic": "21478308",
  "account": "12345678",
  "node_id": "MT5-VPS01-abc123",
  "priority": 1,
  "timeout_sec": 90
}

→ 200 OK
{
  "ok": true,
  "is_leader": true,
  "current_leader_id": "MT5-VPS01-abc123",
  "current_leader_priority": 1,
  "alive_count": 2,
  "alive_nodes": [
    { "node_id": "MT5-VPS01-abc123", "priority": 1, "age_sec": 5 },
    { "node_id": "MT5-VPS02-xyz789", "priority": 2, "age_sec": 12 }
  ]
}

Endpoint giống nhau ở cả Cloudflare Worker và fxconsole REST API. EA gọi cả 2 song song; chỉ cần một trong hai trả về thành công là đủ để xác định role.

Endpoint is identical on both Cloudflare Worker and fxconsole REST API. The EA calls both in parallel; either returning successfully is enough to determine role.

19. Residue Position Management

Residue = position có lot rất nhỏ (vd. 0.01 lot) sót lại sau khi Tia / ClearStuck partial close. Residue gây 3 vấn đề: (1) phá cấu trúc Gap detection (1 Buy nhỏ ở vùng giá thấp làm lowestBuy sai → gap không hình thành); (2) làm sai refBuy/refSell trong round → DCA Add bị block; (3) tích luỹ nhiều residue qua thời gian = stuck positions không bao giờ close. Module này có 3 lớp xử lý: Prevent (ngăn ở source), Auto-clean (dọn residue tồn dư), Defensive filter (loại residue khỏi tính toán structural).

Residue = position with very small lot (e.g. 0.01) left over after Tia / ClearStuck partial close. Residue causes 3 issues: (1) breaks Gap detection structure (a small Buy at low price corrupts lowestBuy → gap never forms); (2) corrupts refBuy/refSell in round → DCA Add blocked; (3) residue accumulates over time = stuck positions that never close. This module has 3 layers: Prevent (avoid creating), Auto-clean (close existing), Defensive filter (exclude from structural calculations).

Tham số inputInput parameters

3 lớp xử lý — chi tiết3-layer mechanism — detailed

Lớp 1 — Prevent (ngăn ở source)Layer 1 — Prevent (at source)

Áp dụng tại 3 site partial close:

Applied at 3 partial close sites:

• Tia flexible partial close (lời tỉa lỗ) — CheckTiaClustersTia flexible partial close (profit trims loss) — CheckTiaClusters
• Tia mask partial close (BotDCA cluster mask)Tia mask partial close (BotDCA cluster mask)
• ClearStuck FarPartial (mode 4) — đóng partial lệnh xa giáClearStuck FarPartial (mode 4) — partial close far positions

Logic: trước khi PositionClosePartial, check remaining = curVol − volToClose. Nếu remaining < threshold:

Logic: before PositionClosePartial, check remaining = curVol − volToClose. If remaining < threshold:

• Nếu full close ≤ remainingBudget → đóng FULL position (log tag full_anti_residue)If full close ≤ remainingBudget → close FULL position (log tag full_anti_residue)
• Nếu không đủ budget → SKIP (không partial để tránh tạo residue)If not enough budget → SKIP (don't partial to avoid residue)

Lớp 2 — Auto-clean (dọn residue tồn dư)Layer 2 — Auto-clean (residual cleanup)

CleanResiduePositions() chạy mỗi tick (sau Hedge check trong OnTick):

CleanResiduePositions() runs every tick (after Hedge check in OnTick):

for each position:
   if Hedge → skip
   if volume ≥ threshold → skip   ← không phải residue
   if profit < floor → skip       ← chưa đủ lời
   PositionClose()                ← đóng residue

Mỗi tick đóng tất cả residue đáp ứng điều kiện. Cost: O(n) scan, ~µs với 100 positions.

Closes all qualifying residue every tick. Cost: O(n) scan, ~µs for 100 positions.

Lớp 3 — Defensive filter (residue lỗ sâu chưa kịp dọn)Layer 3 — Defensive filter (residue with deep loss not yet cleaned)

Filter residue khỏi 4 vị trí structural:

Filter residue from 4 structural sites:

1. GetRoundInfo — tính lowB/highB/lowS/highS cho refBuy/refSellcomputes lowB/highB/lowS/highS for refBuy/refSell
2. CountInitsInGap — đếm rounds in gap zonecounts rounds in gap zone
3. Gap detection trongGap detection in ProcessNewBarEntries
4. Panel "Gap" displayPanel "Gap" display

Đảm bảo residue lỗ sâu (chưa thoả điều kiện auto-clean) không phá structural analysis.

Ensures deep-loss residue (not yet eligible for auto-clean) doesn't break structural analysis.

Khi nào tắt từng phầnWhen to disable each part

20. Info Panel

Panel thông tin hiển thị trên chart thời gian thực. Bố cục 3 cột: trái · giữa · phải. 5 dòng chính + nhiều dòng debug/status tùy chọn (FlashCrash, Daily Limit, TMap, Gap, Cloud, NodeRole).

Real-time info panel on chart. 3-column layout: left · center · right. 5 main rows + multiple optional debug/status rows (FlashCrash, Daily Limit, TMap, Gap, Cloud, NodeRole).

Bố cục dòngRow layout

* Trend và Sideway chỉ hiện khi bật tính năng tương ứng. Cột giữa dòng 5 luôn hiển thị AutoBal (phụ thuộc vào InpLotBalanceEnable). Dòng 5b (Pivot) chỉ khi InpPivotFilterEnable = true. Dòng 5c (Wick) chỉ khi InpWickFilterEnable = true. Dòng 6 (FlashCrash) chỉ hiện khi InpFlashCrashProtectionEnable = true; dòng 7 (Daily Limit) khi InpDailyLimitEnable = true hoặc đã đạt limit. Dòng 8 (TMap) luôn hiện. Dòng 9 (Gap) chỉ khi SingleRoundMode + GapInits. Dòng 10–11 (Cloud + NodeRole) chỉ khi InpCloudSyncEnable = true. Background panel tự auto-resize theo số dòng đang hiện.

* Trend and Sideway only show when their feature is enabled. Row 5 center always shows AutoBal (depends on InpLotBalanceEnable). Row 5b (Pivot) only when InpPivotFilterEnable = true. Row 5c (Wick) only when InpWickFilterEnable = true. Row 6 (FlashCrash) only when InpFlashCrashProtectionEnable = true; row 7 (Daily Limit) when InpDailyLimitEnable = true or limit is reached. Row 8 (TMap) always shows. Row 9 (Gap) only when SingleRoundMode + GapInits. Rows 10–11 (Cloud + NodeRole) only when InpCloudSyncEnable = true. Panel background auto-resizes to fit visible rows.

Dòng debug/status — chi tiết hiển thịDebug / status rows — display details

AutoBal — Trạng thái Lot Balance— Lot Balance status

Màu sắc panelPanel colors

20b. Panel — 3 dòng Filter Status (Pivot / Wick / Whip)Panel — 3 Filter Status lines (Pivot / Wick / Whip)

Ba dòng này cho biết vì sao EA đang / KHÔNG vào lệnh ngay lúc này. Đọc chung 3 dòng để biết filter nào đang chặn.

These three lines tell you why the EA is / is not entering right now. Read them together to see which filter is blocking.

1) Pivot[<method>/<mode>]: <near> | PP=<price>

Chỉ hiện khi InpPivotFilterEnable = true.

Only shown when InpPivotFilterEnable = true.

2) Wick[<TF1>+<TF2>]: <state>

Chỉ hiện khi InpWickFilterEnable = true. TF1/TF2 = 2 khung kiểm râu nến (AND logic).

Only shown when InpWickFilterEnable = true. TF1/TF2 = the two wick-check timeframes (AND logic).

3) Whip: [group] ADX=X.X(regime) NP=N HTF<dir><✓/✗> [BLK: …]

Trạng thái Choppy Defense Group (gộp 5 filter chống whipsaw). Hiện khi bật InpChoppyFilterEnable / InpTrendAdaptive / InpMultiTfTrendEnable.

Choppy Defense Group status (the 5 whipsaw-defense filters combined). Shown when InpChoppyFilterEnable / InpTrendAdaptive / InpMultiTfTrendEnable is on.

⚠️ Lưu ý: khi [BYPASS], dòng [BLK: HTF-MISS] chỉ là hiển thị cảnh báo — KHÔNG thực sự chặn init (defense đang tắt → hàm check HTF trả "agree"). Chỉ enforced khi [ACTIVE].

⚠️ Note: during [BYPASS], [BLK: HTF-MISS] is a display warning only — it does NOT actually block init (defenses off → the HTF check returns "agree"). Enforced only under [ACTIVE].

Đọc chung 3 dòng → EA có vào lệnh không?Reading all 3 together → will the EA enter?

Init bị chặn nếu bất kỳ filter nào chặn: Pivot (giá xa hết level khi COOP) · Wick (UP/DN/BOTH) · Whip có [BLK: CHOP/AW/DD] (khi ACTIVE). Ví dụ ảnh trên: Wick BOTH ❌ đang chặn cả 2 chiều → EA chưa vào lệnh, dù Whip đang bypass và HTF-MISS chỉ là cảnh báo.

Init is blocked if any filter blocks: Pivot (price far from all levels in COOP) · Wick (UP/DN/BOTH) · Whip with [BLK: CHOP/AW/DD] (when ACTIVE). In the example above: Wick BOTH ❌ is blocking both sides → the EA won't enter, even though Whip is bypassed and HTF-MISS is only a warning.

21. Thẻ comment lệnhOrder Comment Tags

Mỗi lệnh có comment theo format: Init R{roundId} P|… / N|…, DCAPos R{roundId} B#…, DCANeg R{roundId} S#…, v.v. Chữ P / N sau số round trên lệnh Init = chân theo trend / ngược trend. Có thể đọc comment để biết round và nhánh DCA.

Comments follow patterns like Init R{roundId} P|… / N|…, DCAPos R{roundId} B#…, DCANeg R{roundId} S#…, etc. P / N right after the round number on Init = with-trend / counter-trend leg. Use comments to identify round and DCA branch.

22. File Config Gợi ýPreset Config Files