Documentation

The EA needs permission to communicate with the server. Without this, all remote features are disabled.

Your dashboard connects to your EA using a unique secret token. This token is generated when you register.

Once connected, the dashboard polls the server every 5 seconds and displays live data from your EA.

Falcon AI works as a Progressive Web App — installable on any phone or tablet without an app store.

On Android (Chrome):

1. Open the dashboard URL in Chrome.
2. Tap the three-dot menu → "Add to Home screen" or "Install app".
3. The app appears on your home screen with its own icon.

On iPhone (Safari):

1. Open the dashboard URL in Safari.
2. Tap the Share button (square with arrow) → "Add to Home Screen".
3. Tap "Add". The app launches in full-screen mode.

MT5 has a global AutoTrading switch. If it's off, no EA can place trades — including Falcon AI.

These two settings are required for the EA to function:

• RC_SecretToken — Your unique account token. This isolates your data from all other users.
• RC_EndpointURL — The Google Apps Script web app URL. This is where the EA sends/receives data.

Falcon AI includes multiple risk protection layers. Key settings:

• MaxDrawdownPercent — Maximum allowed drawdown before EA stops trading (default: 5%)
• RiskPerTrade — Percentage of equity risked per trade (default: 1%)
• MaxOpenPositions — Maximum simultaneous open positions
• UseFixedLot — If true, ignores dynamic sizing and uses a fixed lot
• FixedLotSize — The fixed lot size when UseFixedLot is true

Falcon AI can trade multiple symbols simultaneously. Symbols are managed from the dashboard, but you can also pre-configure them in the EA inputs:

• TradedSymbols — Comma-separated list (e.g., "XAUUSD,EURUSD,GBPJPY")
• Each symbol can be individually paused, resumed, or disabled from the dashboard
• Per-symbol statistics (wins, losses, P&L) are tracked separately

The EA normalizes symbol names (adds broker suffixes automatically if needed).

The Daily Target System automatically stops trading when your profit goal is reached for the day.

• DailyTargetPercent — Target as a % of starting balance (e.g., 2.0 = 2%)
• DTS_Enabled — Enable/disable the daily target system
• When target is hit, no new trades are opened until the next trading day
• Admin can override the target remotely from the dashboard

The AI engine learns from trading outcomes and adapts its strategy. Key settings:

• AI_Enabled — Master switch for the AI decision layer
• AI_LearningRate — How fast the AI adapts (lower = more conservative)
• AI_MinTradesForAdapt — Minimum trades before AI starts adjusting strategy
• AI_FreezeOnDrawdown — Pause AI learning during drawdown periods

The dashboard shows a real-time AI Health Score (0-100) and cognitive state (Learning, Adapting, Innovating).

Falcon AI validates your license on startup. The EA sends your MT5 account number and broker server to the license registry.

• License is tied to your specific MT5 account (server + login pair)
• Free trial: 7 days full access, starts automatically on registration
• Paid subscription: validated on each EA startup and periodically during operation
• If license is invalid or expired, the EA disables new trade entries (existing positions are never touched)

The dashboard gives you full control over your EA from anywhere:

• EA Enabled toggle — master on/off for all trading
• Allow New Entries toggle — controls whether new positions can be opened
• Emergency Stop button — immediately disables all trading (panic button)

Changes are sent to the server instantly and the EA picks them up within 5 seconds (next poll cycle).

Each trading symbol appears as a card in the dashboard. You can individually:

• Enable — symbol actively traded
• Pause — no new entries, but existing positions managed normally
• Disable — completely excluded from trading
• Remove — delete from the dashboard (double-tap to confirm)

You can also add new symbols using the input field at the bottom of the symbols card.

The top bar shows your connection health:

• ● CONNECTED — Dashboard ↔ Server communication is working
• ● LOADING — Connecting or waiting for response
• ● DISCONNECTED — Cannot reach the server

The EA Offline banner appears when the server hasn't received a poll from your EA in over 30 seconds. This usually means MT5 is closed, your VPS is down, or WebRequest is not enabled.

Signal bars (1-4) indicate poll freshness: 4 bars = polled within 5s, 1 bar = 20+ seconds ago.

The built-in chat connects you directly with the admin team. Features:

• Send text messages (up to 2000 characters)
• Attach files and images (stored securely per-account)
• Receive admin broadcasts and announcements
• Chat history is preserved across sessions and devices
• Email notifications when you receive a new message

The dashboard displays real-time account metrics reported by your EA:

• Balance — current account balance
• Equity — balance + unrealized P&L
• Open Positions — number of active trades
• Floating P&L — unrealized profit/loss
• Today's Wins / Losses — closed trade count for the day
• Win Rate — percentage of profitable trades today

These values update every 5 seconds when the EA is online.

The Daily Target System (DTS) calculates your profit as a percentage of your starting balance for the day. When the target is reached:

1. EA automatically stops opening new positions
2. Dashboard shows "🎯 TARGET HIT" banner
3. Existing positions continue to be managed (SL/TP)
4. Trading resumes automatically the next day

The progress bar shows real-time percentage toward your target. Admin can set or override your target remotely.

The AI Health card shows how well the algorithm is performing:

• Health Score (0-100): Above 70 = good, 40-70 = needs attention, below 40 = degraded
• Cognitive State:
  • Learning — gathering data, conservative mode
  • Adapting — adjusting strategy based on patterns
  • Innovating — testing new approaches
• Adaptation Rate — how quickly the AI is changing strategy
• Innovation Rate — how much new behavior is being explored

If the AI is "frozen" (shown in red), it means learning has been paused — usually due to drawdown protection.

Admins can remotely spawn a new chart+EA instance from the dashboard. This creates a new chart window on your MT5 terminal with Falcon AI already attached.

This feature requires a dedicated "Spawner EA" to be running on a blank chart. It monitors the spawn mailbox and creates charts when requested.

Multiple protection layers can prevent trading:

• Admin Lock — set by the platform owner, freezes all new entries. Cannot be overridden by the customer.
• Local Lock — EA self-locks when it detects critical errors (e.g., license failure, tamper detection)
• Veto — per-symbol override that blocks entries for a specific pair

When any lock is active, the EA continues managing existing positions but will not open new ones.

Every new account receives a 7-day free trial with full access to all features:

• Full AI trading system
• Remote control dashboard
• Daily profit targets
• Live chat support
• All premium features — nothing restricted

When your trial expires, you'll need to subscribe (£400/month) to continue trading. Your existing open positions are never affected by trial expiry.

To subscribe after your trial:

Once approved, your subscription activates for 30 days. It auto-renews monthly.

The code expires after 10 minutes. If expired, request a new one.

To cancel, contact support through the dashboard chat or email. Upon cancellation:

• Access continues until the end of your current billing period
• The EA stops receiving remote commands after expiry
• Existing open positions are NEVER automatically closed
• Your data remains available for export for 30 days

There are no cancellation fees and no long-term contracts.

If the dashboard shows your EA as offline, check these in order:

1. Is MT5 running? — The EA can only poll when MT5 is open.
2. Is AutoTrading enabled? — Must be green in the MT5 toolbar.
3. Is the EA attached? — Check if the smiley face appears on the chart.
4. Is WebRequest enabled? — Tools → Options → Expert Advisors → check "Allow WebRequest" and verify the URL is correct.
5. Is internet working? — Try opening a webpage on the same machine.
6. Check the Experts tab — View → Toolbox → Experts tab for error messages.

If you toggle something in the dashboard but the EA doesn't respond:

• Wait 5-10 seconds — commands are picked up on the next poll cycle
• Check if the EA is online (green connected badge)
• Check for a local lock or admin lock (shown as red banners)
• Refresh the dashboard page
• Ensure your token and URL are correct in Configuration

Multiple things can prevent new trade entries:

1. EA Enabled = OFF — check the main toggle
2. Allow New Entries = OFF — check this toggle
3. Daily target already hit — check DTS card
4. Max drawdown reached — check risk management
5. All symbols paused or disabled — check per-symbol cards
6. Admin lock active — contact admin
7. License expired or invalid — check license badge
8. Market is closed — check trading hours for your symbols

When your 7-day trial expires:

• The EA stops opening new positions (existing ones are managed normally)
• The dashboard shows a "Trial Expired" banner
• You can still view your account and chat with support

To continue trading, subscribe from your Account page. Access is restored within hours of payment approval.

• Wrong password — use "Forgot password?" to reset it
• Email not found — check you're using the exact email you registered with
• Account suspended — contact support
• Connection error — check your internet, try again in a minute

If you see this message, it means a free trial has already been activated from your device/browser. This is an anti-abuse measure.

If you believe this is an error (e.g., you share a computer with someone), contact support and we can manually review your case.

The solution is to subscribe to a paid plan — this bypasses all trial restrictions.