|
|
@@ -1,2 +1,77 @@
|
|
1
|
1
|
# blTelegramToMt4
|
|
|
2
|
+# EA README — Signal Receiver & Executor (Telegram-style messages)
|
|
2
|
3
|
|
|
|
4
|
+**Purpose:**
|
|
|
5
|
+This EA reads trade-entry messages in the exact visual/text format shown in your screenshot, parses symbol / side / open / SL / TP, and places trades automatically on the chart symbol you attach the EA to. TP and SL values are taken directly from the signal message. Lot size is provided by the user via the EA input. The EA is designed for brokers like Exness where symbols may have suffixes (e.g. `EURUSD`).
|
|
|
6
|
+
|
|
|
7
|
+---
|
|
|
8
|
+
|
|
|
9
|
+## Message format (required — exact structure)
|
|
|
10
|
+
|
|
|
11
|
+The EA expects messages with the same text block structure as in your image. Example accepted formats:
|
|
|
12
|
+
|
|
|
13
|
+```
|
|
|
14
|
+BL Tech pro (Paid) channel
|
|
|
15
|
+EURUSD Buy now 📈
|
|
|
16
|
+⚪ Open: 1.06750
|
|
|
17
|
+🔻 SL: 1.06650
|
|
|
18
|
+🔹 TP: 1.06850
|
|
|
19
|
+Use Small Lot
|
|
|
20
|
+```
|
|
|
21
|
+
|
|
|
22
|
+or
|
|
|
23
|
+
|
|
|
24
|
+```
|
|
|
25
|
+BL Tech pro (Paid) channel
|
|
|
26
|
+EURUSD SELL now 📉
|
|
|
27
|
+⚪ Open: 1.06750
|
|
|
28
|
+🔻 SL: 1.06850
|
|
|
29
|
+🔹 TP: 1.06650
|
|
|
30
|
+Use Small Lot
|
|
|
31
|
+```
|
|
|
32
|
+
|
|
|
33
|
+**Notes:**
|
|
|
34
|
+
|
|
|
35
|
+* Whitespace and minor emoji differences are tolerated, but the parser looks for the tokens`SL:`, `TP:` and the direction words `Buy`/`SELL` (case-insensitive).
|
|
|
36
|
+* Symbol must match the broker symbol exactly (e.g., `EURUSD`) with suffix like m, p. The EA provides a symbol-mapping option if the incoming signal uses a different convention (see inputs).
|
|
|
37
|
+
|
|
|
38
|
+```
|
|
|
39
|
+=== SIGNAL PARSE ===
|
|
|
40
|
+Symbol: EURUSDm | Side: BUY
|
|
|
41
|
+Open: 1.06750 | SL: 1.06650 | TP: 1.06850
|
|
|
42
|
+Lot: 0.01 | Slippage: 5 | Method: file
|
|
|
43
|
+=== ORDER ACTION ===
|
|
|
44
|
+OrderType: MARKET_BUY | Ticket: 123456 | Result: SUCCESS
|
|
|
45
|
+```
|
|
|
46
|
+
|
|
|
47
|
+This mirrors your preference for grouped / section header style debugging.
|
|
|
48
|
+
|
|
|
49
|
+---
|
|
|
50
|
+
|
|
|
51
|
+## Example signals (ready-to-use)
|
|
|
52
|
+
|
|
|
53
|
+**Buy example**
|
|
|
54
|
+
|
|
|
55
|
+```
|
|
|
56
|
+BL Tech pro (Paid) channel
|
|
|
57
|
+EURUSDm Buy now 📈
|
|
|
58
|
+⚪ Open: 1.06750
|
|
|
59
|
+🔻 SL: 1.06650
|
|
|
60
|
+🔹 TP: 1.06850
|
|
|
61
|
+Use Small Lot
|
|
|
62
|
+```
|
|
|
63
|
+
|
|
|
64
|
+**Sell example**
|
|
|
65
|
+
|
|
|
66
|
+```
|
|
|
67
|
+BL Tech pro (Paid) channel
|
|
|
68
|
+EURUSDm SELL now 📉
|
|
|
69
|
+⚪ Open: 1.06750
|
|
|
70
|
+🔻 SL: 1.06850
|
|
|
71
|
+🔹 TP: 1.06650
|
|
|
72
|
+Use Small Lot
|
|
|
73
|
+```
|
|
|
74
|
+
|
|
|
75
|
+Remember: EA uses `LotSize` input for the actual executed lot.
|
|
|
76
|
+
|
|
|
77
|
+---
|