Documentation

Welcome to the JasmineFX documentation. This guide covers everything you need to set up, configure, and run your automated trading bot.

1. Getting Started

1.1 System Requirements

• Operating System: Windows 10 (21H2+) or Windows 11 — 64-bit only
• MetaTrader 5: Build 3800+ installed and running
• RAM: 4 GB minimum (8 GB recommended)
• Disk Space: 100 MB free
• Internet: Required for license validation, AI sentiment & Telegram alerts
• .NET Runtime: .NET 8.0 Desktop Runtime (included)

1.2 Sign Up & Get License

1. Go to Sign Up and create your account.
2. Verify your email address (check your inbox).
3. After verification, a 3-day free trial license is automatically generated.
4. Go to My Account → License tab to see your license key.
5. Copy the license key — you'll need it to activate the bot.

1.3 Configure MetaTrader 5

Before running the bot, you must enable automated trading in MT5:

1. Open MetaTrader 5 and log into your trading account.
2. Go to Tools → Options (or press Ctrl+O).
3. Click the Expert Advisors tab.
4. Check ☑ Allow Automated Trading.
5. Check ☑ Allow DLL imports (required for JasmineFX bot connection).
6. Click OK to save.
7. On the main toolbar, make sure the Algo Trading button is enabled (green play icon ▶). If it's red, click it to enable.

1.4 Download & Run the Bot

1. Go to My Account → Download tab.
2. Click Download JasmineFX.exe.
3. Run the .exe file — no installation required.
4. Enter your license key on first launch.
5. Make sure MetaTrader 5 is open with your charts visible.

2. Web Dashboard Settings

All bot settings are managed from your web dashboard — no configuration needed in the bot itself. Just start and stop.

2.1 Select Trading Pairs

Go to My Account → Pairs tab. Choose which pairs the bot should trade. The bot supports 31 instruments across forex majors, minors, commodities (Gold, Silver), and indices (US30, NAS100, US500). Only checked pairs will be analyzed and traded.

2.2 Telegram Notifications

Go to My Account → Telegram tab. Enter your Telegram Chat ID to receive real-time alerts:

• Entry notifications: Full trade details with Layer 1/2 trigger breakdown
• TP/SL hits: Exit price, duration, commission + swap breakdown
• Daily summary: PnL, win rate, best/worst trade at 21:00 UTC
• Drawdown warnings: Tiered alerts at 5%, 10%, and 13% DD
• Recovery mode: Alert when bot enters defensive mode after consecutive losses

To get your Chat ID: Open Telegram → search @userinfobot → send /start → copy the numeric ID.

3. How the Bot Works

3.1 AI Decision Engine

JasmineFX uses a KISS 2-Layer decision hierarchy:

• Layer 1 — Macro Bias Filter: AI sentiment score + SMA(20/50) cross determines BUY/SELL direction. If AI is unreachable, falls back to SMA 200 H1 + ADX.
• Layer 2 — Execution Trigger: Requires 2 of 4 triggers: H1 Support/Resistance proximity, ATR volatility check, RSI momentum, and Volume Bar-1 breakout. This prevents overtrading and only executes high-confidence setups.

3.2 News Filter

The bot integrates with ForexFactory economic calendar to block trading during high-impact news events. Trading is paused ±15 minutes around releases like NFP, CPI, FOMC, and GDP. The filter includes DST-aware timezone conversion (ET→GMT+3) and an emergency halt failsafe.

3.3 Risk Management

• Risk per trade: 1.5% of balance (Kelly-optimal)
• Stop Loss / Take Profit: Dynamic, based on ATR(14) volatility
• Partial TP: 3 levels — 50% at TP1, 30% at TP2, 20% at TP3
• Daily loss limit: 5% of balance — auto-stop trading
• Max drawdown: 15% — auto-close all positions
• Recovery mode: After 3 consecutive losses, bot reduces lot size by 50% and raises confidence threshold
• Anti-stacking: Prevents duplicate positions on the same symbol

3.4 Correlation Filter

The bot checks all open MT5 positions before entering a new trade. If a new trade would create over-exposure (same direction on positively correlated pairs) or double-bet USD (opposite direction on negatively correlated pairs), the trade is blocked.

4. Dashboard & Monitoring

Your trading data syncs to the web dashboard in real-time. View:

• Balance, equity, and daily P&L
• Active positions and trade history
• Win rate, profit factor, and expectancy
• AI sentiment history with reasoning
• Bot connection status and heartbeat

5. Troubleshooting

Bot won't connect?

• Make sure MetaTrader 5 is running with at least one chart open.
• Check your internet connection — license validation requires internet.
• Verify your license key in My Account → License tab.
• If the license is expired, renew from the License tab.

Not receiving Telegram alerts?

• Check My Account → Telegram tab — is your Chat ID saved?
• Make sure you've started a chat with the JasmineFX bot on Telegram.
• Verify the Chat ID is numeric (e.g., 123456789).

Bot not trading?

• Check My Account → Pairs tab — are your desired pairs enabled?
• The news filter may be blocking trades during high-impact events (check economic calendar).
• Recovery mode may be active after consecutive losses — bot trades with reduced size.
• Daily trade limit or daily loss limit may have been reached.

6. License & Billing

• Free Trial: 3 days, full access, no credit card required.
• Subscription: $30/month (Launch Promo: $15/month until Aug 31, 2026).
• One license = one active PC. Using the same key on multiple PCs will be blocked.
• Renew from My Account → License tab. All sales final, no refunds.

7. Supported Instruments

The bot supports 31 instruments across 4 categories:

Category	Pairs
Forex Majors (7)	EURUSD, GBPUSD, USDJPY, AUDUSD, NZDUSD, USDCAD, USDCHF
Forex Minors (20)	EURGBP, EURJPY, EURCHF, EURAUD, EURNZD, EURCAD, GBPJPY, GBPCHF, GBPAUD, GBPNZD, GBPCAD, AUDJPY, AUDCHF, AUDNZD, AUDCAD, NZDJPY, NZDCAD, CADJPY, CADCHF, CHFJPY
Commodities (2)	XAUUSD (Gold), XAGUSD (Silver)
Indices (3)	US30 (Dow Jones), NAS100 (Nasdaq), US500 (S&P 500)

8. Contact Support

Need help? Contact us or email support@jasminefxbot.com.