# Universal Smart Manual Trade Manager MT5 v1.00
## Was der EA macht
Universal Smart Manual Trade Manager MT5 ist ein schützender und verwaltender Expert Advisor für manuell eröffnete Trades. Er eröffnet nicht von selbst neue Positionen. Er übernimmt nur bereits geöffnete Positionen, die den ausgewählten Filtern entsprechen, und kann fehlende SL/TP hinzufügen, Break-Even, Profit Lock, ATR Trailing verwalten, Telegram-Benachrichtigungen senden und Statusinformationen auf dem Chart anzeigen.
Die Standardeinstellung ist absichtlich sicher: der EA verwaltet nur manuelle Positionen (`magic = 0`) auf dem aktuellen Chartsymbol. Dies minimiert das Risiko, versehentlich mit einem anderen Handelsroboter zu interferieren.
Dieser Expert Advisor ist ein manuelles Handelsverwaltungsprogramm. Er eröffnet keine Trades automatisch und verwendet keine Martingale-, Grid-, Arbitrage-, Scalping- oder Nachrichtenhandelslogik.
## Wichtige Warnung
Der EA ist universell, aber jeder Broker kann unterschiedliche Symbolbedingungen, Tickwerte, Tickgrößen, Mindeststoppabstände, Freeze-Levels und Volumenschritte haben. Bevor Sie den EA live einsetzen, testen Sie immer das genaue Symbol und den Broker auf einem Demokonto oder mit einer sehr kleinen Position.
Der EA liest die Eigenschaften des Brokersymbols wie z.B.:
- `SYMBOL_TRADE_TICK_VALUE`
- SYMBOL_TRADE_TICK_SIZE`
- `SYMBOL_DIGITS`
- `SYMBOL_PUNKT`
- `SYMBOL_TRADE_STOPS_LEVEL`
Dadurch kann das Risiko pro 1 Lot auf universelle Weise berechnet werden. Bei exotischen CFDs und nicht standardisierten Brokersymbolen sollte die Risikoberechnung jedoch immer manuell überprüft werden.
---
# 1. Allgemeine Einstellungen
## InpManagerEnabled
Schaltet die EA-Verwaltung ein oder aus.
- `true` = der EA verwaltet Positionen gemäß den Filtern
- false" = der EA verwaltet keine Positionen
## InpPresetProfile
Schnelles Voreinstellungsprofil. Wenn dies auf einen anderen Wert als `CUSTOM` gesetzt wird, setzt der EA intern ausgewählte detaillierte Parameter außer Kraft.
- HM_PROFILE_CUSTOM" = exakte Eingabewerte werden verwendet
- HM_PROFILE_CONSERVATIVE" = breiterer ATR SL, späterer Break-Even, konservativeres Verhalten
- HM_PROFILE_BALANCED" = Standard-Handelsmanagement-Modus: ATR SL + BE + Sperre
- HM_PROFILE_ACTIVE" = aktiverer Modus mit ATR-Trailing
Empfehlung: Verwenden Sie `CUSTOM` zum Testen und zur Feinabstimmung. Für normale Benutzer ist `BALANCED` die beste Voreinstellung.
## InpManageScope
Legt fest, ob der EA nur das aktuelle Chart-Symbol oder alle Kontosymbole verwaltet.
- HM_SCOPE_CURRENT_SYMBOL" = verwaltet nur das Chart-Symbol, zum Beispiel nur XAUUSD auf einem XAUUSD-Chart
- HM_SCOPE_ALL_SYMBOLS" = eine EA-Instanz scannt und verwaltet alle offenen Positionen des Kontos
Der sichere Standard ist `CURRENT_SYMBOL`.
## InpManageManualPositionsOnly
- `true` = der EA verwaltet nur manuelle Positionen mit `magic = 0`
- false` = der EA kann auch Positionen verwalten, die von einem anderen EA eröffnet wurden, wenn sie die übrigen Filter erfüllen
Empfehlung für die öffentliche Version: lassen Sie diese Option standardmäßig auf `true`.
## InpUseMagicNumberFilter / InpMagicNumberFilter
Optionaler Filter nach magischer Zahl.
Typische Verwendung:
- manuelle Trades: `InpManageManualPositionsOnly = true`, magischer Filter deaktiviert
- spezifischer Roboter: `InpManageManualPositionsOnly = false`, `InpUseMagicNumberFilter = true`, `InpMagicNumberFilter = magische Zahl des Roboters`
## InpAdoptExistingPositionsOnInit
Wenn `true`, übernimmt der EA bereits offene Positionen nach dem Start, wenn sie die Filter bestehen.
## InpSendExistingAdoptionMessages
Wenn `true`, sendet der EA Telegrammnachrichten für Positionen, die bereits vor dem Start des EAs bestanden. Der Standardwert ist `false`, um Nachrichten-Spam nach einem VPS-Neustart oder einer Migration zu vermeiden.
## InpTimerSeconds
Wie oft die Verwaltungsschleife läuft, in Sekunden. Der Standardwert `2` ist ein guter Kompromiss. Die Einstellung `1` wird nicht empfohlen, wenn mehrere Symbole oder Telegram verwendet werden.
## InpDeviationPoints
Maximale Abweichung für Close-Operationen und Handelsanfragen. Sie ist für die normale SL/TP-Verwaltung nicht entscheidend.
---
# 2. Automatische SL/TP-Platzierung
## InpSLTPMode
Legt fest, wie der EA SL/TP berechnet.
### HM_SLTP_NONE
Der EA wird nicht automatisch SL/TP hinzufügen.
Nützlich, wenn Sie BE/Trailing nur für Positionen verwenden möchten, bei denen SL manuell eingegeben wird.
### HM_SLTP_FIXED_POINTS_RR
Einfacher Modus:
- SL = feste Anzahl von Punkten
- TP = SL × RR
Wichtigste Parameter:
- `InpFixedSLPoints`
- InpAddSpreadToFixedSL`
- `InpRewardRiskRatio`
### HM_SLTP_ATR_SPREAD_RR
Empfohlener Standardwert.
Berechnung:
```Text
SL-Abstand = ATR × InpSL_ATR_Multiplikator + Spread × InpSpreadBufferMultiplikator
TP-Abstand = SL-Abstand × InpRewardRiskRatio
```
Wichtigste Parameter:
- `InpATRTimeframe`
- `InpATRPeriode`
- `InpSL_ATR_Multiplikator`
- `InpSpreadBufferMultiplikator`
- `InpRewardRiskRatio`
- `InpMinSLPunkte`
- `InpMaxSLPoints`
### HM_SLTP_SWING_ATR_BUFFER_RR
Erweiterter Modus.
- BUY SL = letztes Schwungtief - ATR-Puffer
- SELL SL = letztes Schwunghoch + ATR-Puffer
- TP = RR × Risiko
Wichtigste Parameter:
- `InpSwingTimeframe`
- InpSchwungRückblickBars
- `InpSchwungStartVerschiebung`
- `InpSwingATRBufferMultiplikator`
- `InpRewardRiskRatio`
## InpPlaceMissingSL / InpPlaceMissingTP
Legt fest, ob der EA fehlende SL und TP hinzufügt.
## InpReplaceExistingSL / InpReplaceExistingTP
Wenn `true`, kann der EA bestehende SL/TP-Werte ersetzen.
Empfehlung: lassen Sie diese Option für normale Benutzer auf `false`, damit der EA manuell eingegebene Levels respektiert.
## InpAutoAdjustToMinStopLevel
Wenn der Broker keine SL/TP zulässt, die zu nahe am aktuellen Kurs liegen, versucht der EA, das Level auf den minimal zulässigen Abstand zu verschieben.
---
# 3. Break-even, Gewinnsperre und Trailing
## InpManagementMode
### HM_MGMT_NONE
Kein Exit-Management.
### HM_MGMT_CONSERVATIVE_BE
Nach Erreichen von `InpBETriggerR` verschiebt der EA den SL zum Einstieg plus einem kleinen Offset.
Beispiel:
``Text
InpBET-AuslöserR = 1.00
InpBEOffsetR = 0,03
```
Nach Erreichen von +1R wird SL auf etwa +0,03R verschoben.
### HM_MGMT_BE_AND_LOCK
Empfohlene Voreinstellung.
Typisches Verhalten:
```Text
0.75R -> SL auf BE + 0.03R
1,20R -> Sperre 0,30R
1,80R -> Sperre 0,80R
```
Parameter:
- `InpBETriggerR`
- `InpBEOffsetR`
- `InpLock1TriggerR`
- `InpLock1R`
- `InpLock2TriggerR`
- `InpLock2R`
### HM_MGMT_ATR_TRAILING
Nach Erreichen von `InpTrailStartR` beginnt der EA mit der SL-Bewegung mittels ATR-Trailing.
Parameter:
- `InpTrailATRTimeframe`
- InpTrailATRPeriode
- `InpTrailStartR`
- `InpTrailATRMultiplikator`
## InpNeverLoosenSL
Sehr wichtiger Schutz. Wenn `true`, wird SL nie auf ein schlechteres Niveau bewegt.
- für BUY-Positionen kann SL nur nach oben gehen
- für SELL-Positionen kann SL nur nach unten verschoben werden
Empfehlung: immer `true` lassen.
## InpMinSecondsBetweenTradeMods
Schutz vor zu häufigen SL/TP-Änderungen. Der Standardwert ist `8` Sekunden.
---
# 4. Tägliche Sicherheitswache
## InpUseDailySafetyGuard
Aktiviert den täglichen Schutz auf Basis des Eigenkapitals.
## InpMaxDailyLossMoney
Tägliches Verlustlimit in festem Geld. `0` = deaktiviert.
## InpMaxDailyLossPercent
Prozentuales tägliches Verlustlimit, berechnet aus dem Eigenkapital zu Beginn des Tages.
## InpSafetyAction
- `HM_SAFETY_ALERT_ONLY` = nur Alarm
- HM_SAFETY_DISABLE_MANAGEMENT` = nach Erreichen des Limits stoppt der EA die Änderung von Positionen
- HM_SAFETY_CLOSE_MANAGED` = versucht, verwaltete Positionen zu schließen
Empfehlung für die erste Version: Behalten Sie die Voreinstellung `ALERT_ONLY` bei. Das Schließen von Positionen ist eine aggressive Funktion und sollte vor dem Live-Einsatz mit dem jeweiligen Broker getestet werden.
---
# 5. Telegramm
Telegram ist optional. Der EA arbeitet normal ohne Telegram.
## Eingaben
- `InpUseTelegram` = aktiviert/deaktiviert Telegram
- `InpTelegramBotToken` = Bot-Token
- `InpTelegramChatId` = Benutzer- oder Gruppen-Chat-ID
- InpTelegramStatusMode` = Detailstufe der Statusmeldung
- InpStatusIntervalMinutes` = regelmäßiges Status-Intervall
- InpSendOpenCloseMessages` = Annahme und Schließung von Nachrichten
- InpSendSLTPModificationMessages` = SL/TP-Platzierungs- und Änderungsmeldungen
- InpSendRiskStatusMessages` = regelmäßige Risiko-/Statusmeldungen
- InpMinSecondsBetweenTelegramMessages` = Mindestabstand zwischen normalen Meldungen
- InpMaxTelegramMessagesPerMinute` = maximale Anzahl von normalen Nachrichten pro Minute
## Anti-Spam-Schutz
Wenn der Benutzer mehrere Trades in kurzer Zeit öffnet oder schließt, sendet der EA möglicherweise nicht jede einzelne Nachricht. Einige Nachrichten können zusammengelegt oder übersprungen werden, und die nächste Nachricht kann den Hinweis enthalten:
```Text
Hinweis: X Benachrichtigung(en) wurde(n) vom Spamschutz zusammengefasst/übersprungen.
```
Dies ist ein beabsichtigter Schutz gegen Telegram-Spam und unnötige WebRequest-Aufrufe.
---
# 6. Was Sie auf dem Diagramm sehen werden
Das Chart-Panel zeigt an:
- aktuelles Symbol
- Geld/Brief
- Spread
- ATR
- ATR/Spanne
- vorgeschlagener BUY SL
- vorgeschlagener SELL SL
- Risiko pro 1 Lot für BUY
- Risiko pro 1 Lot für SELL
- Anzahl und Lotgröße der offenen BUY/SELL-Positionen
- Offener KAUF/VERKAUF Gewinn/Verlust
- täglicher Status der Sicherheitswache
- Modus des Verwaltungsumfangs
---
# 7. Empfohlene Konfigurationen
## Sicherer Standard für ein Symbol
```Text
InpManageScope = HM_SCOPE_CURRENT_SYMBOL
InpManageManualPositionsOnly = true
InpSLTPMode = HM_SLTP_ATR_SPREAD_RR
InpManagementMode = HM_MGMT_BE_AND_LOCK
InpNeverLoosenSL = wahr
InpUseTelegram = false für den ersten Test
```
## Ein Hand Manager für das gesamte Konto
```Text
InpManageScope = HM_SCOPE_ALL_SYMBOLS
InpManageManualPositionsOnly = true
```
Verwenden Sie nur eine EA-Instanz im Modus `ALL_SYMBOLS`. Lassen Sie nicht mehrere Hand-Manager in `ALL_SYMBOLS` laufen, da sie sonst versuchen könnten, die gleichen Positionen zu verwalten.
## Einen anderen Roboter durch eine magische Zahl verwalten
``Text
InpManageManualPositionsOnly = false
InpUseMagicNumberFilter = true
InpMagicNumberFilter = die ausgewählte magische Zahl
```
# Telegramm-Setup für Universal Smart Manual Trade Manager MT5
## Was Sie brauchen
1. Ein Telegram-Konto.
2. Einen erstellten Telegram-Bot.
3. Bot-Token.
4. Chat-ID.
5. WebRequest aktiviert in MT5.
## 1. Einen Telegram-Bot erstellen
1. Suchen Sie in Telegram nach `@BotFather`.
2. Sende den Befehl `/newbot`.
3. Geben Sie einen Bot-Namen ein, zum Beispiel `My Trade Manager Bot`.
4. Geben Sie einen Bot-Benutzernamen ein. Er muss mit "Bot" enden, z. B. "Mein_Handelsmanager_123_bot".
5. BotFather sendet Ihnen ein Token ähnlich wie folgt:
``Text
1234567890:ABCdefGhIJKlmNoPQRstuVWxyz
```
Fügen Sie dieses Token in die EA-Eingabe ein:
```Text
InpTelegramBotToken
```
## 2. Erhalte deine Chat ID
Die einfachste Methode:
1. Öffnen Sie Ihren neuen Bot in Telegram.
2. Klicken Sie auf `Start` oder senden Sie ihm eine Nachricht, zum Beispiel `test`.
3. Öffne diese Adresse in deinem Browser:
``Text
```
4. Suchen Sie in der Antwort das `chat` Objekt und seinen `id` Wert.
5. Fügen Sie diese Nummer in die EA-Eingabe ein:
```Text
InpTelegramChatId
```
Hinweis: Gruppenchat-IDs können negative Zahlen sein. Das ist normal.
## 3. Aktivieren Sie WebRequest in MT5
MT5 muss die Telegram API URL zulassen:
1. Öffnen Sie `Tools`.
2. Wählen Sie `Optionen`.
3. Öffnen Sie die Registerkarte "Expertenberater".
4. Markieren Sie "WebRequest für aufgelistete URL zulassen".
5. Fügen Sie genau diese Adresse hinzu:
``Text
```
Ohne diesen Schritt wird der EA einen WebRequest-Fehler im MT5 Journal melden.
## 4. Aktivieren Sie Telegram in dem EA
Setzen Sie diese EA-Eingaben:
```text
InpUseTelegram = wahr
InpTelegramBotToken = Token von BotFather
InpTelegramChatId = Ihre Chat-ID
InpStatusIntervallMinuten = 10
InpSendOpenCloseMessages = wahr
InpSendSLTPModificationMessages = wahr
InpSendRiskStatusMessages = wahr
```
## 5. Empfohlene Anti-Spam-Einstellungen
```Text
InpMinSecondsBetweenTelegramMessages = 20
InpMaxTelegramMessagesPerMinute = 3
```
Wenn der Benutzer mehrere Trades kurz hintereinander eröffnet, überspringt der EA möglicherweise einige Nachrichten oder führt sie zusammen. Dies ist ein korrektes Verhalten und dient dem Schutz vor Spam.
Empfohlener Text für die Produktdokumentation:
```Text
Telegram-Benachrichtigungen enthalten einen Anti-Spam-Schutz. Wenn mehrere Geschäfte innerhalb kurzer Zeit geöffnet, geändert oder geschlossen werden, können einige einzelne Benachrichtigungen zusammengeführt oder übersprungen und in einer späteren Nachricht zusammengefasst werden.
```
## 6. Telegramm testen
Nachdem der EA aktiviert ist, sollten Sie eine Nachricht erhalten:
```Text
Smart Manual Trade Manager gestartet
```
Wenn die Nachricht nicht ankommt:
1. Überprüfen Sie das Bot-Token.
2. Prüfen Sie die Chat-ID.
3. Vergewissern Sie sich, dass Sie mindestens eine Nachricht an den Bot gesendet haben.
4. Prüfen Sie, ob die WebRequest-URL in MT5 zulässig ist.
5. Überprüfen Sie die Registerkarten "Experten" und "Journal" in MT5.
## Sicherheitshinweis
Das Telegram-Bot-Token ist sensibel. Veröffentlichen Sie es nicht in Screenshots, Videos, Produktkommentaren oder öffentlichen Supportnachrichten. Wenn das Token offengelegt wird, regenerieren Sie es in BotFather und aktualisieren Sie die EA-Eingaben.
# Einsatz von Universal Smart Manual Trade Manager MT5 auf MT5 VPS
## Grundprinzip
MT5 VPS migriert die aktuelle lokale Terminalumgebung auf die virtuelle Plattform: offene Charts, angehängte Expert Advisors, Indikatoren und deren Eingabeparameter. Daher ist es wichtig, vor der Migration alle Charts lokal genau so vorzubereiten, wie sie auf dem VPS laufen sollen.
## Hinzufügen des Hand Managers neben dem Haupthandelsroboter
Wenn ein Haupthandelsroboter bereits auf dem VPS unter einem Symbol wie UKOIL laufen soll und Sie den Hand Manager hinzufügen möchten, bereiten Sie ihn lokal wie folgt vor:
1. Öffnen Sie den ursprünglichen UKOIL-Chart mit dem Haupthandels-EA.
2. Öffnen Sie einen zweiten Chart für dasselbe Symbol, UKOIL.
3. Hängen Sie "Universal Smart Manual Trade Manager MT5" an das zweite Diagramm an.
4. Behalten Sie die Standardeinstellung des Safe Hand Managers bei:
```Text
InpManageScope = HM_SCOPE_CURRENT_SYMBOL
InpManageManualPositionsOnly = true
```
5. Bestätigen Sie, dass beide Charts laufen:
- Chart 1: Haupt-Handels-EA
- Diagramm 2: Hand Manager
6. Führen Sie eine neue Migration/Synchronisation auf MT5 VPS durch.
7. Überprüfen Sie das VPS Journal und stellen Sie sicher, dass beide Expert Advisors laufen.
## Wichtige Warnung
Bei einer neuen Migration wird nicht einfach ein neuer Chart zu dem hinzugefügt, was bereits auf dem VPS läuft. Sie überträgt die aktuelle lokale Terminalumgebung. Daher müssen während der Migration alle Charts und EAs, die auf dem VPS bleiben sollen, lokal geöffnet sein.
Wenn Sie nur den Hand Manager-Chart lokal geöffnet lassen und die Migration durchführen, kann es passieren, dass Sie versehentlich die VPS-Umgebung ohne den ursprünglichen Haupthandelsroboter überschreiben.
## Ein Symbol
Für ein Symbol ist die empfohlene Einstellung:
```Text
Chart 1: Symbol + Haupthandelsroboter
Chart 2: dasselbe Symbol + Hand Manager
```
Im Modus `CURRENT_SYMBOL` verwaltet der Hand Manager nur manuelle Positionen auf seinem Chartsymbol.
## Mehrere Symbole: Öl und Gold
Frage: Wenn ein Benutzer zwei Charts auf dem VPS hat, z.B. Öl und Gold, verwaltet der Hand Manager dann manuelle Trades für beide?
Die Antwort hängt von `InpManageScope` ab.
### Option A: sicher und für die meisten Benutzer empfohlen
Verwenden Sie eine Hand Manager-Instanz pro Symbol.
Beispiel:
``Text
Chart 1: UKOIL + Haupt-EA oder manueller Handel
Chart 2: UKOIL + Hand Manager, InpManageScope = CURRENT_SYMBOL
Chart 3: XAUUSD + Haupt-EA oder manueller Handel
Schaubild 4: XAUUSD + Hand Manager, InpManageScope = CURRENT_SYMBOL
```
In diesem Modus:
- Hand Manager auf UKOIL verwaltet nur UKOIL.
- Hand Manager auf XAUUSD verwaltet nur XAUUSD.
- Das Setup ist klar und sicher.
### Option B: eine Instanz für das gesamte Konto
Verwenden Sie eine Hand Manager-Instanz mit:
```Text
InpManageScope = HM_SCOPE_ALL_SYMBOLS
```
In diesem Modus kann ein Hand Manager manuelle Positionen für alle Kontosymbole verwalten, zum Beispiel UKOIL und XAUUSD.
Wichtige Regel:
```Text
Führen Sie nur eine Hand Manager Instanz im ALL_SYMBOLS Modus aus.
```
Wenn zwei Hand Manager Instanzen auf dem VPS laufen und beide auf `ALL_SYMBOLS` eingestellt sind, könnten sie versuchen, dieselben Positionen zu verwalten, doppelte Nachrichten zu senden und unnötige SL/TP Änderungen durchzuführen.
## Empfohlener Text für die Produktdokumentation
``Text
Der Standardmodus verwaltet nur das aktuelle Diagrammsymbol. Um mehrere Symbole zu verwalten, fügen Sie eine Hand-Manager-Instanz zu jedem Symbol-Diagramm hinzu. Fortgeschrittene Benutzer können den ALL_SYMBOLS Modus verwenden, aber es sollte nur eine ALL_SYMBOLS Instanz auf dem Konto laufen.
```
## Checkliste nach der VPS-Migration
Prüfen Sie nach der Migration:
1. VPS-Journal.
2. Anzahl der Diagramme.
3. Anzahl der laufenden Expert Advisors.
4. Ob der Algo-Handel aktiviert ist.
5. Ob Telegram die Startnachricht gesendet hat, wenn Telegram aktiviert ist.
6. Ob das Chart-Panel vor der Migration lokal keine Fehler angezeigt hat.
## Telegram auf VPS
Die WebRequest-Einstellungen müssen vor der Migration lokal vorbereitet werden. Die Liste der erlaubten URLs muss enthalten:
```Text
https://api.telegram.org
```
Führen Sie nach der Änderung der Telegrammeingänge oder der WebRequest-Einstellungen eine neue Migration auf VPS durch.
## Praktische Empfehlung
Für Anfänger und regelmäßige Benutzer sollten Sie den Modus `CURRENT_SYMBOL` verwenden und einen Hand Manager mit jedem Symbolchart verbinden. Verwenden Sie `ALL_SYMBOLS` nur, wenn der Benutzer versteht, dass eine EA-Instanz alle manuellen Positionen auf dem Konto verwalten wird.
