User guide

1. Unzip the panel package (the zip containing ForexSentimentPanel.ex5) anywhere on your PC.
2. In MT5, open File → Open Data Folder (or press Ctrl+Shift+D).
3. In the window that opens, enter MQL5 → Experts and copy ForexSentimentPanel.ex5 into it.
4. Back in MT5, open the Navigator (Ctrl+N), right-click Expert Advisors and choose Refresh, or simply restart the terminal. ForexSentimentPanel then appears in the list.
5. Authorize the data connection. Go to Tools → Options, open the Experts tab, tick “Allow WebRequest for listed URL” and add exactly this address:
   https://forexsentiment.live
   then press OK. This is the only address the panel talks to. Without it, the panel cannot load any data.
6. At the top of that same tab, check that “Allow algorithmic trading” is ticked. Check as well that the Algo Trading button in the toolbar is on.
7. Open the chart you want to dedicate to the panel (any symbol and timeframe) and drag ForexSentimentPanel onto it from the Navigator. The panel fills the whole chart, so it is worth giving it one of its own.
8. In the dialog that opens, check on the Common tab that algorithmic trading is allowed for this EA. Then go to the Inputs tab, paste your code into “License code” and press OK.

The panel’s three inputs

The Inputs tab is where the panel is set up, and you can reopen it at any time with F7 on the chart.

• License code — the code from your purchase. It binds to this MT5 account the first time the panel connects.
• Magic number — the identifier MT5 stamps on every order the panel sends. It is how the panel tells its own trades from the ones you place by hand, and three things depend on it: the Positions filter, the protection rules and the performance stats. Leave it as it is, unless another EA on the same account already uses that number. Above all, do not change it while panel trades are open: those carry the previous number, so the panel would stop recognizing them as its own. They stay on the account, with their stop-loss and take-profit still held by the broker, but the panel no longer manages them.
• Panel size % — scales the whole panel, fonts included. The default is 135 and the maximum is 200: raise it on a large or high-resolution screen, lower it if the panel does not fit.

Updating to a new version

When a new build ships, the order of the steps matters: close MT5 first, then replace ForexSentimentPanel.ex5 in MQL5 → Experts with the new file, and only then open the terminal again. MT5 has to be closed first for a simple reason: while the panel is running that file is in use, and the copy can fail without showing any error message.

When you reopen MT5 the panel comes back on its chart with your settings and your license already loaded, so there is nothing to enter again. The one exception is a field that did not exist in the previous build: that one starts empty the first time, which is what happened to License code when it was introduced.

• On the first connection with your code, the panel binds the license by itself to the MT5 account it is running on. What counts is the account number, not the PC, and from then on the rule is one license = one MT5 account.
• To use the panel on a different account you need two steps, in this order: first unlink the current account from your licenses page (see Your account), then start the panel on the new account, which binds by itself. Until you unlink it, the license stays where it is: it never moves from one account to another on its own.
• Once active, the panel loads the retail positioning and the signals (both refreshed about every 3 hours) and the AI Daily Forecast (published every trading night). A banner warns you when the license has 5 days or less left, and also when a payment has failed.

Reinstalling Windows or MT5, or moving to a VPS, needs nothing special: the license follows the MT5 account and not the computer, so the same code simply works again.

The panel takes over the whole chart you open it on, so it is worth keeping one chart dedicated to it. If you need to see the candles again there is no need to close it: the chevron at the top right of its header collapses it to a single bar, and pressing it again brings it back to full size. Inside there are five tabs.

• Sentiment — the retail positioning on the 29 markets, refreshed about every 3 hours, with each pair’s history and, one click away, the signal and the plan for that pair (see Sentiment).
• Signals — the site’s aggregated signals for all 29 markets, refreshed about every 3 hours, with filters and one-click manual trading.
• AI Forecast — the AI trade plan of the day for every pair that offers one (entry, stop, two targets and its expected value), published every trading night, with the verified record of each pair inside its row.
• Positions — what is open on the account, by default only the panel’s own trades, with breakeven and close controls and the panel’s performance history.
• Manage — the optional protections, which can only close and which you apply to the whole account or to the panel’s own trades: max loss, max profit, trailing and close before rollover.

In the header you have the data timestamp and the time left to the next check (“check 3m”), the “?” button with the full built-in help, and the arrow that refreshes immediately. In the footer: Balance, Equity and Free margin. The first time, the panel opens on Sentiment with a six-step guided tour, one step per tab plus the welcome; you can replay it from Settings. Lists and overlays scroll with the mouse wheel and with the keyboard too (arrows, Page Up and Page Down), and a thin marker on the right edge shows where you are in a long list. On a narrow chart the tab labels shorten by themselves.

The first tab shows retail positioning on the same 29 markets: the share of retail traders long versus short on each pair. It refreshes about every 3 hours on weekdays, and the line under the filters says when it was last updated. This is never a live tick.

Reading a row:

• The bar splits retail positioning into long (green) and short (red); under it, the two numbers in the same order (“18 / 82”). The big figure next to it is the dominant side: “82% short” means the retail book on that pair is 82% short.
• Under the pair, the change of the long share over the window you chose (“21D +6”: six points more long than at the start of the window).
• CROWD (on wide panels) says how one-sided the book is: Balanced under 60% on either side, Crowded from 60%, Extreme from 75%.
• SIGNAL and AI PLAN are two pills showing what the signal engine and the plan of the day say about that pair (LONG, SHORT, NEUT, or a dash when there is none). Together with the bar they give you the contrarian read at a glance: retail 82% long, engine short.
• The bell mutes the retail-positioning alert for that pair.

Read it the way the signal engine does, that is, contrarian: a crowd heavily on one side has usually chased a move, so an extreme reading counts against it. Sentiment is one of the five weighted factors of the engine, and the expanded row shows the score it gets (“factor score -0.77”, for example).

Expand a row for the chart of the long share over 7, 21 or 30 days (the window is the last chip of the filter bar; 21 days by default, as on the site). Days without a reading are simply skipped, never filled in. Under the chart: the current long share, the change and the range over the window, the crowd band, and the Engine read line with the sentiment factor’s reading and score. The two buttons, See signal and See AI plan, open the pair sheet described below.

The filters above the list: Side (all pairs, or only those whose retail majority is long or short), Min (a minimum one-sidedness, from 60% to 80%), Sort (most one-sided first, by default; then by change over the window, or A–Z) and the History chip for the window.

The pair sheet

Clicking a SIGNAL or AI PLAN pill, or one of the two buttons in the expanded row, opens the pair sheet: a card with two segments, Signal and AI plan, each showing exactly what the corresponding tab shows for that pair — the row, its expanded detail and the order form. Same SL and TP modes, same S1–S3 / R1–R3 chips, same TP Cons and TP Opt, Entry Plan or At market and REVERSE, same confirmation and the same safety floors: an order placed from the sheet is identical to one placed from the tab. On a short chart the sheet scrolls; Esc closes it, and the link in its footer opens the same pair in its own tab.

Reading a row:

• Consensus bar (e.g. 74/26): how strongly the combined factors lean long or short. Note that it is not raw trader positioning, because retail sentiment is only one ingredient of the blend.
• Strength (purple bar, 0–1): the same lean as a single number. As a practical scale, around 0.15 the signal is weak, 0.30 is decent and 0.40 or more is strong.
• LONG/SHORT + HIGH/MED/LOW: the direction of the lean and the confidence, that is, how much the factors that took a side agree with one another. VOL is the pair’s volatility regime instead: it describes the state of the market, it does not judge the trade.
• The FX strip above the list ranks the 8 currencies from strongest to weakest, computing the ranking across all the signals together. A purple dot next to a symbol means its direction or its confidence changed in the latest refresh.

To trade one, expand the row. In Auto, the stop and the target come pre-filled from the AI support and resistance levels, subject to a minimum distance and a ratio of at least 1:1. The S1–S3 / R1–R3 chips under the form pin them to any of the published levels instead — up to three per side, named for the side of your order: on a buy the stop chooses among the supports and the target among the resistances, on a sell the roles swap. If you would rather set the distances yourself, switch to Pips or Money. Before you click, the row shows the estimated risk, the potential profit and the R/R.

SELL and BUY send a market order, but first they open a confirmation dialog, on by default. That dialog also warns you in three cases that are easy to miss: a position already open on the pair, correlated positions, and two or more trades stacking on the same currency.

Each plan covers one trading day: entry, stop and two targets, which the server validates against real volatility before publishing them. Of the two targets, TP Cons is the closer one and the one price reaches more often, while TP Opt is the farther one; you pick which to use in the expanded row.

Next to them is one more number. EV is what the plan is worth per 1R risked, counting all three ways a filled plan can end: the target, the stop, or the window closing with the trade still open. It is an average over a long run of plans, not a promise about this one, and it is priced on the verified record rather than on an assumption. The TOP label marks the AI’s favorite setups, and below them the list is sorted by EV. Pairs the AI reads as directionless get no plan at all, which is why the tab lists fewer than 29 plans.

• Every plan is a limit order. The entry is a pullback from the price at the time the plan was written, so the published numbers hold whenever you place it. The order type is written on the PLACE button, and the pending order expires when the plan’s trading window closes.
• A plan can only be placed inside its window. Before it opens, the row says “plan not live yet” and shows a STARTS chip; after it closes, it says “plan window closed”.
• Under the pair, “now ±x” is where the market sits against the entry. entry taken means today’s candles have actually reached the entry from the right side. entry gone (amber) means price has gone through it, and at that point a pending order no longer makes sense: if you still want in, Entry: At market fills now at the current price, keeps the plan’s stop and target, and recomputes risk, lot and R/R on that price.
• The SL HIT and TP1 HIT chips come from today’s real candles. A plan whose stop was already hit can still be placed: the panel flags it everywhere, but leaves the decision to you.
• REVERSE takes the plan from the opposite side. The entry stays the same, while the stop and the target are rebuilt from the plan’s own levels: it is not simply the two of them swapped over, as you might expect. Reversed rows show no EV, because that number belongs to the original direction, and their trades are tracked separately.

Batch (N), in the sub-bar under the Signals and AI Forecast tabs, opens the filtered list with a tick box on every row. At the top are the controls that apply to the whole selection: lot, SL and TP (plan levels, or auto · pips · money · none) and — signals only — the S/R level row, which pins every stop or target to the Nth published level of each pair’s own side (the numbers are 1–3 rather than S/R because the side changes row by row: a sell protects a resistance).

Each row shows its own lot, the risk and the target in account currency, the R/R, and the badges that apply to it: OPEN if you already hold a position on the pair, AT MARKET if price is already at the entry, then SL HIT and REV. The footer totals the risk of the selection, which turns red above 5% of equity; the send button, for its part, counts only the orders that can actually be placed.

• Three quick chips narrow the list without touching the tab filters: direction (neutrals included), Ready only and Hide open. Note that what a quick filter hides is not placed, even if it was ticked.
• Neutral signals never get a default side. The row stays dashed until you tap L or S yourself, and not even Select all can send one by accident.
• A pair without the chosen level unticks itself. Pick S/R level 3 and a pair that only publishes two: the row unticks, shows dashes and says “no S3 level” in grey. It is never moved silently to a different level, and Select all skips it.
• The Sort chip reorders the rows (Forecast: EV → R/R → A-Z; Signals: Strength → A-Z), and ticks travel with their pair.

Positions shows the panel’s own trades by default. The Panel/All toggle switches to the whole account, where panel trades stay recognizable by their indigo dot. On each position you get live P/L, one-click breakeven and a single close; there are also cancel pending and Close positions. All of these ask for confirmation, and act only on what the filter is showing at that moment.

At the bottom of the tab, Panel Performance sums up the panel trades closed over the last 12 months: win rate, net P/L, profit factor and the split between AI-plan trades, TOP picks, signal trades and REVERSE orders.

Manage holds the optional protections. They are all off until you set a value, and none of them can open anything: they can only close or protect. They are:

• max floating loss and max floating profit on open positions;
• profit trailing: it arms at one level and closes at another, which follows every new peak; it survives terminal restarts;
• Plan autopilot: acts only on trades born from an AI plan and opened inside the current plan window, moving the stop to entry as soon as TP Cons is touched;
• SET ALL SL TO BREAKEVEN and CLOSE ALL, the two buttons that act in one go;
• close before rollover: closes a few minutes before the broker’s daily boundary, or before the session close when that comes first — on a Friday, or on metals and indices. That is when spreads widen enormously.

Each rule can be applied to the whole account or to panel trades only. The Scope chip at the top says which one is active: out of the box it is the whole account, so a max floating loss would also close positions you opened by hand or with another EA.

Alerts. The bell in the filter bar decides what triggers a notification. For the signals it gives you two routes: the filters you are already applying to the list, or your own criteria (direction, confidence, volatility, consensus, minimum strength); an engine consensus crossing 70, 75 or 80% on one side has an alert of its own (Signal consensus, with its threshold chip). Retail positioning is a separate family, with its own settings behind the bell of the Sentiment tab and its own switch, independent of the signal alerts: it fires when a pair crosses the threshold you set, 65, 70 or 75% on either side, once per crossing and as one message when several pairs cross together. Turn Side switch on as well and it also fires when the retail majority moves from long to short or back, with the new side at 55% or more. The card also shows how many row bells are muted, with Mute all / Unmute all to keep only the pairs you follow.

The bells on individual rows do a different job on each tab: on Sentiment rows they mute that pair’s retail-positioning alert, in the signals list they mute a pair’s signal alerts, and on Forecast rows they do the opposite — they arm an alert, off by default, that fires when price reaches the plan entry inside the hours the plan is live. The channels are chosen in Settings: popup, sound, MT5 push to your phone, and email.

Settings is the gear in the footer of the panel, and it holds the default lot and the sizing mode, the SL buffer, the drift threshold, the refresh frequency, the slippage, the alert channels, the order confirmations and the Replay of the guided tour. The panel size is not here: that one is an EA input (F7 → Panel size %).

Everything is managed at forexsentiment.live/my-licenses, with no password:

1. Enter the email you used at purchase and press “Email me a sign-in link”.
2. Open the link from your inbox. It lasts 30 minutes and works once, but you can request a new one anytime, up to 5 per hour. You then stay signed in for about an hour.

For each license you see the code, its status, the plan with its renewal or expiry date, and the MT5 account it is linked to. From this page you can:

• unlink the account (Unlink MT5 account): this frees the code, so the next panel that uses it binds to its own account. It is how you move the panel to another broker or another account;
• download the panel and this guide, always in the current version;
• manage billing (Manage billing): this opens the secure Stripe customer portal, where you can update your card, download invoices or cancel a subscription. Cancelling keeps the license active until the end of the period you have already paid for; it simply does not renew.

While the feed is locked, the panel re-checks by itself once an hour. The exception is a service-side “temporarily unavailable”, which is on us and not on you: there the panel keeps its normal pace. Either way, once you have fixed things there is no need to wait, because the Check again button forces an immediate check.

A network problem is not a license problem. When forexsentiment.live cannot be reached, the panel keeps working on the last data it saved, for up to 72 hours, and says so in a banner. Meanwhile the stop-loss and take-profit attached to your orders hold at the broker, even with MT5 closed.

Write to [email protected] or use the form at forexsentiment.live/contact. Replying to the email that carried your license works too. Always include your license code, and never send card details by email.