TradeMatrix Assistant

A tabbed trade-management dashboard and market-structure analysis panel for MetaTrader 5.

TradeMatrix Assistant turns manual trading into a single-panel workflow: risk-based position sizing, one-click order execution with scaled entries, in-panel position management, and automatic ICT/SMC-style chart analysis — all in one dockable dashboard, with no coding or separate indicators required.

Overview

The EA draws a five-tab panel directly on the chart. Every field is live-editable — risk percentage, stop distance, entries, comment — and every button executes immediately, with values re-read at the moment of the click so nothing is lost if you didn't press Enter first. Alongside the panel, the EA continuously analyzes the chart itself: fair value gaps, order blocks, structure breaks, liquidity sweeps, support/resistance, candlestick patterns, and simple chart patterns are detected and drawn automatically, on a timer, with no manual refresh needed.

Tab-by-Tab Features

Trade

• Risk % + R:R → automatic lot size. Enter a risk percentage and a reward ratio; the EA calculates lot size from your account balance, stop distance, and the symbol's tick value.
• Auto / Manual lot toggle. Switch instantly between risk-based sizing and a manually typed lot size.
• SL / TP in pips, with an adjustable points-per-pip conversion factor (gold has no single industry-standard pip size, unlike major forex pairs, so this is exposed as a setting rather than assumed).
• Offset (points) for placing stop/limit orders away from the current price.
• Entries (bulk): place 1–N positions in a single click. The lot splits evenly across all N, each keeps the same stop loss, and take-profits stagger at 1×, 2×, 3×... your R:R — a built-in scale-out ladder. If the lot is too small to split as requested, the EA places as many full-size entries as it can and explains why via an alert, rather than silently under-filling.
• One-click Buy / Sell / Buy Stop / Sell Stop / Buy Limit / Sell Limit, no confirmation dialog.
• Editable trade comment, with a settable default.

Manage

• Live position summary: count, direction, total lot, floating P/L.
• Account snapshot: balance, equity, and free margin, visible without switching tabs.
• Open positions list (up to 5 shown at once): ticket, type, lot, and P/L per row, each with its own one-tap close icon. The tab's height adjusts automatically to how many positions are actually open, rather than always reserving space for the maximum.
• Partial close: 25% / 50% / 75% / 100%, aggregated across all EA-tagged positions on the symbol.
• Break Even: moves stop loss to entry plus a small buffer, only when the position is in profit.
• Trailing stop: on/off toggle: once price moves far enough in profit, the stop follows it automatically, live, every tick.

Setup

• Trailing start distance, trailing distance, and break-even buffer — all live-editable, no restart required.
• Independent on/off toggles for every chart-analysis layer: Fair Value Gaps, Order Blocks, Break of Structure / Change of Character, Support/Resistance, Liquidity Sweeps, Candlestick Patterns, and Chart Patterns.
• Adjustable lookback window (bars).
• Editable, comma-separated scanner symbol list.
• Alerts on/off, and configurable minutes-ahead warning for high/medium-impact news.

Info

• Balance / Equity / Free Margin.
• ATR(14) and a relative volatility read (High/Normal/Low vs. its own 50-bar average).
• Multi-timeframe trend bias (M15 / H1 / H4 / D1), each shown as Up / Down / Range.
• Upcoming economic news, up to 5 events, with a live countdown and impact tag.
• Current symbol specification summary.

Scan

• A multi-symbol watchlist (configurable in Setup) showing, per symbol: trend condition (Trend/Range), and signal (BUY / SELL / REVERSAL? / Up / Down / –).
• Highlights the single strongest current setup across the whole list.
• Manual "Scan Now" plus automatic refresh roughly every 60 seconds.

Persistent header (visible on every tab)

• A trend-direction badge for the current timeframe.
• A news badge showing the next high/medium-impact event with a live countdown.

Automatic Chart Analysis

All of the following are detected and drawn directly on the chart, continuously, without any manual step:

• Fair Value Gaps (FVG) — imbalance zones, shaded and colour-coded by direction.
• Order Blocks — the qualifying opposite-direction candle before a structural break, detected with a minimum break-distance and minimum body-percentage filter to avoid noise.
• Break of Structure / Change of Character (BOS/CHoCH) — labelled directly at the break point.
• Liquidity Sweeps — a wick beyond a prior swing high/low that closes back inside it, marked with a directional arrow.
• Support/Resistance — clustered swing highs and lows, drawn as dotted levels.
• Candlestick patterns — Doji, Hammer, Shooting Star, and Bullish/Bearish Engulfing, tagged at the candle.
• Chart patterns — Double Top and Double Bottom, detected from matching swing points with a confirmed reversal between them.
• Live position overlay — entry, stop loss, and take-profit drawn as bounded lines on the chart for every open position, each labelled with its distance and dollar value.

Risk & Money Management

• Position size is derived from account risk percentage and stop distance — not a fixed lot — so sizing adapts automatically as balance changes.
• Bulk entries implement a scale-out approach (staggered take-profits) from a single click, with transparent feedback if the requested split isn't possible at the current lot size.
• Partial close, break-even, and trailing stop are all available per-symbol from the Manage tab without leaving the chart.

News Awareness

• Reads the built-in MT5 economic calendar.
• Surfaces upcoming high/medium-impact events with a live countdown, both in the Info tab and in the always-visible header badge.
• Optional alert a configurable number of minutes before a qualifying event.

Key Inputs

(Additional inputs exist for FVG, Order Block, structure, and S/R display, following the same on/off pattern.)

Notes & Assumptions Worth Knowing

• Pip size for gold is a convention, not a fact. InpPointsPerPip defaults to 10 (1 pip = $0.10), the most common retail convention, but this varies by broker and trader. Verify it matches your own usage before relying on the pip-denominated SL/TP fields.
• Default stop distance is capital-aware, not fixed. The shipped default assumes a small account balance and reasons backward from the broker's minimum tradeable lot size, so that the smallest possible position still lands close to the intended risk percentage rather than wildly overshooting or undershooting it. This is a starting point calculated for one account size at one point in time — revisit it if balance changes materially.
• Bulk entries respect the broker's minimum lot. If the requested number of entries can't be split without going below the minimum lot, the EA reduces the entry count and alerts you, rather than placing an invalid order or silently doing something different from what was asked.
• All chart-drawn objects use a dedicated internal prefix and are excluded from the panel's own redraw cycle, so analysis drawings and the dashboard never fight each other for the same screen space.
• Head & Shoulders, triangles, wedges, and other multi-point geometric chart patterns are not implemented — Double Top/Bottom is the only chart-pattern type currently detected, since the others require more elaborate multi-point fitting than a straightforward swing-matching approach can reliably deliver.

Requirements

• MetaTrader 5, any broker offering the traded symbol.
• Works on any timeframe; multi-timeframe bias and the scanner read other timeframes independently of the chart it's attached to.
• No external indicators or libraries required — self-contained in a single .mq5 file.

Disclaimer

This is a trading tool, not financial advice. TradeMatrix Assistant automates order placement and displays technical analysis; it does not recommend trades, predict price direction, or guarantee any outcome. The decision to open, hold, or close any position remains entirely the user's own.

Trading carries a real risk of loss. Forex and CFD trading, including gold (XAUUSD), is typically leveraged and can result in losses that are large relative to the account balance. Only trade with capital you can afford to lose. Past results — from backtesting, demo trading, or a live track record — do not guarantee future performance.

No warranty. This software is provided "as is," without warranty of any kind, express or implied, including but not limited to fitness for a particular purpose, accuracy of any analysis it draws, or uninterrupted, error-free operation. The chart-drawn patterns (fair value gaps, order blocks, structure breaks, liquidity sweeps, support/resistance, candlestick and chart patterns) are algorithmic pattern-matching against price history — not signals that reliably predict what price will do next.

Verify defaults before trading live. Default values such as stop-loss distance, risk percentage, and the points-per-pip conversion are starting points calculated from stated assumptions — a specific account balance and a common but not universal broker tick-value convention, both documented earlier in this description. Confirm they match your own broker and current account before risking real funds, and test on a demo account first.

No liability. Whoever provides or modifies this EA is not liable for any financial loss, damage, or other consequence arising from its use, misuse, or from any error in its code or analysis.

Not affiliated with MetaQuotes or any broker. This is an independently built tool for MetaTrader 5. It is not endorsed by, and has no official relationship with, MetaQuotes Software Corp. or any brokerage.

This is standard-practice wording, not a substitute for a lawyer's review. If this EA is going to be sold, published on a marketplace, or distributed to other users, get the disclaimer and terms actually reviewed by someone qualified in your jurisdiction before that happens — the stakes are different for personal use versus distributing to others.