Kafra TradeSync Tool 1.00 - Documentation

Inputs Settings Overview

This section explains all input settings available in the EA.

Variable	Description
TelegramUsername (string)	The Telegram username used for license validation (entered manually). Format: @username or just username.
Entry_Mode (enum)	Order entry mode: Instant → Market execution. Limit → Pending limit orders. Auto → EA decides automatically. Default: Auto
LotSize (double)	Fixed lot size (if auto lot is disabled). Example: 0.01. Default: 0.1
UseAutoLot (bool)	true → EA calculates lot size based on risk.false → Uses Manual lot size. Default: true
RiskPercentage (double)	Risk percentage for auto lot calculation. Example: 0.5 (0.5% risk per trade). Default: 1.0
TPLevel (enum)	Take profit level selection: TP_Level1 → Default TP1.TP_Level2 → TP2.TP_Level3 → TP3. Default: TP_Level1
UseBreakEven (bool)	true → Enables breakeven feature.false → Disables it. Default: false
BreakEvenStop (int)	Number of points profit before moving SL to breakeven. Example: 100 points. Default: 80
BreakEvenStep (int)	Number of points beyond entry for breakeven SL. Example: 30 points. Default: 20
UseTrailing (bool)	true → Enables trailing stop.false → Disables it. Default: false
TrailingStopPoint (double)	Distance (in points) from current price where SL should trail. Example: 200.0. Default: 150
TrailingStep (double)	Minimum movement (in points) required before adjusting SL. Example: 100.0. Default: 50
DeleteTime (enum)	Time to delete pending orders: Options: None, 5 min, 10 min, 15 min, 30 min, 1 hr, 3 hr, 6 hr, 9 hr, 12 hr, 24 hr. Default: None
MAGIC_NUMBER (int)	Unique identifier for trades placed by this EA (prevents interference with manual trades). Default: 2024
SymbolSuffix (string)	Suffix for symbols (if broker uses them). Example: "b", ".", ".h". Default: ""

Trailing Stop Logic

Trailing Stop allows the stop-loss (SL) to move dynamically as the trade becomes profitable.

📌 How It Works

• EA checks if UseTrailing = true.

• For each open position:

  • If price moves past TrailingStopPoint, EA moves SL closer to price.

  • SL moves in steps (TrailingStep) and does not decrease.

• EA respects broker's stop-level requirements (minimum SL distance).

• EA handles invalid SL errors (error 4756/130) by adjusting stops dynamically.

📌 Example

• TrailingStopPoint = 200, TrailingStep = 100

• Buy order at 1.1000.

• If price reaches 1.1200, SL moves to 1.1100.

• If price reaches 1.1300, SL moves to 1.1200.

• If price falls, SL does not move back.

---

Break Even Logic

Breakeven moves stop-loss to entry price when a trade is in profit by BreakEvenStop points.

📌 How It Works

• EA checks if UseBreakEven = true.

• For each open position:

  • If price moves past BreakEvenStop, SL moves to entry + BreakEvenStep.

  • SL never moves backward (only forward).

• Ensures SL meets broker’s stop-level distance.

• If broker rejects SL update, EA adjusts accordingly.

📌 Example

• BreakEvenStop = 100, BreakEvenStep = 30

• Buy order at 1.1000.

• If price reaches 1.1100, SL moves to 1.1030.

• If price falls below 1.1030, trade is closed at breakeven profit.

---

Example Usage

Scenario 1: Fixed Lot with Trailing Stop

• Settings:

  • UseAutoLot = false

  • LotSize = 0.1

  • UseTrailing = true

  • TrailingStopPoint = 150

  • TrailingStep = 50

• Result:

  • EA places fixed 0.1 lot trades.

  • SL follows price in 50-point steps after 150 points of movement.

Scenario 2: Auto Lot with Breakeven

• Settings:

  • UseAutoLot = true

  • RiskPercentage = 1.0

  • UseBreakEven = true

  • BreakEvenStop = 80

  • BreakEvenStep = 20

• Result:

  • EA calculates lot size based on 1% risk.

  • If price moves 80 points in profit, SL moves to entry + 20 points.

---

Security & Authentication

License Verification Process

• The user must manually enter TelegramUsername in the MT5 settings.

• MT5 EA sends:

  • Account Name (from broker)

  • Broker Name (from broker)

  • Telegram Username (manual input)

• Server validates against the database:

  • Account Name must match the database.

  • Telegram Username must match the database.

  • Broker Name must be authorized (unless non_restricted_verified = true).

• EA is activated only if all conditions pass.

---

FAQs & Troubleshooting

Common Questions

• Q1: What happens if I disable Auto Lot?

  • The EA will use the fixed lot size (LotSize) instead of risk-based lot sizing.

• Q2: Does the EA support symbols with suffixes?

  • Yes! Set SymbolSuffix if your broker uses "b", ".", ".h" etc.

• Q3: Can I use both Trailing Stop & Break Even?

  • Yes! Breakeven moves SL first, then Trailing Stop continues to follow price.

• Q4: What happens if my broker has a stop level?

  • The EA checks and adjusts SL distance automatically to meet broker requirements.

• Q5: Can I use multiple broker accounts?

  • Yes, if your license allows multiple brokers. Otherwise, your broker must be one of our selected brokers.