DoIt Alpha Pulse AI / Installation Guide
0 / 5 done
Installation guide · MT5 · v3 · ~15 minutes

DoIt Alpha Pulse AI.
Five steps to your first AI trade.

You already own the EA. This page gets it installed, connected and trading — then walks you through the v3 features: Portfolio Mode, Prop Firm Mode and AI News Awareness.

5setup steps
1API key needed
3new v3 features
01 / Install

Install the EA in MetaTrader 5

You already purchased on MQL5 or doittrading.com — now get it onto a chart.

  1. aLog in with your MQL5 account — the same one you purchased with. Use your MQL5 username, not your email or broker credentials.
  2. bFind the EA in the Navigator window under Market → My Purchases. Bought on doittrading.com instead? Follow the install instructions in your delivery email.
  3. cDrag it onto any chart of the symbol you want to trade (M15 recommended). In Portfolio Mode one chart drives up to 5 symbols — see the Portfolio Mode guide.
  4. dEnable algo trading in both places: the Algo Trading toolbar button must be green, and “Allow Algo Trading” must be checked in the EA's settings window.
Running 24/7: the EA only trades while MT5 is open. Most users run it on a VPS — see Resources below.
02 / Connect · required

Allow the AI connections

MT5 blocks external connections by default. The EA cannot work without this step — it's the #1 cause of “AI isn't trading” issues.

  1. aIn MT5, open Tools → Options → Expert Advisors.
  2. bCheck “Allow WebRequest for listed URLs”.
  3. cAdd all 7 URLs below, one per line:
WebRequest URLs · all 7
https://api.openai.com
https://api.anthropic.com
https://generativelanguage.googleapis.com
https://api.x.ai
https://api.deepseek.com
https://dashscope-intl.aliyuncs.com
https://nfs.faireconomy.media
  1. dClick OK and restart MetaTrader 5.
One-time setup. The first 6 URLs are the AI providers — add them all even though you'll only use one, so switching later needs no reconfiguration. The last one (nfs.faireconomy.media) feeds the economic calendar used by AI News Awareness and the prop firm news blackout.
03 / API key

Get your API key

You need one API key from one provider — pick below to see only the instructions that apply to you. You can add more providers anytime.

Gemini — Google AI typical cost $0.10–$3.00 / day
  1. aOpen Google AI Studio — at ai.google.dev and sign in with your Google account.
  2. bClick "Get API Key" — then create and copy the key. No payment method needed for the free tier.
  3. cPaste it into the EA — in the "Gemini API Key" field, and select a Gemini model in AI Model Selection.
Open Gemini console → Models: 3.5 Flash (default), 3.1 Pro, 3 Flash, 3.1 Flash Lite, 2.5 Flash, 2.5 Flash-Lite. Free tier available for testing.
OpenAI — GPT models typical cost $0.10–$8.00 / day
  1. aCreate an account — at platform.openai.com.
  2. bAdd a payment method — under Billing settings — OpenAI charges per usage.
  3. cCreate a secret key — in the API Keys section and copy it immediately (it is shown only once).
  4. dPaste it into the EA — in the "OpenAI API Key" field, and select an OpenAI model in AI Model Selection.
Open OpenAI console → Models: GPT-5.6 Sol / Terra / Luna, GPT-5.5, GPT-5 Mini, GPT-5 Nano.
Claude — Anthropic models typical cost $0.20–$10.00 / day
  1. aSign up — at console.anthropic.com.
  2. bAdd prepaid credits — under Billing — Anthropic uses a credit balance.
  3. cCreate a key — in Account Settings → API Keys and copy it.
  4. dPaste it into the EA — in the "Claude API Key" field, and select a Claude model in AI Model Selection.
Open Claude console → Models: Fable 5 (most capable), Opus 4.8, Sonnet 5 (default), Opus 4.7, Sonnet 4.6, Haiku 4.5.
Grok — xAI models typical cost $0.10–$5.00 / day
  1. aCreate an xAI account — at console.x.ai.
  2. bAdd credits — under Billing.
  3. cCreate a key — in the API Keys section and copy it.
  4. dPaste it into the EA — in the "Grok API Key" field, and select a Grok model in AI Model Selection.
Open Grok console → Models: Grok-4.5 (default), Grok-4, Grok-4 Fast (reasoning / direct), Grok-3 Mini.
DeepSeek — V4 models typical cost $0.05–$1.50 / day
  1. aCreate an account — at platform.deepseek.com.
  2. bAdd credits — under Billing — DeepSeek is extremely affordable.
  3. cCreate a key — in the API Keys section and copy it.
  4. dPaste it into the EA — in the "DeepSeek API Key" field, and select a DeepSeek model in AI Model Selection.
Open DeepSeek console → Models: V4 Flash (default — fast, 1M context), V4 Pro (premium reasoning).
Qwen — Alibaba Cloud typical cost $0.05–$1.50 / day
  1. aCreate an Alibaba Cloud account — at dashscope.console.aliyun.com.
  2. bActivate the Qwen API service — in DashScope — a free tier is available.
  3. cCreate a key — in the API Keys section and copy it.
  4. dPaste it into the EA — in the "Qwen API Key" field, and select a Qwen model in AI Model Selection.
Open Qwen console → Models: Qwen-Plus (default), Qwen-Max, Qwen-Flash. Generous free tier for evaluation.
Keep costs in check: set Max Daily API Cost ($) in the EA settings and start with a modest ceiling while testing — details in Reports & AI costs.
04 / Strategy

Choose a strategy engine

v3 replaced the old library of 14 symbol presets with 3 analysis engines you combine with independent options. Fewer things to choose, more real combinations — and every engine works on any symbol. Set it in the Strategy Preset input (section 1, top of settings).

Flagship · recommended
Institutional Auction & Liquidity
Identifies the market regime FIRST (directional vs balanced), then applies the matching logic: sweep-and-reclaim, breakout with acceptance, continuation from defended pullbacks — or responsive reversion at range extremes. Liquidity events upgrade the evidence but are never a requirement.
Use for · single-symbol trading (default pick)
Free engine
Edge Analyst
No prescribed method: the AI reasons from price, volume and structure and must pass the EDGE TEST on every decision — a stated mechanism, an objective invalidation, break-even arithmetic and positive conservative expectancy.
Use for · unconstrained AI, judged by expectancy
Multi-symbol
Portfolio Edge Allocator
Analyzes each symbol with the auction/liquidity framework, then decides whether ADDING the position improves the book — exposure counted by driver (USD direction, risk-on/off…), correlated setups collapse into the cleanest one.
Use for · Portfolio Mode
No preset
Manual Configuration
The EA runs on the built-in default prompt (= Edge Analyst) with your manual inputs. Pick this when you configure everything yourself, including custom prompt files.
Use for · full manual control
Composable options — they work with ANY engine, including custom prompts
  1. +Trade Direction (inputs section 1): Both / Long Only / Short Only. Locks the prompt (the AI is told the forbidden side does not exist) AND the EA (entries on that side are discarded even if suggested).
  2. +Prop Firm Mode ON (inputs section 6): automatically layers the Prop Survival overlay onto whatever engine you chose — see the Prop Firm Mode guide.
  3. +Custom prompt file (inputs section 7): still supported; the Direction and Prop overlays apply on top of it too.
Confidence is now anchored. The AI classifies every decision and emits an anchor: 30 = REJECT (no trade), 75 = VALID (edge confirmed), 90 = STRONG (exceptional alignment). The Min Confidence input works as a two-position selector: 75 (default — trade VALID and STRONG) or 90 (ultra-selective — STRONG only). Old values like 59–70 behave exactly like 75.
Updating from v2.x? The preset list was rebuilt in v2.80. Old .set files with a v2.x preset value fall back to the default prompt with a clear ERROR line in the Experts log — reload one of the updated FactoryPresets or pick an engine from the new list, then save a fresh .set. Every other input name is unchanged.
05 / Go live

Set your risk and go live

The inputs are organized as a top-to-bottom setup wizard in 8 numbered sections. Only five settings are required — everything else has sensible defaults.

Strategy Preset Auction & Liq. Your engine from Step 4 — inputs section 1.
API Key The key from Step 3, in the field matching your provider — section 2.
AI Model Selection Gemini 3.5 Flash Must match the provider of your API key — section 2.
Risk Per Trade 1.0% Risk per trade as a percentage of balance — section 3.
Min Confidence 75 75 = trade VALID and STRONG setups · 90 = STRONG only — section 4.
Even faster: load a FactoryPreset .set file and only add your API key — FTMO_Challenge.set (prop protections + Auction & Liquidity + 0.75% risk) or Portfolio_Forex_Majors.set (Portfolio engine + symbols preconfigured).
Confirm it's running
Blue hat icon in the chart's top-right corner — the EA is active. Red or gray means it's stopped.
Experts tab shows AI query logs and “AI Decision” messages after the first query interval.
EA panel on the chart shows your active configuration and the model in use. The Overview tab includes a live News status line.
Cautious start: set AI Autonomy to Conservative for the first days — the AI suggests trades without executing, so you can observe its decisions risk-free.
Feature / Full edition

Portfolio Mode — multi-symbol AI

One chart, one EA, up to 5 symbols analyzed together in a single AI request per cycle. The AI sees all markets side by side — correlation between pairs, relative strength, which setup is cleanest — and returns one decision per symbol plus a cross-market reasoning summary on the panel.

Cost
One batched request costs roughly 1.8–2.2× a single-symbol request — not 5×. Shared context is sent once.
Quality
The AI can say “EURUSD and GBPUSD are the same USD trade — take only the cleaner one”. Five blind instances can't.
Risk
One coordinator caps the total open risk across all symbols.
Setup
  1. 1Attach the EA to ONE chart — any of the portfolio symbols, M15 recommended.
  2. 2Pick the Portfolio Edge Allocator strategy preset — the engine built for multi-symbol allocation. Other engines work too, but they analyze symbols without the book-level layer.
  3. 3Set Portfolio Symbols — comma-separated, 2 to 5 symbols, e.g. EURUSD,GBPUSD,USDJPY. Empty = classic single-symbol mode.
  4. 4Optionally set Max Total Open Risk Across Symbols (% of balance, 0 = off). New entries are skipped while the combined open risk exceeds the cap.
  5. 5Or just load FactoryPresets/Portfolio_Forex_Majors.set and add your API key.
Good to know
  1. ·Symbols must exist in Market Watch and allow trading — invalid ones are skipped with a log line (broker suffixes like .raw matter).
  2. ·Each symbol trades with its own magic number (base + slot index) — positions are managed independently.
  3. ·Only ONE EA instance per portfolio. Don't attach the EA to the other symbols' charts too.
  4. ·In the Strategy Tester, portfolio mode is disabled automatically (the tester is single-symbol).
Per-symbol view on the panel: in portfolio mode every tab can isolate one symbol. The AI tab's PORTFOLIO > button cycles through the symbols showing each one's full decision; a shared ALL > cycler on the Performance and History tabs filters both — Performance recalculates every stat from that symbol's trades only, History shows only that symbol's decisions. ALL restores the aggregate.
Feature / Full edition

Prop Firm Mode — FTMO & similar

Account-level protection for prop firm challenges, enforced by the EA before the prop firm's servers can breach you — plus the same limits injected into the AI prompt every cycle so the AI trades the remaining budget, not blind. Per-firm setup guides: doittrading.com/prop.

ProtectionInputFTMO example
Daily loss limitDaily Loss Limit Mode + Value4.5% (buffer under the official 5%)
Max overall loss (permanent stop)Max Overall Loss Mode + Value9% (buffer under 10%)
News blackoutNews Blackout ±Minutes2 (funded-account rule)
Weekend flatClose EA Positions Before WeekendON, Friday 21:00 broker time
Trade randomizationRandomize SL/TP ±5%ON (anti copy-trading detection)
How the limits behave
  1. ·Daily loss is measured from your balance at 00:00 broker time. When hit, the EA flattens the whole account (all positions and pending orders, not just its own) and blocks trading until midnight. The stop flag is shared across every EA instance on the account.
  2. ·Max overall loss is measured from the challenge initial balance (set Challenge Initial Balance, or leave 0 to auto-snapshot on first run). This stop is permanent — it does not reset at midnight. A breached challenge is over; the EA makes sure you keep the account flat.
  3. ·Use values below the official caps (4.5%/9% vs FTMO's 5%/10%): floating spreads and slippage mean you must stop before their servers do.
News blackout — where the events come from

The blackout blocks new entries ±N minutes around high-impact events on the symbol's currencies. The News Source input picks the source: Auto (default: MT5 calendar → ForexFactory feed → manual file, first one with data wins) or force a single source.

The Prop tab lists upcoming events of ALL impacts — [H] [M] [L] — and shows which source is live plus the next 3 events. The Blackout Trigger Impact input controls which impacts actually BLOCK entries: High only (default, the FTMO rule), High+Medium, or All.

ForexFactory feed: the EA downloads the public weekly calendar, converts times to your broker's clock and caches the week locally. It needs the https://nfs.faireconomy.media whitelist from Step 2.

Manual file — some brokers serve no calendar, and you may prefer your prop firm's official restricted-events list. Create MQL5\Files\AlphaPulse_NewsFallback.csv, one event per line in broker time (optional 4th column H/M/L; missing = High; # lines are comments). Keep it updated weekly:

AlphaPulse_NewsFallback.csv
2026.07.14 14:30;USD;CPI
2026.07.16 12:15;EUR;ECB Rate Decision;H
Trade randomization

With Randomize SL/TP ±5% enabled, every fresh AI signal gets its stop loss and take profit distances jittered by up to ±5% (never below 50% of the original distance, never flipping sides). Two customers running the same configuration at the same prop firm will place measurably different orders — this defeats copy-trading detection. The jitter is applied once per AI response, so the panel, the logs and the executed order always show the same values. Position management is never randomized.

The Prop Survival overlay + phase awareness

There is no separate “prop preset”: turning Prop Firm Mode on automatically layers challenge discipline onto whatever strategy engine you use. The overlay teaches the AI that the loss caps make risk asymmetric — the required setup quality RISES as budget is consumed — and forbids lowering the bar to “win back” losses. Two data feeds power it, injected into every AI request: the loss budget (daily and total loss used vs limit), and phase awareness — if you also set Stop EA When Profit Target Reached + the target amount, the AI sees its progress toward the challenge target and adapts: normal operation early, protection mode when the pass is nearly secured, no new entries once it is reached.

Dynamic budget sizing

Independently of the AI, the EA scales the position size to the remaining budget: one trade may risk at most half of the remaining daily budget and a quarter of the remaining total budget. Example (FTMO 4.5% daily): after losing 3% in a day, the next entry risks at most 0.75% even if your Risk Per Trade says 1%. When no meaningful size keeps a margin to the caps, new entries pause until the budget recovers — position management and trailing keep running.

Quick start (FTMO): load FactoryPresets/FTMO_Challenge.set, add your API key, done. It configures all four protections, the Auction & Liquidity engine, 0.75% risk per trade and a $10/day AI budget. Prop protections and strategy engines are independent — switch engines any time, the protections stay active.
Feature / ON by default · Full edition

AI News Awareness — context, not compliance

With AI Sees Economic Calendar enabled (inputs section 4, default ON), every AI request includes the upcoming economic events on the traded symbols' currencies — time-to-event, currency, impact. The AI decides on its own whether to enter now or wait (“CPI in 20 minutes — no entry, tightening the stop on the open position”). This never blocks anything by itself. The hard news blackout (Prop Firm Mode) remains a separate, optional protection.

The News line on the panel (Overview tab)
Panel showsMeaning
News: USD CPI y/y.. in 32m [H]Next relevant event with countdown and impact. Gold when a blocking event is under 1h away — the AI is likely holding fire. Full event list on the Prop tab.
News: BLACKOUT USD (AI paused)Hard blackout active (Prop Firm Mode). (AI paused) = the EA is also skipping AI calls because nothing is executable: every symbol blocked AND no position open. Zero tokens wasted; queries resume the moment the window ends.
News: NO DATA (see Prop tab)Red — fix it: no news source is delivering data. Add nfs.faireconomy.media to the WebRequest list (Step 2) or maintain the manual CSV. Until then the AI trades without news context and any configured blackout is NOT enforced.
News: clear 26hSource alive, nothing relevant coming up.
Data sources — same cascade as the prop blackout: MT5 calendar → ForexFactory weekly feed → manual CSV. If your panel shows NO DATA on first run, the WebRequest whitelist is almost always the missing step. The Prop tab is always visible: with no prop protection configured it acts as a setup board, and its NEWS section stays live for every user with News Awareness on (source health, next 3 events, blackout state).
Feature / Reports & costs

One-click report, hard cost ceiling

Everything you need to audit performance and keep the AI bill predictable.

The EXPORT button (Performance tab)

One click on EXPORT (top-right of the RETURNS card) writes a self-contained HTML dashboard to MQL5\Files\DoItAlphaPulseAI_Reports\ and pops the path. It covers every closed trade of this EA's magic numbers — all history, all symbols: net PnL, trades, win rate, profit factor, max drawdown in money, average win/loss, best/worst trade, cumulative PnL curve, monthly PnL chips and a collapsible trade list. In portfolio mode you get one additional card per symbol. PnL includes swap and both-side commissions; the file opens in any browser with no internet connection.

AI cost control (all modes)
  1. ·Max Daily API Cost ($) is a hard ceiling. The EA tracks real usage tokens reported by the provider (not estimates). When the budget is reached it stops querying and alerts you — it never silently degrades to a cheaper model.
  2. ·Scope: the budget is tracked per chart + model (symbol, magic number and model form the counter). Several charts, or a fallback model kicking in, each get their own counter — size the limit accordingly.
  3. ·The panel shows the running daily cost. Costs reset at midnight.
  4. ·v3 sends leaner requests and enables provider-side prompt caching where available (Claude 1h cache, OpenAI/Gemini automatic) — same analysis quality, fewer billed tokens per query.
Editions

FREE vs Full

The Full edition is the one sold on MQL5 and doittrading.com.

FreeFull
Single-symbol AI trading
All AI providers, your API key
One-click HTML performance report
Portfolio Mode (up to 5 symbols)
Prop Firm Mode
AI News Awareness
Troubleshooting

AI isn't trading? Check these in order.

90% of cases are #1 or #2.

01 WebRequest URLs — the most common cause. Verify all 7 URLs from Step 2 are listed in Tools → Options → Expert Advisors, then restart MT5.
02 API key & provider match — the key must belong to the selected model's provider (a GPT model needs an OpenAI key, not a Claude key) and have credits. The Journal tab names the exact error ("URL not allowed", "invalid API key").
03 "ERROR: Invalid preset enum N (old .set file?)" — your .set predates v2.80 — the preset list was rebuilt. The EA falls back to the default prompt and keeps running; pick an engine from the new list (or reload an updated FactoryPreset) and save a fresh .set.
04 Panel shows "News: NO DATA" — whitelist https://nfs.faireconomy.media (Step 2) or create the manual CSV (Prop Firm Mode guide). A log line "calendar unavailable - using fallback file" is normal on brokers without calendar data.
05 Autonomy level — on Conservative the AI only suggests — it never opens trades itself.
06 PORTFOLIO > selector missing — it appears after the FIRST AI response of the session. If it never appears, check the Experts log for portfolio init errors — a skipped symbol usually means the exact broker name differs (suffixes like .raw matter).
07 "DAILY LIMIT TRIGGERED" then repeated flatten lines — working as designed — the EA keeps flattening anything that reappears until midnight (daily stop) or permanently (max overall stop).
08 AI budget reached — the panel shows the block; raise Max Daily API Cost or wait for the midnight reset.
FAQ

Hard questions, direct answers

No — one key from one provider is enough. Add a second provider only if you configure a Fallback Model, and pick it from a different provider than your primary so both never fail together.
Yes. The Strategy Tester disables AI automatically, Gemini and Qwen offer free tiers, and Conservative autonomy lets you watch suggestions without executing. Long query intervals also keep costs minimal.
v2.80 rebuilt the Strategy Preset list (the old 14 symbol/style presets became 3 engines + composable options). An old .set with a v2.x preset value falls back to the default prompt with a clear ERROR line in the Experts log. Reload one of the updated FactoryPresets or pick an engine from the new list, then save a fresh .set. Every other input name is unchanged, and old Min Confidence values like 59–70 behave exactly like 75.
Yes — engines compose with independent options: Trade Direction (Long/Short Only), the Prop Survival overlay (Prop Firm Mode ON), and custom prompt files all apply on top of any engine. Deeper overrides (timeframes, bars, market depth) live in Advanced settings — section 7 of the inputs, only read when its Customize toggle is ON.
A backup AI. After 2 consecutive server errors on your primary, the EA switches to the fallback; after one successful fallback query it re-tests the primary and switches back when it recovers. The panel shows "[FALLBACK]" while the backup is active. Note the AI cost budget is tracked per model — a fallback model has its own counter.
Yes — give each a unique Magic Number, stagger query intervals to avoid rate limits, watch combined API costs, and keep adequate margin. In Portfolio Mode, remember: ONE instance drives the whole portfolio — don't attach the EA to the other symbols' charts.
Set Override System Prompt to True and enter a filename relative to MT5's Files folder (Ctrl+Shift+D to open it). Example: place your file at Files\DoItAlphaPulseAI\MyStrategy.txt and enter "DoItAlphaPulseAI/MyStrategy.txt". Switch strategies by changing the filename — no restart needed. Trade Direction and the Prop overlay still apply on top of your prompt.
Floating spreads and slippage mean your equity can slip past a limit between ticks — you must stop before the prop firm's servers do. That's why the FTMO preset uses 4.5%/9% against the official 5%/10%. The daily stop resets at midnight; the max overall stop is permanent because a breached challenge is over.
Resources

The setup we actually run

Broker, funded program and VPS behind our own live results — the same stack this guide assumes.

Affiliate links — using them supports DoIt Trading at no cost to you.

Scroll to Top