══════════════════════════════════════════════════════════════════════
YAKUZA EA V3.0 — BREAKOUT EDITION
Copyright 2026, Ahmed Ibrahim. All Rights Reserved.
══════════════════════════════════════════════════════════════════════
─────────────────
3. How the Technique Works
4. Enter Parameters Reference
4.2 S1: Breakout
4.3 S1: Time Filter
4.4 Information Filter
4.5 Lot Sizing
5. Lot Dimension Modes Defined
6. Information Filter Defined
9. Backtesting Notes
══════════════════════════════════════════════════════════════════════
══════════════════════════════════════════════════════════════════════
Yakuza EA V3.0 Breakout Version is a totally automated Professional Advisor
for MetaTrader 5 that trades swing-level breakouts utilizing pending
BuyStop and SellStop orders.
– Swing excessive/low detection with configurable lookback depth
– Pending order placement with computerized expiration
– Step-based trailing cease loss
– Session time filter (dealer time or GMT)
– Financial information filter utilizing the MQL5 built-in calendar
– Automated place closing on information occasions (non-obligatory)
– 5 lot-sizing modes together with proportion danger
– Actual-time on-chart dashboard
– Telegram notifications for trades, each day/weekly experiences,
and safety occasions
– Works on any image and any timeframe
══════════════════════════════════════════════════════════════════════
══════════════════════════════════════════════════════════════════════
Step 1 — Connect to a chart
In MT5 Navigator panel (Ctrl+N), increase Professional Advisors, discover
“Yakuza_EA_V3_Breakout”, and drag it onto your required chart.
Step 2 — Allow algo buying and selling
Make certain the “Algo Buying and selling” button on the MT5 toolbar is enabled
(it ought to seem inexperienced, not purple).
Step 3 — Permit net requests (for Telegram)
If utilizing Telegram notifications, go to:
Instruments → Choices → Professional Advisors
Verify “Permit WebRequest for listed URL” and add:
══════════════════════════════════════════════════════════════════════
3. HOW THE STRATEGY WORKS
══════════════════════════════════════════════════════════════════════
The EA runs on every new bar and performs the next steps:
The EA scans the final 200 bars in search of swing highs and
swing lows. A swing excessive is a bar whose excessive is the very best
inside S1_BarsN bars on either side. A swing low is the
reverse — the bottom low throughout the similar window.
2. PENDING ORDER PLACEMENT
If there isn’t a current purchase place or purchase pending order,
the EA locations a BuyStop at the latest swing excessive.
If there isn’t a current promote place or promote pending order,
it locations a SellStop at the latest swing low.
Every pending order will get:
– A cease loss at S1_Slpoints distance from entry
– A take revenue at S1_Tppoints distance from entry
– An expiration time of S1_ExpirationBars bars from now
Earlier than inserting orders, the EA checks:
– Time filter: Is the present hour throughout the allowed
buying and selling session? If not, all pending orders are deleted.
– Information filter: Is a high-impact information occasion imminent or
in progress? In that case, pending orders are deleted and
optionally open positions are closed.
On each tick, the EA checks all open S1 positions. As soon as
worth has moved S1_TslTriggerPoints in revenue, the cease
loss is trailed in steps of S1_Tslpoints behind the
present worth. The path solely strikes within the favorable
course — it by no means strikes backward.
Positions are closed by both:
– Take revenue being hit
– Cease loss (unique or trailed) being hit
– Pending order expiration (if by no means triggered)
– Information filter closing positions (if NewsCloseOnEvent=true)
══════════════════════════════════════════════════════════════════════
4. INPUT PARAMETERS REFERENCE
══════════════════════════════════════════════════════════════════════
───────────────────────────────────────────────────────────────────
────────────────────────────────────────────────────────────────────
Magic (default: 696969)
Distinctive magic quantity that identifies this EA’s trades. For those who
run a number of EAs on the identical account, every should have a
completely different magic quantity.
EA_Comment (default: “Yakuza EA”)
Remark string connected to each order and place opened
by this EA. The EA appends ” S1″ to establish breakout trades.
────────────────────────────────────────────────────────────────────
────────────────────────────────────────────────────────────────────
S1_BarsN (default: 3)
Variety of bars on either side required to verify a swing
level. A worth of three means a swing excessive should be greater than
the three bars earlier than it and the three bars after it (7-bar window).
Larger values produce fewer however stronger breakout ranges.
S1_OrderDistPoints (default: 0)
Distance between Excessive/Low to position the pending order
S1_ExpirationBars (default: 50)
Variety of bars after which an unfilled pending order is
routinely cancelled by the dealer. On H1 this implies
roughly 50 hours; on M15 it means about 12.5 hours.
S1_Tppoints (default: 1000)
Take revenue distance in factors from the entry worth.
On a 5-digit dealer, 1000 factors = 100 pips for foreign exchange.
On gold (2-digit), 1000 factors = 10.00 worth distance.
S1_Slpoints (default: 400)
Cease loss distance in factors from the entry worth.
Identical level/pip conversion as above.
S1_Tslpoints (default: 50)
Trailing cease step measurement in factors. As soon as the path is
activated, the cease loss follows worth at this distance.
S1_TslTriggerPoints (default: 50)
Minimal revenue in factors earlier than the trailing cease
prompts. The place should be not less than this far in
revenue earlier than any trailing begins.
────────────────────────────────────────────────────────────────────
────────────────────────────────────────────────────────────────────
S1_TradingTime (default: true)
Allow or disable the session time filter. When enabled,
the EA solely locations new pending orders throughout the allowed
hours. Present pending orders are deleted exterior the
allowed session. Open positions are NOT closed by this
filter — solely pending orders are affected.
S1_TimeSelection (default: BROKER_TIME)
Which clock to make use of for the time filter.
BROKER_TIME = server time returned by TimeCurrent()
GMT_TIME = UTC/GMT time returned by TimeGMT()
S1_TradingStartHour (default: 7)
Hour (0–23) when the buying and selling session begins.
S1_TradingEndHour (default: 18)
Hour (0–23) when the buying and selling session ends.
In a single day classes are supported: if StartHour > EndHour
(e.g. Begin=22, Finish=6), the EA trades from 22:00 by means of
────────────────────────────────────────────────────────────────────
────────────────────────────────────────────────────────────────────
UseNewsFilter (default: true)
Allow the financial calendar information filter. When a qualifying
information occasion is throughout the buffer window, the EA blocks new
order placement and deletes current pending orders.
NewsMinsBefore (default: 15)
Minutes earlier than a information occasion to start blocking.
NewsMinsAfter (default: 15)
Minutes after a information occasion to proceed blocking.
NewsHighOnly (default: true)
When true, solely high-impact (purple) occasions set off the
filter. When false, each excessive and medium-impact occasions
NewsCloseOnEvent (default: false)
When true, all open positions (not simply pending orders)
are instantly closed when a information block begins. Use with
warning — this may force-close worthwhile trades.
NewsCountry (default: “US”)
Nation code to filter occasions by. The filter checks if
the occasion’s nation code comprises this string. Frequent
values: “US”, “EU”, “GB”, “JP”, “AU”, “CA”, “CH”, “NZ”.
To match a number of international locations, you would wish to run
separate EA cases or modify the code.
───────────────────────────────────────────────────────────────────
────────────────────────────────────────────────────────────────────
LotSizeMode (default: FIXED_LOTS)
Selects which lot calculation methodology to make use of.
See Part 5 for an in depth rationalization of every mode.
RiskPct (default: 3.0)
The proportion worth utilized by PCT_ACCOUNT_BALANCE,
PCT_EQUITY, and PCT_FREE_MARGIN modes.
FixedRiskAmount (default: 50.0)
Greenback quantity risked per commerce when utilizing
FIXED_RISK_PER_TRADE mode.
FixedLotSize (default: 0.05)
Lot measurement utilized in FIXED_LOTS mode and as a fallback
if any dynamic calculation fails.
MaxLotSize (default: 0.0)
Exhausting cap on lot measurement. Set to 0.0 to disable the cap.
When set to a optimistic worth, no commerce will exceed
this lot measurement whatever the calculated quantity.
────────────────────────────────────────────────────────────────────
────────────────────────────────────────────────────────────────────
TG_Enabled (default: true)
Grasp change for all Telegram notifications.
TG_BotToken (default: “”)
Your Telegram bot token from @BotFather.
Instance: “1234567890:ABCDefGhIjKlMnOpQrStUvWxYz”
TG_ChatID (default: “”)
Your Telegram chat or group ID.
Instance: “-1001234567890” for a bunch, or “123456789”
for a personal chat.
TG_TradeAlerts (default: true)
Ship a notification when a commerce opens or closes.
TG_DailyReport (default: true)
Ship a each day abstract report.
TG_DailyReportHour (default: 23)
Hour (dealer time) to ship the each day report.
TG_WeeklyReport (default: true)
Ship a weekly abstract report (Fridays solely).
TG_WeeklyReportHour (default: 22)
Hour (dealer time, Friday) to ship the weekly report.
TG_ProtectionAlerts (default: true)
Ship a notification when a safety occasion triggers,
akin to a information block activating.
────────────────────────────────────────────────────────────────────
────────────────────────────────────────────────────────────────────
VerboseLog (default: false)
When enabled, the EA prints detailed debug messages to
the MT5 Specialists log tab. Helpful for troubleshooting.
Hold disabled in manufacturing to scale back log file measurement.
────────────────────────────────────────────────────────────────────
────────────────────────────────────────────────────────────────────
ShowDashboard (default: true)
Show the on-chart data panel.
DashBgColor (default: C’8,5,12′)
Background colour of the dashboard panel.
DashTextColor (default: C’210,200,225′)
Default textual content colour for values.
DashGreenColor (default: C’40,200,100′)
Colour used for optimistic values and lively standing.
DashRedColor (default: C’220,35,25′)
Colour used for unfavorable values and losses.
DashAccentColor (default: C’200,30,20′)
Colour used for labels and the panel border.
DashFontSize (default: 12)
Font measurement in pixels for dashboard textual content.
Horizontal offset from the left fringe of the chart.
Vertical offset from the highest of the chart.
══════════════════════════════════════════════════════════════════════
5. LOT SIZE MODES EXPLAINED
══════════════════════════════════════════════════════════════════════
All dynamic modes calculate lot measurement based mostly on the cease loss
distance of every particular person commerce. The components is:
heaps = risk_amount / (SL_distance_in_ticks × tick_value)
The 5 accessible modes:
Each commerce makes use of precisely the FixedLotSize worth.
Easy and predictable, however doesn’t adapt to account
development or various cease loss distances.
Threat quantity = Account Stability × RiskPct / 100
Greatest for: Regular compounding based mostly on realized positive aspects.
Threat quantity = Account Fairness × RiskPct / 100
Fairness consists of unrealized floating P&L. Lot sizes
improve when you have got successful open trades and reduce
when you have got dropping ones.
Threat quantity = Free Margin × RiskPct / 100
Free margin is fairness minus margin utilized by open positions.
That is essentially the most conservative dynamic mode as a result of lot
sizes shrink as you open extra positions.
Threat quantity = FixedRiskAmount (in account forex)
Dangers precisely the required greenback quantity per commerce
no matter account measurement.
Security options constructed into all modes:
– Lot measurement is clamped to the image’s minimal and most
– Lot measurement is rounded all the way down to the closest legitimate step
– MaxLotSize cap is enforced if set
– A margin test ensures the account can afford the commerce;
if not, lot measurement is lowered till it matches
══════════════════════════════════════════════════════════════════════
6. NEWS FILTER EXPLAINED
══════════════════════════════════════════════════════════════════════
The information filter makes use of the MQL5 built-in financial calendar
(CalendarValueHistory) to detect upcoming occasions. It does NOT
require any exterior information, downloads, or indicator dependencies.
1. On each tick, the EA queries the calendar for occasions
throughout the time window:
from: now − NewsMinsAfter
to: now + NewsMinsBefore + 60 minutes
2. It filters occasions by:
– Nation code matching NewsCountry
– Significance stage (excessive solely, or excessive + medium)
3. If the present time falls throughout the blocking window
of any matching occasion (NewsMinsBefore earlier than by means of
NewsMinsAfter after the occasion time):
– All pending S1 orders are instantly deleted
– If NewsCloseOnEvent is true, all open positions
are additionally closed
– No new orders are positioned till the block clears
– A Telegram alert is distributed (if TG_ProtectionAlerts)
4. The dashboard exhibits the information filter standing in actual time:
“Clear” — no close by occasions
“Subsequent: NFP in 45m” — upcoming occasion with countdown
“BLOCKED: NFP” — presently in a blocking window
The MQL5 calendar requires an lively web connection
and solely works with a dwell or demo account. It does NOT
perform within the Technique Tester (backtesting). Throughout
backtests the information filter is successfully disabled.
══════════════════════════════════════════════════════════════════════
══════════════════════════════════════════════════════════════════════
Open Telegram, seek for @BotFather, and ship /newbot.
Comply with the prompts. You’ll obtain a bot token like:
1234567890:ABCDefGhIjKlMnOpQrStUvWxYz
Step 2 — Get your chat ID
Choice A (non-public chat): Seek for @userinfobot on
Telegram and ship it any message. It replies together with your ID.
Choice B (group chat): Add your bot to the group, ship a
message, then go to in your browser:
Search for the “chat”:{“id”: worth within the JSON response.
Step 3 — Permit the URL in MT5
Go to Instruments → Choices → Professional Advisors, test
“Permit WebRequest for listed URL” and add:
Step 4 — Enter your credentials
Set TG_BotToken and TG_ChatID within the EA inputs.
Startup message — despatched when the EA initializes, confirms
it’s operating and exhibits the image and stability.
Commerce opened — despatched when a pending order fills, exhibiting
entry worth, SL, TP, lot measurement, and course.
Commerce closed — despatched when a place exits (SL, TP, or
compelled shut), exhibiting P&L, open/shut costs, and much.
Safety alert — despatched when the information filter blocks
buying and selling, exhibiting the occasion title and time.
Day by day report — despatched as soon as per day at TG_DailyReportHour,
exhibiting stability and day P&L.
Weekly report — despatched on Fridays at TG_WeeklyReportHour,
exhibiting the present stability.
══════════════════════════════════════════════════════════════════════
══════════════════════════════════════════════════════════════════════
The on-chart dashboard shows the next data,
─── ──────────────────────────────────────────────────
1 Title: YAKUZA AI V3.0 · BREAKOUT
3 Buying and selling image
4 Fairness P&L (present fairness minus stability)
5 Day P&L (fairness minus start-of-day stability)
6 Technique standing (S1 Breakout ON)
7 Information filter standing (Clear / Subsequent occasion / BLOCKED)
8 Open positions (Purchase depend, Promote depend)
9 Pending orders (BuyStop depend, SellStop depend)
10 Working time in days since EA was connected
The dashboard is routinely eliminated when the EA is
faraway from the chart or when the chart is closed.
To reposition the dashboard, regulate DashX and DashY. To
cover it completely, set ShowDashboard to false.
══════════════════════════════════════════════════════════════════════
══════════════════════════════════════════════════════════════════════
PROBLEM: EA is on the chart however not buying and selling.
– Is “Algo Buying and selling” enabled (inexperienced button on toolbar)?
– Is the EA throughout the allowed buying and selling hours?
– Is the information filter presently blocking?
– Verify the Specialists tab (Ctrl+E) for error messages.
– Allow VerboseLog=true for detailed output.
PROBLEM: “Commerce request failed” errors within the log.
– Is the market open for this image?
– Does the account have enough free margin?
– Are SL/TP distances respecting the dealer’s minimal
stops stage? The EA checks this routinely, however
some brokers have very huge minimums.
PROBLEM: Telegram messages will not be being obtained.
URLs in Instruments → Choices → Professional Advisors?
– Is TG_BotToken and TG_ChatID appropriate?
– Has the bot been added to the group (if utilizing a bunch)?
– Verify the Specialists tab for WebRequest errors.
PROBLEM: Pending orders are being deleted repeatedly.
– The time filter deletes pending orders exterior the
allowed session. Verify S1_TradingStartHour and
S1_TradingEndHour.
– The information filter deletes pending orders when a block
prompts. Verify the dashboard Information row.
– A really brief S1_ExpirationBars worth causes orders
to run out shortly. Improve it.
PROBLEM: Dashboard shouldn’t be seen.
– Is ShowDashboard set to true?
– The dashboard could also be offscreen. Reset DashX=12 and
– Zoom out or scroll the chart — the dashboard is
anchored to the top-left nook.
PROBLEM: Lot measurement is at all times the minimal.
– If utilizing a dynamic mode, the cease loss distance
could also be very giant relative to the chance quantity,
leading to a tiny calculated lot measurement.
– Verify that RiskPct or FixedRiskAmount is about to
an inexpensive worth.
– Verify the Specialists log with VerboseLog=true.
══════════════════════════════════════════════════════════════════════
══════════════════════════════════════════════════════════════════════
V3.0 — Breakout Version (2026)
– Information filter utilizing MQL5 built-in calendar
– Elective place closing on information occasions
– Telegram notifications by way of POST/JSON (dependable
supply of particular characters and emoji)
– On-chart dashboard with real-time updates
– 5 lot-sizing modes with margin security test
– Session time filter with in a single day assist
– Step trailing cease loss
══════════════════════════════════════════════════════════════════════
══════════════════════════════════════════════════════════════════════
Buying and selling overseas alternate, commodities, and different monetary
devices carries a excessive stage of danger and will not be
appropriate for all traders. Previous efficiency shouldn’t be indicative
of future outcomes. Try to be conscious of all of the dangers
related to buying and selling and search recommendation from an impartial
monetary advisor if in case you have any doubts. The creator shouldn’t be
accountable for any losses incurred by means of the usage of this
══════════════════════════════════════════════════════════════════════
Copyright 2026, Ahmed Ibrahim. All Rights Reserved.
══════════════════════════════════════════════════════════════════════
