457 lines
20 KiB
Markdown
457 lines
20 KiB
Markdown
# RSIForceStateEA
|
||
|
||
EA giao dịch pullback theo động lực RSI, lọc xu hướng bằng EMA200, điều phối bằng state
|
||
machine 4 trạng thái. Mỗi pullback chỉ một lệnh, vào bằng **BUY/SELL LIMIT** (không đuổi giá market).
|
||
|
||
## 1) Cấu trúc thư mục
|
||
|
||
- EA chính: `Experts/RSIForceStateEA.mq5`
|
||
- Các module:
|
||
- `Experts/RSIForceStateEA/Config.mqh` — toàn bộ tham số đầu vào (`input`)
|
||
- `Experts/RSIForceStateEA/State.mqh` — `enum` + `struct` (không chứa biến global)
|
||
- `Experts/RSIForceStateEA/Indicators.mqh` — handle chỉ báo + buffer + hàm slope/cross
|
||
- `Experts/RSIForceStateEA/Trade.mqh` — đặt lệnh, khối lượng theo rủi ro, partial + BE
|
||
- `Experts/RSIForceStateEA/StateMachine.mqh` — luồng 4 trạng thái
|
||
- `Experts/RSIForceStateEA/Visualizer.mqh` — dashboard, bảng thống kê, mức Entry/SL/TP
|
||
- `Experts/RSIForceStateEA/README.md` — tài liệu này
|
||
|
||
Thứ tự `#include` trong file `.mq5`:
|
||
|
||
```
|
||
Layer 1 : Config -> State -> Indicators
|
||
Globals : g_State, g_Pending, g_OpenTrade
|
||
Layer 2 : Trade -> StateMachine
|
||
Layer 3 : Visualizer
|
||
```
|
||
|
||
## 2) Logic tổng thể
|
||
|
||
### 2.1 Các chỉ báo
|
||
|
||
- `RSI(InpRSIPeriod)` — động lực giá.
|
||
- `EMA(InpRSI_EMA9Period)` — tính **trên** chuỗi RSI.
|
||
- `WMA(InpRSI_WMA45Period)` — tính **trên** chuỗi RSI.
|
||
- `EMA(InpEMA200Period)` — trên **giá đóng** — lọc xu hướng.
|
||
- `ATR(InpATRPeriod)` — dùng cho vùng đệm trend và SL.
|
||
|
||
### 2.2 Bộ lọc xu hướng (trend)
|
||
|
||
- **Uptrend** khi `Close > EMA200 + buffer`.
|
||
- **Downtrend** khi `Close < EMA200 - buffer`.
|
||
- **Buffer**:
|
||
- Theo `%` EMA200 mặc định (`InpTrendBufferPercent = 0.10%`), hoặc
|
||
- Theo ATR nếu `InpUseATRTrendBuffer = true`.
|
||
- `InpSkipFlatEMA200`: bỏ qua khi EMA200 “phẳng” (chênh lệch giữa hai nến ≤ `ATR * InpFlatEMA_ATRMult`).
|
||
|
||
### 2.3 Bốn trạng thái
|
||
|
||
| Trạng thái | Ý nghĩa |
|
||
| ----------- | ------- |
|
||
| `STATE_NO_TRADE` | Chưa có setup hợp lệ |
|
||
| `STATE_WATCHING` | Đã có pullback hợp lệ, đang chờ tín hiệu vào lệnh |
|
||
| `STATE_PENDING_ORDER` | Đã đặt BUY/SELL LIMIT, chờ khớp |
|
||
| `STATE_IN_TRADE` | Đã khớp, đang quản lý vị thế (partial + BE + TP) |
|
||
|
||
### 2.4 Pullback (`NO_TRADE` → `WATCHING`)
|
||
|
||
- Pullback trong **uptrend**:
|
||
- `RSI < EMA9 < WMA45`
|
||
- Cả ba đường cùng **slope giảm** (kiểm tra trên `InpSlopeLookbackBars` nến).
|
||
- Pullback trong **downtrend**: đối xứng (slope tăng).
|
||
|
||
### 2.5 Kích hoạt vào lệnh (`WATCHING` → `PENDING_ORDER`)
|
||
|
||
- **Tín hiệu BUY**:
|
||
- RSI cắt **lên** WMA45 (so sánh nến `InpSignalBarShift` với nến trước).
|
||
- EMA9 vẫn **dưới** WMA45.
|
||
- Trong `InpMinBarsBetweenCrosses` nến trước đó **không** có cắt RSI/WMA45 (tín hiệu “cô lập”, tránh nhiễu sát WMA45).
|
||
- **Tín hiệu SELL**: đối xứng.
|
||
|
||
### 2.6 Đặt lệnh LIMIT
|
||
|
||
- `Entry = (Close(nến tín hiệu) + SwingExtreme) / 2`
|
||
- **BUY**: SwingExtreme = đáy gần nhất trong `InpSwingLookbackBars`.
|
||
- **SELL**: SwingExtreme = đỉnh gần nhất.
|
||
- Lệnh: `BuyLimit` / `SellLimit` (không vào market).
|
||
- Pending tối đa `InpPendingMaxAliveBars` nến; hết hạn → hủy.
|
||
- Nếu `InpInvalidateIfCrossBack = true`: RSI cắt ngược lại WMA45 hoặc mất trend → hủy.
|
||
- `WATCHING` tối đa `InpWatchingMaxBars` nến không có trigger → về `NO_TRADE`.
|
||
|
||
### 2.7 Stop Loss
|
||
|
||
| Chế độ | Công thức |
|
||
| ------ | --------- |
|
||
| `SL_SWING` | Cực trị swing ± `InpSL_SwingBufferPoints` (point) |
|
||
| `SL_ATR` | `Entry ± ATR * InpSL_ATRMult` |
|
||
| `SL_HYBRID` | Chọn SL **rộng hơn** giữa swing và ATR (mặc định, an toàn hơn) |
|
||
|
||
### 2.8 Take Profit
|
||
|
||
- `TP = Entry ± R * InpRiskRewardRatio` (mặc định `2R`).
|
||
|
||
### 2.9 Quản lý khi `IN_TRADE`
|
||
|
||
- Rủi ro: `InpRiskPercent` (% số dư, mặc định 1%).
|
||
- Khi giá đạt `InpPartialCloseAtR` lần **R thực tế** (mặc định `1.5R`):
|
||
- Đóng `InpPartialClosePercent` % khối lượng (mặc định 50%).
|
||
- Dời SL về **giá khớp** (BE).
|
||
- Nếu không chia được lot (bị `volume min` chặn): vẫn dời SL về BE, bỏ qua partial.
|
||
- Không có hành động đặc biệt tại `1R`.
|
||
|
||
### 2.10 Chống spam (một pullback — một lệnh thử)
|
||
|
||
- Biến `g_HasTradedThisPullback`: sau khi **đặt thành công** pending cho pullback hiện tại → bật.
|
||
- **Reset** `g_HasTradedThisPullback` khi:
|
||
- Pending bị hủy / hết hạn / invalid (chưa khớp → được thử pullback khác).
|
||
- Vị thế đã đóng hoàn toàn (TP/SL/đóng tay).
|
||
- **Đảo chiều xu hướng có hướng** UP ↔ DOWN (đi qua `TREND_NONE` ngắn **không** coi là đảo chiều).
|
||
- Khi đảo chiều UP ↔ DOWN mà còn pending ngược hướng → hủy pending.
|
||
|
||
### 2.11 Bộ lọc RSI sideway
|
||
|
||
- `InpUseRSISidewayFilter`: nếu **tất cả** `InpSidewayLookbackBars` giá trị RSI gần nhất nằm trong `[InpSidewayRSILow, InpSidewayRSIHigh]` → bỏ qua tìm setup mới.
|
||
- Bộ lọc này **chỉ** chặn nhánh `NO_TRADE → WATCHING`; **không** chặn vòng đời pending và **không** chặn quản lý vị thế.
|
||
|
||
## 3) Cách biên dịch và chạy
|
||
|
||
1. Mở MetaEditor.
|
||
2. Mở `MQL5/Experts/RSIForceStateEA.mq5` và biên dịch (F7).
|
||
3. Quay lại MT5, gắn EA vào biểu đồ cần giao dịch.
|
||
4. Bật **Algo Trading**.
|
||
5. Có thể chỉnh `Inputs` ngay trên giao diện khi gắn EA.
|
||
|
||
## 4) Các tham số quan trọng (mặc định)
|
||
|
||
| Tham số | Mặc định | Mô tả |
|
||
| ------- | -------- | ----- |
|
||
| `InpMagicNumber` | 26050901 | Magic; đổi nếu chạy nhiều bản EA |
|
||
| `InpRiskPercent` | 1.0 | % số dư / mỗi lệnh |
|
||
| `InpRiskRewardRatio` | 2.0 | TP = R × hệ số này |
|
||
| `InpPartialCloseAtR` | 1.5 | Chốt một phần khi đạt R này (phải < RR) |
|
||
| `InpPartialClosePercent` | 50.0 | % khối lượng chốt partial |
|
||
| `InpPendingMaxAliveBars` | 5 | Hủy pending sau N nến |
|
||
| `InpWatchingMaxBars` | 10 | Thoát WATCHING nếu không có trigger |
|
||
| `InpMinBarsBetweenCrosses` | 10 | Khoảng cách tối thiểu giữa các lần cắt RSI/WMA45 |
|
||
| `InpSlopeLookbackBars` | 3 | Số nến kiểm tra slope |
|
||
| `InpSwingLookbackBars` | 20 | Cửa sổ tìm swing cho entry/SL |
|
||
| `InpStopLossMode` | SL_HYBRID | `SL_SWING` / `SL_ATR` / `SL_HYBRID` |
|
||
| `InpSL_ATRMult` | 1.2 | Hệ số ATR cho SL kiểu ATR |
|
||
| `InpSL_SwingBufferPoints` | 20 | Đệm thêm (point) ngoài cực trị swing |
|
||
| `InpUseRSISidewayFilter` | true | Bật/tắt lọc sideway RSI |
|
||
| `InpSidewayRSILow / High` | 45 / 55 | Dải sideway theo RSI |
|
||
| `InpUseATRTrendBuffer` | false | Dùng buffer trend theo ATR |
|
||
|
||
## 5) Gợi ý kiểm thử và tối ưu
|
||
|
||
- Nên backtest từng symbol ít nhất 6–12 tháng trước khi chạy thật.
|
||
- Thị trường biến động mạnh: thử `InpUseATRTrendBuffer = true`.
|
||
- Muốn **ít tín hiệu hơn nhưng chọn lọc hơn**:
|
||
- Tăng `InpMinBarsBetweenCrosses`
|
||
- Tăng `InpSlopeLookbackBars`
|
||
- Giữ `SL_HYBRID`
|
||
- Muốn **nhiều tín hiệu hơn**:
|
||
- Giảm `InpSlopeLookbackBars` xuống 2
|
||
- Tắt `InpUseRSISidewayFilter`
|
||
- Theo dõi tab **Experts** / **Journal** để xem log `[STATE]`, `[TREND]`, `[PENDING]`, `[TRADE]`.
|
||
|
||
## 6) Hiển thị trực quan (Visualization)
|
||
|
||
EA có thể tự vẽ để quan sát và đánh giá (bật/tắt bằng `InpVisualize` và các cờ con).
|
||
|
||
### 6.1 Dashboard (góc trên-trái)
|
||
|
||
Hiển thị:
|
||
|
||
- **Trend**: UP / DOWN / NONE (màu xanh / đỏ / xám)
|
||
- **State**: `STATE_NO_TRADE` / `STATE_WATCHING` / `STATE_PENDING_ORDER` / `STATE_IN_TRADE`
|
||
- **RSI**: giá trị RSI, EMA9, WMA45 tại nến tín hiệu (`InpSignalBarShift`)
|
||
- **EMA200**: giá trị EMA200 + giá đóng hiện tại
|
||
- **ATR**: giá trị ATR
|
||
- **Context**: tùy trạng thái — ví dụ số nến WATCHING, thời gian sống pending, đã partial hay chưa
|
||
|
||
### 6.2 Bảng thống kê (góc dưới-trái)
|
||
|
||
Quét lịch sử `InpStatsLookbackDays` ngày (mặc định 60), lọc theo `InpMagicNumber` + `_Symbol`:
|
||
|
||
- **Total**: số vị thế đã đóng (gộp theo `POSITION_ID`, tránh đếm trùng partial)
|
||
- **TP hit**: số deal đóng với lý do `DEAL_REASON_TP`
|
||
- **SL hit**: số deal đóng với lý do `DEAL_REASON_SL`
|
||
- **Other**: đóng tay / partial / đóng bởi expert
|
||
- **Net PL**: tổng P/L (profit + swap + hoa hồng)
|
||
|
||
### 6.3 Mức giá Entry / SL / TP (kiểu TradingView)
|
||
|
||
Khi `STATE_PENDING_ORDER` hoặc `STATE_IN_TRADE`, vẽ 3 đường ngang:
|
||
|
||
- **ENTRY** (chấm, màu `InpColorEntry`)
|
||
- **SL** (gạch, màu `InpColorSL`)
|
||
- **TP** (gạch, màu `InpColorTP`)
|
||
|
||
Tự xóa khi về `NO_TRADE`.
|
||
|
||
### 6.4 Tự gắn chỉ báo lên chart
|
||
|
||
Khi `InpAttachIndicators = true` (mặc định):
|
||
|
||
- **EMA200** vào cửa sổ chính.
|
||
- **RSI**, **EMA trên RSI**, **WMA trên RSI** vào **cửa sổ phụ** (subwindow).
|
||
|
||
Có thể tắt từng phần:
|
||
|
||
| Tham số | Mặc định | Tác dụng |
|
||
| ------- | -------- | -------- |
|
||
| `InpVisualize` | true | Bật/tắt toàn bộ lớp hiển thị |
|
||
| `InpAttachIndicators` | true | Tự thêm EMA200 + cụm RSI lên chart |
|
||
| `InpShowDashboard` | true | Panel góc trên-trái |
|
||
| `InpShowStatsPanel` | true | Panel góc dưới-trái |
|
||
| `InpShowTradeLevels` | true | Đường Entry/SL/TP |
|
||
| `InpStatsLookbackDays` | 60 | Số ngày quét thống kê |
|
||
|
||
Mọi đối tượng đồ họa dùng tiền tố `RSIForce_` và được xóa trong `OnDeinit`.
|
||
|
||
## 7) Luồng chạy chi tiết (từng bước)
|
||
|
||
### 7.1 Toàn cảnh kiến trúc
|
||
|
||
```
|
||
+-------------------------------------------------------------+
|
||
| RSIForceStateEA.mq5 |
|
||
| (điểm vào — chỉ có OnInit / OnTick / OnTradeTransaction |
|
||
| / OnDeinit, không chứa logic nghiệp vụ) |
|
||
+-------------------------------------------------------------+
|
||
|
|
||
| #include theo thứ tự:
|
||
v
|
||
+-------- Tầng 1 (dữ liệu + kiểu) ---------------------------+
|
||
| Config.mqh — toàn bộ input |
|
||
| State.mqh — enum EAState, struct SignalSnapshot... |
|
||
| Indicators.mqh — handle iRSI/iMA + buffer g_RSI[]... |
|
||
+------------------------------------------------------------+
|
||
|
|
||
| Khai báo global trong .mq5:
|
||
| g_State, g_Pending, g_OpenTrade
|
||
v
|
||
+-------- Tầng 2 (logic) ------------------------------------+
|
||
| Trade.mqh — CalcLotsForRisk, PlaceLimitOrderFromPlan,|
|
||
| ManagePartialAndBreakEven... |
|
||
| StateMachine.mqh — DetectTrend, IsPullback*, IsBuyTrigger*, |
|
||
| BuildSignalPlan, RunStateMachine... |
|
||
+------------------------------------------------------------+
|
||
|
|
||
v
|
||
+-------- Tầng 3 (giao diện) --------------------------------+
|
||
| Visualizer.mqh — DrawDashboardPanel, DrawStatsPanel, |
|
||
| DrawTradeLevels, AttachIndicatorsToChart |
|
||
+------------------------------------------------------------+
|
||
```
|
||
|
||
### 7.2 Vòng đời — từ lúc gắn EA
|
||
|
||
#### Bước 0. MT5 gọi `OnInit()` (file `RSIForceStateEA.mq5`)
|
||
|
||
```
|
||
RSIForceStateEA.mq5 :: OnInit()
|
||
|
|
||
+-- ValidateInputs() (file .mq5 — kiểm tra cấu hình)
|
||
| nếu sai -> INIT_PARAMETERS_INCORRECT (EA không khởi động)
|
||
|
|
||
+-- ZeroMemory(g_Pending), ZeroMemory(g_OpenTrade)
|
||
| đưa global về trạng thái sạch
|
||
|
|
||
+-- InitIndicators() (Indicators.mqh)
|
||
| |
|
||
| +-- iRSI(...) -> g_hRSI
|
||
| +-- iMA(g_hRSI, EMA) -> g_hEMA9 (EMA trên RSI)
|
||
| +-- iMA(g_hRSI, WMA) -> g_hWMA45 (WMA trên RSI)
|
||
| +-- iMA(close, EMA) -> g_hEMA200 (EMA trên giá đóng)
|
||
| +-- iATR(...) -> g_hATR
|
||
| +-- ArraySetAsSeries(...) cho mọi buffer
|
||
|
|
||
+-- RefreshIndicatorData() (Indicators.mqh)
|
||
| |
|
||
| +-- CopyRates() -> g_Bars[]
|
||
| +-- CopyBuffer() -> g_RSI[], g_EMA9[], g_WMA45[], g_EMA200[], g_ATR[]
|
||
| nếu chart chưa đủ lịch sử (< 200 nến) -> INIT_FAILED
|
||
|
|
||
+-- InitTradeOps() (Trade.mqh)
|
||
| |
|
||
| +-- g_TradeOps.SetExpertMagicNumber(InpMagicNumber)
|
||
| +-- g_TradeOps.SetDeviationInPoints(10)
|
||
| +-- g_TradeOps.SetTypeFillingBySymbol(_Symbol)
|
||
|
|
||
+-- g_LastTrend = DetectTrend(InpSignalBarShift)
|
||
| khởi tạo trend ngay từ đầu để tick đầu không báo “đảo chiều” giả
|
||
|
|
||
+-- AttachIndicatorsToChart() (Visualizer.mqh)
|
||
| |
|
||
| +-- IsIndicatorAlreadyAttached(...) — tránh trùng khi reload EA
|
||
| +-- ChartIndicatorAdd(0, 0, g_hEMA200) -> cửa sổ chính
|
||
| +-- ChartIndicatorAdd(0, sub, g_hRSI) -> subwindow
|
||
| +-- ChartIndicatorAdd(0, sub, g_hEMA9)
|
||
| +-- ChartIndicatorAdd(0, sub, g_hWMA45)
|
||
|
|
||
+-- DrawAllVisuals(g_LastTrend) (Visualizer.mqh)
|
||
vẽ dashboard + stats lần đầu
|
||
```
|
||
|
||
#### Bước 1. Mỗi tick — `OnTick()` (`RSIForceStateEA.mq5`)
|
||
|
||
```
|
||
RSIForceStateEA.mq5 :: OnTick()
|
||
|
|
||
+-- RefreshIndicatorData() (Indicators.mqh)
|
||
| cập nhật g_Bars / g_RSI / g_EMA9 / g_WMA45 / g_EMA200 / g_ATR
|
||
| nếu copy lỗi (ví dụ thị trường vừa mở) -> return, chờ tick sau
|
||
|
|
||
+-- SyncStateWithBroker() (StateMachine.mqh)
|
||
| |
|
||
| nếu state = PENDING_ORDER:
|
||
| +- HasOurOpenPosition() = true ? (Trade.mqh)
|
||
| | -> chuyển IN_TRADE, copy kế hoạch từ g_Pending sang g_OpenTrade
|
||
| +- HasOurPendingOrder() = false (hủy/hết hạn/từ chối) ?
|
||
| -> reset g_HasTradedThisPullback, về NO_TRADE
|
||
|
|
||
| nếu state = IN_TRADE:
|
||
| +- HasOurOpenPosition() = false (TP/SL/đóng tay) ?
|
||
| -> reset g_HasTradedThisPullback, về NO_TRADE
|
||
|
|
||
+-- if (state == IN_TRADE):
|
||
| ManagePartialAndBreakEven(g_OpenTrade) (Trade.mqh)
|
||
| |
|
||
| +- PositionSelectByTicket(positionTicket)
|
||
| +- profitDist = giá hiện tại so với giá mở (BUY/SELL)
|
||
| +- initRisk = |openPrice - SL| (lấy từ broker, không dùng plan)
|
||
| +- nếu profitDist >= InpPartialCloseAtR * initRisk:
|
||
| - PositionClosePartial(ticket, % volume) nếu chia lot được
|
||
| - PositionModify(ticket, openPrice, tp) — SL về BE
|
||
| - g_OpenTrade.partialClosedDone = true (chỉ một lần)
|
||
|
|
||
+-- newBar = IsNewBar() (StateMachine.mqh)
|
||
| so sánh g_Bars[0].time với lastBarTime — true khi nến mới mở
|
||
|
|
||
+-- if (newBar): RunStateMachine() <-- xem Bước 2
|
||
|
|
||
+-- if (newBar HOẶC đã qua 2 giây kể từ lần vẽ trước):
|
||
DrawAllVisuals(DetectTrend(InpSignalBarShift)) (Visualizer.mqh)
|
||
|
|
||
+- DrawDashboardPanel(trend)
|
||
+- DrawStatsPanel()
|
||
+- DrawTradeLevels()
|
||
```
|
||
|
||
#### Bước 2. Có nến mới — `RunStateMachine()` (`StateMachine.mqh`)
|
||
|
||
```
|
||
StateMachine.mqh :: RunStateMachine()
|
||
|
|
||
+-- signalShift = InpSignalBarShift (mặc định = 1, nến vừa đóng)
|
||
+-- trendNow = DetectTrend(signalShift) (Up / Down / None)
|
||
|
|
||
+-- Phát hiện đảo chiều **có hướng** thật (UP <-> DOWN):
|
||
| |
|
||
| nếu trendNow != NONE:
|
||
| +- so với g_LastDirTrend (xu hướng có hướng trước đó)
|
||
| +- nếu g_LastDirTrend khác hướng và cả hai đều không NONE
|
||
| -> dirFlipped = true
|
||
| +- cập nhật g_LastDirTrend = trendNow
|
||
|
|
||
+-- if (dirFlipped): <-- chỉ reset khi UP <-> DOWN
|
||
| +- ResetPullbackCycle()
|
||
| +- nếu PENDING_ORDER -> CancelPendingOrder, về NO_TRADE
|
||
| +- nếu WATCHING -> về NO_TRADE
|
||
|
|
||
+-- g_LastTrend = trendNow
|
||
|
|
||
+-- switch (g_State):
|
||
|
|
||
case STATE_NO_TRADE:
|
||
| HandleStateNoTrade(...)
|
||
|
|
||
case STATE_WATCHING:
|
||
| HandleStateWatching(...)
|
||
| (timeout, BuildSignalPlan, PlaceLimitOrderFromPlan...)
|
||
|
|
||
case STATE_PENDING_ORDER:
|
||
| TickPendingOrderLifecycle(...)
|
||
| (đếm nến, hết hạn/invalid -> hủy, reset anti-spam)
|
||
|
|
||
case STATE_IN_TRADE:
|
||
(không làm gì ở đây — partial/BE chạy trong OnTick)
|
||
```
|
||
|
||
#### Bước 3. Biến động lệnh — `OnTradeTransaction()`
|
||
|
||
```
|
||
RSIForceStateEA.mq5 :: OnTradeTransaction(...)
|
||
|
|
||
+-- SyncStateWithBroker()
|
||
đồng bộ ngay khi broker báo sự kiện (không chỉ dựa vào tick)
|
||
```
|
||
|
||
#### Bước 4. Gỡ EA — `OnDeinit()`
|
||
|
||
```
|
||
RSIForceStateEA.mq5 :: OnDeinit(reason)
|
||
|
|
||
+-- RemoveAllVisuals() (Visualizer.mqh)
|
||
| ObjectsDeleteAll(0, "RSIForce_")
|
||
|
|
||
+-- ReleaseIndicators() (Indicators.mqh)
|
||
IndicatorRelease cho mọi handle
|
||
```
|
||
|
||
### 7.3 Bảng phân công: file nào làm việc gì
|
||
|
||
| Trách nhiệm | File | Hàm chính |
|
||
| ----------- | ---- | --------- |
|
||
| Toàn bộ input | `Config.mqh` | (chỉ khai báo) |
|
||
| Enum / struct | `State.mqh` | `EAState`, `TrendDirection`, `SignalSnapshot`, `PendingContext`, `TradeContext` |
|
||
| Tạo & cập nhật chỉ báo | `Indicators.mqh` | `InitIndicators`, `RefreshIndicatorData`, `IsBufferSlopingDown/Up`, `HasCrossInLastNBars` |
|
||
| Lot, đặt/hủy/quản lý lệnh | `Trade.mqh` | `CalcLotsForRisk`, `PlaceLimitOrderFromPlan`, `CancelPendingOrder`, `ManagePartialAndBreakEven` |
|
||
| Trend, pullback, trigger | `StateMachine.mqh` | `DetectTrend`, `IsPullbackInUptrend/Downtrend`, `IsBuyTriggerSignal`, `IsSellTriggerSignal` |
|
||
| Điều phối state machine | `StateMachine.mqh` | `RunStateMachine`, `HandleStateNoTrade`, `HandleStateWatching`, `TickPendingOrderLifecycle` |
|
||
| Đồng bộ broker | `StateMachine.mqh` | `SyncStateWithBroker` (+ `HasOurOpenPosition` / `HasOurPendingOrder` trong `Trade.mqh`) |
|
||
| UI & mức giá | `Visualizer.mqh` | `DrawDashboardPanel`, `DrawStatsPanel`, `DrawTradeLevels`, `AttachIndicatorsToChart` |
|
||
| Vòng đời & validate | `RSIForceStateEA.mq5` | `OnInit`, `OnTick`, `OnTradeTransaction`, `OnDeinit`, `ValidateInputs` |
|
||
|
||
### 7.4 Global của EA và ai được sửa
|
||
|
||
| Global | Kiểu | Vai trò | Thường sửa tại |
|
||
| ------ | ---- | ------- | -------------- |
|
||
| `g_State` | `EAState` | Trạng thái SM | `TransitionTo` (StateMachine.mqh) |
|
||
| `g_Pending` | `PendingContext` | Lệnh chờ | `PlaceLimitOrderFromPlan`, `CancelPendingOrder` |
|
||
| `g_OpenTrade` | `TradeContext` | Vị thế mở | `SyncStateWithBroker`, `ManagePartialAndBreakEven` |
|
||
| `g_HasTradedThisPullback` | `bool` | Chống spam | Khi đặt lệnh; reset khi hủy/đóng/đảo chiều |
|
||
| `g_BarsInWatching` | `int` | Timeout WATCHING | `HandleStateWatching` và khi chuyển trạng thái |
|
||
| `g_LastTrend` | `TrendDirection` | Trend mới nhất | Cuối `RunStateMachine` |
|
||
| `g_LastDirTrend` | `TrendDirection` | Trend có hướng gần nhất | `RunStateMachine` khi `trendNow != NONE` |
|
||
|
||
### 7.5 Sự kiện broker → cách code phản ứng
|
||
|
||
| Sự kiện thực tế | Cách phát hiện | Phản ứng trong code |
|
||
| --------------- | -------------- | ------------------- |
|
||
| Limit khớp | `OnTradeTransaction` + `SyncStateWithBroker` | `PENDING` → `IN_TRADE`, copy plan |
|
||
| Pending hết hạn / bị hủy | `Sync` (không còn order) | `PENDING` → `NO_TRADE`, reset anti-spam |
|
||
| Pending bị từ chối | `PlaceLimit...` false hoặc `Sync` | Ở `NO_TRADE`, có log retcode |
|
||
| Chạm TP | `Sync` (không còn position) | `IN_TRADE` → `NO_TRADE`, reset anti-spam |
|
||
| Chạm SL | như trên | như trên |
|
||
| Đóng tay | như trên | như trên |
|
||
| Đạt mức partial R | `OnTick` → `ManagePartialAndBreakEven` | Partial (nếu được) + SL về BE |
|
||
| Đảo chiều UP ↔ DOWN | `RunStateMachine` — `dirFlipped` | Hủy pending ngược hướng, reset chu kỳ |
|
||
| Đi qua NONE rồi về cùng hướng | `RunStateMachine` | **Không** coi là flip; `g_LastDirTrend` giữ ngữ cảnh |
|
||
| Nến mới | `OnTick` → `IsNewBar` | Gọi `RunStateMachine` một lần |
|
||
|
||
## 8) Ghi chú kiến trúc
|
||
|
||
- State machine chạy theo **nến mới** (`IsNewBar()`), tránh bắn tín hiệu nhiều lần trong cùng một nến.
|
||
- Quản lý vị thế (partial + BE) chạy **mỗi tick** để phản ứng nhanh theo giá.
|
||
- `SyncStateWithBroker()` chạy mỗi tick và sau `OnTradeTransaction` để trạng thái nội bộ luôn khớp broker (đóng tay, từ chối lệnh, v.v.).
|
||
- Phân tầng `#include`:
|
||
- **Tầng 1** chỉ khai báo dữ liệu và hàm thuần.
|
||
- **Tầng 2** dùng các global khai báo giữa hai tầng.
|
||
- **Tầng 3** chỉ đọc/hiển thị, không sửa logic nghiệp vụ cốt lõi.
|
||
|
||
---
|
||
|
||
*Tệp README dùng mã hóa UTF-8. Tiếng Việt có dấu an toàn với Git, GitHub và trình soạn thảo hiện đại; không ảnh hưởng tới biên dịch EA (MetaEditor không compile file `.md`).*
|