Setup Guide

MT5 Journal Sync

Version 1.06  ·  MetaTrader 5

HybridTrader Journal Sync · Windows

Version 1.06 · HybridTrader_Journal_Sync.zip

Download

Installing on a Mac? Go to the macOS installation guide, then return here for settings and the rest of the setup.

The HybridTrader Journal Expert Advisor runs in MetaTrader 5 and sends your trades to HybridTrader as they happen. It never opens, changes, or closes trades for you — it only watches and syncs.

1. Overview

HybridTrader needs your MetaTrader trades for your journal and stats. Attach the Journal Expert Advisor to one chart and it watches your whole account, not only that chart's symbol.

  • Live sync — Opens, closes, partial closes, and stop-loss / take-profit changes are sent as they happen.
  • History Sync — A small panel on the chart lets you send older trades for a date range you choose (for example after setup or to fill gaps).
Video walkthrough

Walkthrough: download, install, allow HybridTrader in MetaTrader, and attach the Expert Advisor to a chart.

Video not playing? Open or download the walkthrough.

2. Before you begin

  • MetaTrader 5 is installed and working.
  • A HybridTrader account and your Journal key (a long secret code). Request one using the MT5 Journal key request form. Self-service from your dashboard is coming later.
  • Internet on the computer running MetaTrader 5 so it can reach HybridTrader.

3. Installation

Download the zip using the button at the top of this page, then copy the Expert Advisor file into MetaTrader 5's Experts folder.

  1. Download and unzip. Click Download at the top of this page and save HybridTrader_Journal_Sync.zip and unzip it. Inside you will find HybridTrader_Journal_Sync.ex5.
  2. Open MetaTrader's data folder. In MetaTrader 5, open the File menu and click Open Data Folder.
  3. Go to the Experts folder. Double-click MQL5, then Experts.
  4. Copy the Expert Advisor file. Drop HybridTrader_Journal_Sync.ex5 into that Experts folder.
  5. Refresh Expert Advisors. In MetaTrader 5, open Navigator (Ctrl + N), right-click Expert Advisors, click Refresh. You should see HybridTrader_Journal.

The first time you attach the Expert Advisor, MetaTrader may prepare it automatically. If you ever need to build it yourself, right-click it in Navigator → Compile and read any messages at the bottom of MetaEditor.

Already using an older version? Use the update guide. Save your settings before you remove the old Expert Advisor so your Journal key carries over.

4. Configuration

When you attach the Expert Advisor (or later: right-click the chart → Expert Advisors → Properties → Inputs), you set options on the Inputs tab.

ConnectionAPI Keydefault: (empty)

Paste the full Journal key HybridTrader gave you, exactly as you received it. MetaTrader labels this box API Key — that is normal. The Expert Advisor uses it so HybridTrader knows it is your account.

History Sync panelPanel Cornerdefault: Top-left

Which corner of the chart the History Sync panel sits in: top-left, top-right, bottom-left, or bottom-right. Pick a corner that does not cover your candles or indicators.

History Sync panelPanel Xdefault: 14

How far the panel sits from the left or right edge of the chart, in screen pixels. Bigger number = more empty space from the edge.

History Sync panelPanel Ydefault: 30

How far the panel sits from the top or bottom edge of the chart, in screen pixels. Bigger number = more offset from the edge.

History Sync panelDefault Days Backdefault: 30

When you open History Sync, the From date starts this many days before today. You can always type any dates you want before you press Sync.

5. IMPORTANT: Allow HybridTrader in MetaTrader (one-time)

MetaTrader blocks outgoing website calls unless you add the address to an allow-list. The Expert Advisor must call HybridTrader over the internet, so you add HybridTrader's server URL once per MetaTrader install. Use the exact steps and wording below — they match the MetaTrader menus.

  1. In MetaTrader 5, open Tools Options (shortcut Ctrl + O).
  2. Open the Expert Advisors tab.
  3. Tick Allow WebRequest for listed URL.
  4. Click + and add this URL exactly (copy and paste is best):
    https://api.hybridtrader.ai
  5. Click OK to save.

Tip: If this step is missed, the Expert Advisor writes a reminder in the Experts log when it starts. Error 5203 means the URL is still not on the allowed list — repeat the steps above.

6. Attaching the Expert Advisor to a chart

Use one chart only. The Expert Advisor still sees your whole account. If you put it on several charts at once, HybridTrader may get the same trade more than once.

  1. Open any chart (symbol and timeframe do not matter; EURUSD is fine).
  2. Drag HybridTrader_Journal from Navigator onto the chart, or double-click it.
  3. On the Inputs tab, paste your Journal key into the API Keyfield (that is MetaTrader's label for your key).
  4. Change panel position inputs if you want, then click OK.
  5. You should see a small smiley icon on the chart and the HybridTrader panel. Under Terminal, open the Experts tab — you should see a line like HybridTrader Journal Expert Advisor active and monitoring.

Important: Turn on AutoTrading in the MetaTrader toolbar (button should look active / green). Expert Advisors do not run when AutoTrading is off.

7. Real-time trade monitoring

While the Expert Advisor is running with AutoTrading on, new trades and changes are sent to HybridTrader as they happen. Trades that were already open when you first attach it are still handled going forward.

Trades that happened before you installed the Expert Advisor are not replayed automatically — use History Sync in the next section to send those dates manually.

8. History Sync panel

When the Expert Advisor is running, a small panel on the chart lets you send past trades for a date range you pick.

How to use it

  1. From starts using your Default Days Back setting. To defaults to today. Change either box if you need a different range.
  2. Dates can look like 2026.05.15 (year, month, day) or with a time, for example 2026.05.15 14:30. Dashes are also fine, for example 2026-05-15.
  3. Click Sync Trade History.
  4. The line under the button turns green if it worked, red if it failed. For details, read the Experts tab in Terminal.

250 trades per sync

One sync sends at most 250 trade records (MetaTrader counts small pieces of a trade separately). If you hit the limit, shorten the date range and run sync again for the next chunk.

Running the same range twice

Safe. HybridTrader remembers what it already saved and does not create doubles for the same MetaTrader record.

9. What gets synced

While it is running, the Expert Advisor tells HybridTrader about:

  • New trades you open
  • Trades you fully close
  • Part of a trade you close early (partial close)
  • Changes to stop-loss or take-profit on an open trade

History Sync sends older trades for the dates you pick (see Section 8 for the 250-record limit per run).

Bank-style movements (deposits, withdrawals, balance-only lines) are not sent — only buy/sell trading activity.

10. On-chart panel reference

On the chart you will see a dark panel. From top to bottom:

HYBRIDTRADER JOURNALTitle at the top.
* Monitoring: ActiveGreen text means live sync is on.
LineSeparates status from History Sync.
HISTORY SYNC (max 250 deals)Heading for the manual history section.
From / ToTap to type the date range (see Section 8 for formats).
Small grey hintReminder of how dates can look.
Sync Trade HistoryButton — press to send that date range.
Line under the buttonGreen = OK, red = problem, grey = information.

Move the panel with Panel Corner, Panel X, and Panel Y on the Inputs tab (right-click chart → Expert Advisors → Properties → Inputs). Press OK to apply.

11. Troubleshooting

Open the Experts tab at the bottom of MetaTrader first — the Expert Advisor writes messages there when something goes wrong.

Error 5203 in the Experts log

Cause: MetaTrader is still blocking the HybridTrader website address.

Fix: Do Section 5 again: Tools → Options → Expert Advisors → tick Allow WebRequest for listed URL → add https://api.hybridtrader.ai with the + button → OK.

Error 5204 in the Experts log

Cause: MetaTrader cannot reach HybridTrader (internet, firewall, or server problem).

Fix: Check your connection. If it keeps happening, contact support or check HybridTrader status.

HTTP 401 in the Experts log

Cause: The Journal key is missing, wrong, or copied with extra spaces.

Fix: Right-click the chart → Expert Advisors → Properties → Inputs. Paste the key HybridTrader gave you into the API Key field. Still stuck? Submit the MT5 Journal key request form: https://tinyurl.com/HTJournalBug

No HybridTrader panel on the chart

Cause: AutoTrading is off, or the Expert Advisor stopped when it started.

Fix: Turn AutoTrading on. Read the Experts tab for red text. Remove the Expert Advisor from the chart and drag it on again.

No smiley icon on the chart

Cause: Same as above — the Expert Advisor is not running.

Fix: Turn AutoTrading on. Read Experts and Journal tabs. If you changed program files yourself, open MetaEditor and try Compile from the Navigator.

History Sync shows 'HistorySelect failed'

Cause: MetaTrader could not read history for those dates (uncommon, often temporary).

Fix: Press Sync again. Restart MetaTrader if it repeats. Read Experts for more detail.

'No deals found in selected date range'

Cause: That range has no buy/sell trades — only things like deposits, which we skip on purpose.

Fix: Widen the dates or check in MetaTrader Account History that trades exist in that period.

'250 limit reached'

Cause: Too many trade records for one run (see Section 8).

Fix: Use a shorter date range, sync, then repeat for the next dates.

Stop-loss / take-profit changes missing in HybridTrader

Cause: The trade was already open before you attached the Expert Advisor, so the first values were saved as the starting point.

Fix: The first change after attach may not show as an 'edit'. Later edits to stop-loss or take-profit on that same trade should appear.

12. Limitations

  • One chart. Running on more than one chart at the same time can send the same trade twice. Keep a single chart.
  • History Sync size. Each button press sends up to 250 records — use several smaller date ranges if you need a long history (Section 8).
  • Very large accounts. If you rarely run more than ~200 open trades at the same time, you can ignore this. Above that, some stop-loss / take-profit edits might not be tracked — contact HybridTrader if that applies to you.
  • Offline. If MetaTrader is closed or has no internet when a trade happens, that moment is not saved for later. When you are back online, use History Sync to fill the gap.
  • Price charts. The Expert Advisor sends trade records only, not every price tick. HybridTrader gets chart prices from other systems.

13. Frequently asked questions

Does the Expert Advisor place trades for me?

No. It only reads your trades and sends copies to HybridTrader. It never sends orders to your broker.

Which chart or timeframe should I use?

Any chart is fine — the whole account is watched. Many people pick a quiet pair (for example EURUSD) on a higher timeframe so the chart stays tidy.

Will it slow MetaTrader down?

You should not notice a difference. It wakes up when trades change, not on every price tick.

Does it work on a VPS?

Yes, same steps as on your home PC. The VPS needs normal internet access to HybridTrader (secure web traffic on port 443).

What if I close MetaTrader while I have open trades?

Anything that happens while MetaTrader is off is not sent live. When you open MetaTrader again, use History Sync to send the missing dates.

Can I use a demo account?

Yes. Demo and live trades are sent the same way.

Is my Journal key safe?

MetaTrader stores it in your Inputs like any other Expert Advisor setting. Treat it like a password: do not share it or put it in screenshots. Submit the MT5 Journal key request form (https://tinyurl.com/HTJournalBug) for a new key if you think someone else saw it.

How do I install a new version?

Use the update guide: save your settings first (Inputs → Save), install the new file, attach the new Expert Advisor, then load your saved settings (Inputs → Load).

Need help that isn't covered here? Contact support with a short note about what you tried and a copy of the lines from the Experts tab in MetaTrader.