Vyl Trade Manager

# Vyl Trade Manager — Full Documentation

## 🎯 Short Description (for the Market product card)

Vyl Trade Manager is a professional trading panel for MetaTrader 4 that automates risk-based position-size calculation and gives you instant access to all the trade-management tools you need.

Forget manual calculations and complex formulas — one click to open a trade with the correct lot size, instant move-to-breakeven, partial profit-taking, and Stop Loss/Take Profit management right from the chart.

**Ideal for:**
- Traders who value their time
- Beginners who want to manage risk correctly
- Professionals who need fast execution

## ✨ Key Features

**📈 Risk Management**
- Automatic lot-size calculation based on % risk of balance
- On-the-fly risk adjustment with +/- buttons (0.1% to 100%)
- Color-coded risk indicator: green (safe), yellow (moderate), red (high)

**⚡ Fast Trading**
- BUY/SELL buttons with automatic SL and TP placement
- Close all positions in one click
- Partial close (50% of position) to lock in profit

**🛡️ Position Management**
- Breakeven — moves SL to entry price + a few points
- Adjust SL/TP directly on the panel with +/- buttons (5-point step)
- Real-time P/L monitoring with color indication

**📊 Account Information**
- Real-time balance and equity
- Current spread
- Number of open orders
- Total profit/loss across positions

## 🔧 Installation

**Step 1: Download**
After purchase on MQL5 Market, you'll receive the file `VylTradeManager_Pro.ex4`.

**Step 2: Install in MetaTrader 4**
1. Open MetaTrader 4
2. Go to File → Open Data Folder (or press Ctrl+Shift+D)
3. Open the MQL4 → Experts folder
4. Copy `VylTradeManager_Pro.ex4` into this folder
5. Restart MetaTrader 4 (or press F5 in the Navigator window)

**Step 3: Add to Chart**
1. Open the chart you want (e.g., EURUSD)
2. In the Navigator window (Ctrl+N), find VylTradeManager_Pro under "Expert Advisors"
3. Drag it onto the chart
4. In the settings window that appears:
   - ✅ Enable "Allow live trading"
   - ✅ Enable "Allow DLL imports" (if required)
   - Click OK

**Step 4: Verify It's Running**
The panel should appear in the top-left corner of the chart. If it's not visible:
- Check that "AutoTrading" is enabled in the top MT4 toolbar
- Make sure the EA is attached to the active chart

## ⚙️ Settings

On first launch you can configure panel settings and risk settings.

💡 **Tip:** You can change these settings at any time through the EA's properties (right-click the EA → "Properties").

## 📖 User Guide

**1. Position Size (Lot) Calculation**

How it works: the panel automatically calculates the optimal lot size based on your balance, the risk percentage you've set, the Stop Loss distance in points, and the pip value for the current instrument.

Example:
- Balance: $10,000
- Risk: 1%
- Stop Loss: 50 points
- Result: Calc. Lot = 0.20

This means that if the Stop Loss is hit, you'll lose exactly 1% of your balance ($100).

Adjusting risk:
- Press "+" — increase risk by 0.1%
- Press "-" — decrease risk by 0.1%
- Press "Reset Risk" — return to the default value

Risk color coding:
- 🟢 Green (0.1%–1.0%) — conservative, safe risk
- 🟡 Yellow (1.1%–3.0%) — moderate risk
- 🔴 Red (3.1%+) — aggressive risk (be careful!)

**2. Opening Positions**

Opening a BUY:
1. Set your desired risk (e.g., 1%)
2. Set the Stop Loss (e.g., 50 points)
3. Set the Take Profit (e.g., 100 points)
4. Press the "BUY" button

The position opens with the calculated lot size, an SL 50 points from entry, and a TP 100 points from entry.

Opening a SELL: Same process, but press "SELL" instead.

**Important:** Make sure "AutoTrading" is enabled in the top MT4 toolbar, or orders won't open.

**3. Managing Stop Loss and Take Profit**

Adjusting SL:
- Press "-5" — decrease Stop Loss by 5 points
- Press "+5" — increase Stop Loss by 5 points

Adjusting TP:
- Press "-5" — decrease Take Profit by 5 points
- Press "+5" — increase Take Profit by 5 points

💡 **Tip:** These changes only affect new positions. To modify SL/TP on existing positions, use the Breakeven function or modify the order manually.

**4. Breakeven Function**

What it does: moves the Stop Loss of all open positions to the entry price plus a few points (default: +5 points).

When to use it: when a position is already in profit and you want to lock in a minimal gain, or when you want to remove risk from the trade while keeping upside potential.

How to use it:
1. Open a position (e.g., BUY)
2. Wait for the price to move in your favor
3. Press "BREAKEVEN"
4. The Stop Loss moves to: entry price + 5 points

Example:
- You opened a BUY at 1.1000 with SL at 1.0950
- Price rose to 1.1050
- You pressed BREAKEVEN
- New SL: 1.1005 (entry + 5 points)
- Now even if price reverses, you stay up 5 points

**5. Partial Close (Close 50%)**

What it does: closes half the volume of all open positions.

When to use it: when a position is in good profit and you want to lock in part of it, or when you want to reduce risk while leaving part of the position to run.

How to use it:
1. Open a position (e.g., 0.20 lots)
2. When the position is in profit, press "CLOSE 50%"
3. Half the position (0.10 lots) closes at the current price
4. The other half (0.10 lots) stays open

💡 **Tip:** After a partial close, you can move the remaining position's Stop Loss to breakeven with the BREAKEVEN button.

**6. Close All Positions**

What it does: closes all open positions with magic number 12345 on the current instrument.

When to use it: on a sharp market reversal, when you need to exit everything quickly, or ahead of major news.

How to use it: simply press "CLOSE ALL".

⚠️ **Important:** Only positions opened through this panel (magic number 12345) are closed. Positions opened manually or by other EAs are not affected.

**7. P/L (Profit/Loss) Monitoring**

What it shows: total profit or loss across all open positions, including profit, swap, and commission.

Color coding:
- 🟢 Green — you're in profit
- 🔴 Red — you're at a loss
- ⚪ White — breakeven

Example:
- P/L: +$150.50 (green) — you've made $150.50
- P/L: -$75.30 (red) — you've lost $75.30

## 📋 Usage Examples

**Example 1: Conservative Trading**
Scenario: You trade EURUSD with a $5,000 balance and want to risk no more than 1% per trade.
1. Set risk to 1.0% (green)
2. Set SL to 30 points (for intraday trading)
3. Set TP to 60 points (1:2 risk/reward)
4. Panel shows: Calc. Lot = 0.17
5. Press BUY or SELL
6. At +20 points, press BREAKEVEN
7. At +40 points, press CLOSE 50%
8. Manage the remaining position to TP or close manually

Result: you've locked in part of the profit and removed risk from the trade.

**Example 2: Aggressive News Trading**
Scenario: A major news release is coming (NFP), and you want to catch the move.
1. Increase risk to 3.0% (yellow)
2. Set SL to 100 points (wide stop for volatility)
3. Set TP to 200 points
4. Panel shows: Calc. Lot = 0.15
5. Wait for the news, then press BUY or SELL
6. If the trade goes your way, quickly press BREAKEVEN
7. If it goes against you, press CLOSE ALL to exit fast

⚠️ **Warning:** News trading is very risky! Only use funds you can afford to lose.

**Example 3: Scalping**
Scenario: fast trades on small timeframes (M1, M5).
1. Set risk to 0.5% (conservative for frequent trades)
2. Set SL to 10 points
3. Set TP to 15 points
4. Panel shows: Calc. Lot = 0.50
5. Open positions on your signal
6. At +5 points, press BREAKEVEN
7. At +10 points, press CLOSE 50%
8. Close the remainder manually or wait for TP

## ❓ Frequently Asked Questions (FAQ)

**Q: Why aren't my trades opening?**
A: Make sure that "AutoTrading" is enabled in the top MT4 toolbar, "Allow live trading" is enabled in the EA's settings, there are sufficient funds in the account, and the market is open (not the weekend).

**Q: How do I change the magic number?**
A: In the current version, the magic number is fixed at 12345. This ensures the panel only manages its own positions. If you need it changed, contact the developer.

**Q: Can I use the panel on multiple charts?**
A: Yes, but each panel operates independently with its own settings. Make sure AutoTrading is enabled on each chart.

**Q: Why is the lot always the minimum (0.01)?**
A: This happens if the risk is too small (e.g., 0.1% with a large balance and a small SL) or the Stop Loss is too large. Check the formula: Risk ($) / (SL in points × point value) = lot.

**Q: How do I remove the panel from the chart?**
A: Right-click the chart → "Object List" → find objects with the "PTM_" prefix → delete them. Or simply remove the EA from the chart (right-click the EA → "Remove").

**Q: Does the panel work on a demo account?**
A: Yes, the panel is fully functional on a demo account. It's a great way to test all the features before trading live.

**Q: Can I change the SL/TP step (currently 5 points)?**
A: In the current version, the step is fixed at 5 points. If you need a different step, contact the developer for customization.

**Q: Why doesn't P/L update instantly?**
A: The panel refreshes data every 500 milliseconds (twice per second). This is the optimal balance between data freshness and load on the terminal.

## 🔒 Safety and Limitations

**✅ What the panel does:**
- Opens positions with the calculated lot size
- Modifies Stop Loss and Take Profit
- Closes positions fully or partially
- Displays account information

**What the panel does NOT do:**
- Does not trade automatically (only on your click)
- Does not modify positions opened by other EAs or manually
- Does not connect to external servers
- Does not collect or transmit your data

**⚠️ Important warnings:**
- Forex trading carries a high risk of loss.
- Always test the panel on a demo account before using it live.
- Never risk money you can't afford to lose.
- Past performance does not guarantee future results.

## 📞 Support

If you have questions or run into issues:
1. Check the FAQ section above — the answer may already be there
2. Check the "Experts" tab in the MT4 terminal for error messages
3. Contact the developer through the seller profile on MQL5 Market

## Technical Requirements

- **Platform:** MetaTrader 4 (build 600+)
- **Operating System:** Windows 7/8/10/11
- **Minimum screen resolution:** 1280×720
- **Required:** AutoTrading enabled in the terminal

## 🎓 Tips for Effective Use

1. Start on a demo account — test all features risk-free
2. Use conservative risk (0.5–1%) at the beginning
3. Always set a Stop Loss — never trade without protection
4. Use Breakeven — it's the key to risk-free trading
5. Partial close is a great way to reduce stress and lock in profit
6. Don't change settings during heavy volatility — it can lead to errors
7. Regularly check the logs in the "Experts" tab to monitor the panel's activity

## 📝 Version History

Current version: 3.00 (Pro)

- v1.00 — Basic panel with lot calculation
- v2.00 — Added Buy/Sell/Close All buttons
- v2.10 — Fixed lot calculation for different risk values
- v2.20 — Added risk-adjustment buttons on the panel
- v3.00 — Pro version: Breakeven, Close 50%, SL/TP adjustment, P/L monitoring

© 2026 Vyl Trade Manager. All rights reserved.