MATS EA — Input Guide

Processing logic: TradeMode defines the initial direction state. BUY_AND_SELL allows two chains; BUY_OR_SELL permits only one direction at a time. ONLY_BUY/ONLY_SELL match the corresponding control buttons. UI buttons and shortcuts can still change the direction during a running session.

Processing logic: A Candle order starting a new chain also uses FirstTPPips/FirstSLPips; CandleSignalLot only changes volume. See the Auto SAT overrides below.

Processing logic: EntryTimeframe drives new-bar/candle processing. TrendTimeframe is used by EMA, MACD, ADX + DI, and Market Structure. HigherTimeframe provides HTF Alignment, Zone AI, and Bias/Key Levels. Filters read closed candles to avoid incomplete signals. With UseAutoCandleStopLoss=true, Candle signals still use EntryTimeframe, while structural invalidation, swings, and ATR(14) come from closed TrendTimeframe candles.

Processing logic: MT5 does not let one input rewrite the displayed value of another. A selected preset supplies the complete internal profile even though the input fields still show the manual values. Select NONE to use and adjust those values directly. The Trend UI always displays the effective values.

Processing logic: MaxLots caps every order, including Candle. CandleSignalLot=0.50 requires MaxLots≥0.50 for the full volume. MaxBuyOrders/MaxSellOrders are checked at the shared order gateway against open positions matching the symbol and EA magic, including the Balance magic offset. MagicNumber=0 includes all positions on the symbol. For example, with MaxBuyOrders=20, 5 Entry + 4 Candle + 3 Bias + 6 DCA + 2 Balance BUY positions block further BUY entries; SELL has its own limit. Closing positions frees capacity. Special tags do not advance DCA progression but still count toward these limits.

Processing logic: Within the local-time window, separate profiles apply to standard Entry, Candle, Bias, the shared Entry/DCA lot cap, and pruning. DCA uses InitialLots (or ResetLots after auto reset) and LotMode as its base, not LotTimeNewLots/LotTimeCandleLots/LotTimeBiasLots. Entry and DCA use LotTimeMaxLots inside the window and MaxLots outside; DCA auto reset follows the active cap. ADD mode still adds LotAddFactor to the latest open DCA/standard Entry lot; Candle/Bias do not change the DCA anchor. Example: InitialLots=0.1, multiplier=1.5, dcaCount=1 gives a MULTIPLY DCA lot of 0.15 even if LotTimeNewLots=0.01, provided the cap allows it. With LotTimeMaxLots=0.1 and auto reset off, volume is capped at 0.1.

Processing logic: The EA latches ResetLots/ResetMultiplier/ResetChainTPPips and restores the state after restart.

Processing logic: Each source returns BUY (+1), SELL (-1), or NONE (0) from closed candles. AND requires every participating signal to be nonzero and in the same direction. OR needs at least one nonzero signal, but simultaneous BUY and SELL cancel the result. Combined signals must still pass all safety gates. Candle participates when EntryCandle or UseCandleSignalForEntry is true. EntryCandle=true with UseCandleSignalForEntry=false uses Entry lots to start a chain and does not add separate Candle orders. If UseCandleSignalForEntry=true, Candle logic and lots take priority, including time-based lot rules, regardless of EntryCandle. Both false disables Candle trading. Candle participates only once and shares a persisted signal timestamp to prevent duplicate Entry/Candle orders, including after restart. This priority does not bypass AND/OR, filters, or pending CHoCH. Older .set files must select the new switches instead of the old mask. CHoCH is selected by EntryCHoCH, is valid during the following candle, and sends at most one request when conditions pass; see CHoCH Structure Entry. Signals read closed candles when a new EntryTimeframe bar appears: [1] is the latest closed candle, [2] the previous one. Cache lasts until the next EntryTimeframe candle; successfully processed bars are not reevaluated. Missing data, EMPTY_VALUE, or CopyBuffer errors temporarily return 0 without marking the bar processed, allowing retry on later ticks. Reverse and BB share EntryTimeframe. For Reverse BUY: BB SELL conflicts, BB BUY agrees, and BB=0 preserves BUY only under OR. Cached signals are not consumed after an order; avoiding duplicate evaluation is not the same as limiting each signal to one order. OpenOnNewCandle, trend filters, pause/license, limits, and the gateway still apply. OpenOnNewCandle=true permits one Entry per EntryTimeframe candle, including a later tick once data becomes available if no managed order has opened in that candle. DCA does not use Entry-source switches and retains its own DcaType and trend filters. The dashboard lists enabled Entry sources in two columns, at most two per row, with separators. Panel height and SignalCombine/License positions adjust to the row count. The common timeframe appears in the Entry Signals heading; individual labels use Stoch Rev and BB. Candle is shown once when either Candle switch is enabled. SelfAwareTrend auto presets: up to M5, Scalping (ATR 10, ER 14, band 1.5, SL 1.0 ATR); above M5 through H4, Default (14, 20, 2.0, 1.5); above H4, Swing (21, 30, 2.5, 2.0). Source is Close; default TQI combines ER/volume/structure/momentum, effective ATR, and smoothed asymmetric bands. BUY/SELL occurs only on a reversal in the latest closed candle. There is no score gate, self-learning, or trading timeout. Insufficient data waits and retries. AND/OR and existing Trend, Bias, Zone, time, spread, lot, limit, and DCA rules remain in force. Each SAT signal can attempt submission at most three times, at least five seconds apart within the current Entry candle. Retry only before broker submission or after a clear temporary rejection (requote, changed/unavailable prices, too many requests, or processing lock). Filled, pending, partially filled, or uncertain results such as timeout/disconnection remain locked against duplicates, including after restart. Unmet filters may wait within the same Entry candle. SAT does not add entries to an existing chain except under the current CHoCH rules.

Processing logic: Each side maintains its own dcaCount, anchor, and progression. DcaType controls timing independently of OpenOnNewCandle: STEP_TF can open as soon as distance is met, at most one DCA per EntryTimeframe candle per side. STEP_CLOSE checks only at the start of a new candle and reevaluates all conditions. OpenOnNewCandle therefore affects only Entry/Candle/Bias. |CS, |BF, and |LB do not change the DCA anchor or lot progression. From DcaTrendFilterOrderCount onward, DCA must pass enabled trend filters. ATR locks a separate BUY/SELL threshold after Entry/DCA or another chain order fills and positions update; a partial fill increasing volume also relocks it. It does not relock every tick/bar or simply because positions partially close. The dcaCount factor is locked along with the distance. |CS/|BF/|LB still do not increment dcaCount or change anchor rules. A flat chain clears the threshold. Restart, input changes, or taking over existing positions initializes it from the latest ATR[1] and current dcaCount. ATR errors, insufficient history, or nonpositive ATR block the side requiring a threshold, log once, and retry; no fixed-distance fallback is used. Anchor prices, BUY versus Ask, SELL versus Bid, lot sizes, filters, TP/SL, and gateway rules remain unchanged. DCA logs show ATR and the locked price threshold. The dashboard hides Balance/Equity. The EA area shows DCA On/Off from UseDCA and STEP_TF/STEP_CLOSE/ATR mode. Step (price) is hidden, but distance calculation and locking still work as described. On indicates the feature is enabled, not that an order must open immediately; all trading gates still apply.

Processing logic: Multipliers are compounded across historical tiers. A new tier affects only steps from its activation onward; the new multiplier is not raised to the entire previous dcaCount. This avoids abrupt lot jumps at tier changes.

Processing logic: Used only with LotMode=MANUAL. The first DCA uses element [0], the second [1]; after the list ends, the last value is retained. Candle/Bias/Balance do not use this list.

Processing logic: Closing occurs only when expected net profit reaches the threshold. Partial closing also depends on the broker volume step.

Processing logic: An |LB order in the same chain contributes to BE/profit/TP but does not change the DCA anchor. It is blocked while trailing is CLOSING and does not open in the same tick as DCA.

Processing logic: Each BUY/SELL chain has DISARMED → ARMED → CLOSING states. When gain from BE reaches TrailStartPips, the first stop locks TrailFirstSLBufferPips. Each additional TrailStepPips of best gain raises the locked level by exactly one step. Changes in chain count/lot/BE reset trailing. During CLOSING, the EA blocks further entries on that side and retries closing until the chain is empty.

Processing logic: Money-based exits close the entire managed footprint; Weekend uses server time. Daily limits use realized plus floating P/L and stay latched until the new trading day plus the configured delay.

Processing logic: Money-based exits close the entire managed footprint; Weekend uses server time. Daily limits use realized plus floating P/L and stay latched until the new trading day plus the configured delay.

Processing logic: Money-based exits close the entire managed footprint; Weekend uses server time. Daily limits use realized plus floating P/L and stay latched until the new trading day plus the configured delay. Percentage limits use the saved starting daily balance, not intraday equity or balance changes. On first attachment, use balance at initialization; restarts within the day reuse the saved base. A new base is fixed on the next server-time trading day after NewDayDelayMinutes. P/L is realized profit for the day plus floating P/L of EA-managed trades on the symbol under the current MagicNumber rules, not total P/L from every EA/symbol in the account. Reaching a limit closes orders through the existing protection flow and locks Entry/DCA until the new day; unfinished closes continue to be processed. With money and percentage thresholds enabled together, whichever is reached first triggers. If the base balance is nonpositive, percentage thresholds do not apply, but monetary limits remain active.

Processing logic: Signals read closed candles and cache results on EntryTimeframe. Stochastic >50 gives BUY, <50 gives SELL; RSI >50 gives BUY, <50 gives SELL. Supertrend returns the current trend direction.

Processing logic: Only closed candles are read when a new EntryTimeframe candle appears: [1] is the latest closed bar, [2] the previous bar. Results remain cached until the next EntryTimeframe bar; successfully processed bars are not reread. Missing data, EMPTY_VALUE, or CopyBuffer errors temporarily return 0 without marking the bar processed, so the next tick can retry. AND requires all enabled sources to have the same nonzero direction. OR ignores 0 but returns 0 for simultaneous BUY and SELL. Reverse and BB share EntryTimeframe. Example: Reverse BUY with BB SELL conflicts; BB BUY agrees; with BB=0, only OR can retain BUY. Cache is not consumed after an order: avoiding duplicate evaluation is not a one-order-per-signal limit. Every order still passes OpenOnNewCandle on EntryTimeframe, trend filters, pause/license, limits, and the gateway. OpenOnNewCandle=true limits Entry to one order per EntryTimeframe candle; a later tick may enter once data becomes available if no managed order opened in that candle. DCA does not use Entry-source switches or these two sources; its DcaType and trend filters remain unchanged.

Processing logic: Only closed candles are read when a new EntryTimeframe candle appears: [1] is the latest closed bar, [2] the previous bar. Results remain cached until the next EntryTimeframe bar; successfully processed bars are not reread. Missing data, EMPTY_VALUE, or CopyBuffer errors temporarily return 0 without marking the bar processed, so the next tick can retry. AND requires all enabled sources to have the same nonzero direction. OR ignores 0 but returns 0 for simultaneous BUY and SELL. Reverse and BB share EntryTimeframe. Example: Reverse BUY with BB SELL conflicts; BB BUY agrees; with BB=0, only OR can retain BUY. Cache is not consumed after an order: avoiding duplicate evaluation is not a one-order-per-signal limit. Every order still passes OpenOnNewCandle on EntryTimeframe, trend filters, pause/license, limits, and the gateway. OpenOnNewCandle=true limits Entry to one order per EntryTimeframe candle; a later tick may enter once data becomes available if no managed order opened in that candle. DCA does not use Entry-source switches or these two sources; its DcaType and trend filters remain unchanged.

Processing logic: Signals read closed candles and cache results on EntryTimeframe. Stochastic >50 gives BUY, <50 gives SELL; RSI >50 gives BUY, <50 gives SELL. Supertrend returns the current trend direction.

Processing logic: Signals read closed candles and cache results on EntryTimeframe. Stochastic >50 gives BUY, <50 gives SELL; RSI >50 gives BUY, <50 gives SELL. Supertrend returns the current trend direction.

Processing logic: Enable EntryCHoCH to select CHoCH. Other source switches combine through AND/OR; Candle participates when EntryCandle or UseCandleSignalForEntry is true. Swings are confirmed after N closed bars on each side; equal highs/lows are not strict swings. The first swing is H/L; later swings are HH/HL/LH/LL. In bearish LH+LL structure, a close above the protected LH creates Bullish CHoCH. In bullish HH+HL structure, a close below the protected HL creates Bearish CHoCH. A wick through the level or a close exactly at it is not a break. A same-direction break is BOS. After CHoCH, a new structural pair is required before the next event. Each level fires once. Entry is evaluated from the first tick of the next candle; the signal remains valid through that candle if filters initially block it. It can enter when same-side positions already exist. Entry lots, First SL/TP, Magic, and existing limits still apply. Each signal submits at most one request; once submitted, even if rejected or pending at the broker, it is not resubmitted. While CHoCH is pending, the Engine does not open accompanying Candle/Bias/DCA orders; afterward DCA retains its own price steps. Experts logs explain blocked entries. This EA version does not include Smart Grid/CHoCH Cooldown. CHoCH arrows are signals; Entry labels come only from executed deals at their actual time/price. Restarting or missing multiple candles only reconstructs historical drawings, without replaying trades. Objects use a dedicated prefix, with at most 3,000 objects and 3,000 recent deals within the history window.

Processing logic: Patterns are detected on EntryTimeframe. Combined entries with matching SelfAwareTrend and UseSelfAwareAutoSLTP=true prioritize SAT SL/TP. For other Candle entries, FirstSLPips>0 always takes priority. With FirstSLPips=0 and UseAutoCandleStopLoss=true, use structural SL on TrendTimeframe; with FirstSLPips=0 and Auto SL=false, submit SL=0. |CS contributes to shared BE/profit/TP but not DCA progression. When UseCandleSignalForEntry=false and Candle is selected for Entry, orders use Entry lots without |CS. When true, Engine_CandleLot prioritizes the active time-window lot; otherwise it uses CandleSignalLot and its zero fallback. Lot caps still apply.

Processing logic: Drawings use the same formula and EntryTimeframe presets, but maintain independent state and neither generate nor consume trading signals. TP/SL level display does not place or modify orders, is independent of ShowSelfAwareTrend, and continues showing older Auto trades after the Entry source is disabled. Trend colors apply when ShowSelfAwareTrend=true and do not change entries or SL/TP. SelfAwareTrend auto presets: up to M5, Scalping (ATR 10, ER 14, band 1.5, SL 1.0 ATR); above M5 through H4, Default (14, 20, 2.0, 1.5); above H4, Swing (21, 30, 2.5, 2.0). Source is Close; default TQI combines ER/volume/structure/momentum, effective ATR, and smoothed asymmetric bands. BUY/SELL occurs only on a reversal in the latest closed candle. There is no score gate, self-learning, or trading timeout. Insufficient data waits and retries. AND/OR and existing Trend, Bias, Zone, time, spread, lot, limit, and DCA rules remain in force. Each SAT signal can attempt submission at most three times, at least five seconds apart within the current Entry candle. Retry only before broker submission or after a clear temporary rejection (requote, changed/unavailable prices, too many requests, or processing lock). Filled, pending, partially filled, or uncertain results such as timeout/disconnection remain locked against duplicates, including after restart. Unmet filters may wait within the same Entry candle. SAT does not add entries to an existing chain except under the current CHoCH rules.

Processing logic: Inside the time window, EMA1>EMA2 allows only BUY and EMA1<EMA2 only SELL for Entry, Candle, and DCA once the filtering threshold is reached. Outside the window, the filter is inactive.

Processing logic: Main>signal permits only BUY; main<signal only SELL. FlipGuard removes small oscillations around crossovers.

Processing logic: Each filter is enabled separately and returns BUY (+1), SELL (-1), or NEUTRAL (0). Market Structure distinguishes HH/HL, LH/LL, BOS, and CHOCH; CHOCH returns the new reversal direction. VWAP and Volume Profile use closed TrendTimeframe candles. Volume Profile uses broker tick volume, not centralized market-wide volume. Disabled filters participate in neither CONSENSUS nor SCORE.

Processing logic: UseBiasFilter enables Bias/Key Level analysis. UseBiasFilterAsTrendFilter decides whether results gate Entry/Candle/DCA; UseBiasFilterForEntry controls independent |BF orders at Key Levels. Levels are recalculated only after a new HigherTimeframe candle closes. Rectangles are translucent; overlapping green and red/orange regions can look purple. This is overlap/conflict, not a separate signal. UseTrendFilterForBiasEntry adds a separate HigherTimeframe trend confirmation for standard Entry, Candle, and Bias. It uses SCORE when UseTrendFilterScoring=true, otherwise CONSENSUS. Bias does not score itself in the HTF score, avoiding a loop. |BF contributes to shared BE/profit/TP but does not change DCA progression. Automatic mode uses broker server days and resets on the first tick of a new day. Reading D1 High-Low lets it reactivate after restart if the current day already exceeded the threshold. If D1 data is unavailable, it does not newly activate and retries on later ticks; a state already ON stays ON until the day ends. Applies to standard Entry/Candle/Bias, not DCA. The dashboard shows AUTO ON/OFF.

Processing logic: A zero boundary is unrestricted; even a single nonzero boundary has logic and a line. Disabling Zone or an API failure clears the zones and fails open, without reusing stale data.

Processing logic: The EA scans pending orders in OnTick/OnTimer, identifies commands by both order type and price, executes them, then deletes the pending order. New Cycle OFF blocks only new chains; existing chains remain managed and can receive DCA. Stop Buy/Sell blocks all additional orders in the corresponding direction. State persists across restarts.

Processing logic: Entry is within hours if it falls inside at least one enabled window. AllowDcaOutsideHours may allow DCA management of an existing chain outside those windows.

Processing logic: Does not replace Time Limit. Real sessions use UTC/DST; custom sessions use server time.

Processing logic: The EA scans pending orders in OnTick/OnTimer, identifies commands by both order type and price, executes them, then deletes the pending order. New Cycle OFF blocks only new chains; existing chains remain managed and can receive DCA. Stop Buy/Sell blocks all additional orders in the corresponding direction. State persists across restarts.

Processing logic: Important events are always logged. Enable Debug to see why signals or gates reject an entry.