All articles
Guides

How to connect MetaTrader 4 or 5 to your trading journal

5 min read

Typing every trade into a journal by hand is the main reason people stop journaling. With the MetaTrader add-on (MT4 and MT5), each trade is recorded the moment it opens and completed when it closes — entry, exit, stop loss, lot size, commission and swap included. You only add what MetaTrader cannot know: your setup, your reasoning and how you felt.

MetaTrader 4 or 5? The steps are the same for both; only the file and the folder differ. On the MetaTrader screen in the app, choose your version first: MetaTrader 5 uses SimpleTradingJournal.ex5 and MQL5 → Experts, MetaTrader 4 uses SimpleTradingJournal.ex4 and MQL4 → Experts.

What you need

  • MetaTrader 4 or MetaTrader 5 on Windows or Mac (the desktop terminal — the mobile app cannot run add-ons).
  • A Simple Trading Journal account with at least one journal.
  • Two minutes.

1. Download the add-on

In the app, open MetaTrader from the menu, choose MetaTrader 4 or 5 and download the add-on (SimpleTradingJournal.ex5 for MT5, SimpleTradingJournal.ex4 for MT4). In MetaTrader choose File → Open Data Folder, go into MQL5 → Experts (MQL4 → Experts on MT4), and drop the file there.

On a Mac, "Open Data Folder" does not work in some builds. In Finder use Go → Go to Folder and paste the path for your version. MetaTrader 5: ~/Library/Application Support/MetaTrader 5/Bottles/metatrader5/drive_c/Program Files/MetaTrader 5/MQL5/Experts — MetaTrader 4: ~/Library/Application Support/net.metaquotes.wine.metatrader4/drive_c/Program Files (x86)/MetaTrader 4/MQL4/Experts

2. Allow the connection

MetaTrader blocks internet requests from add-ons unless you allow the address. Go to Tools → Options → Expert Advisors, tick "Allow WebRequest for listed URL" and add:

https://www.simpletradejournal.io

3. Restart MetaTrader

Close MetaTrader and open it again. SimpleTradingJournal now appears under Expert Advisors in the Navigator panel on the left.

4. Drag it onto a chart and paste your key

In the app, create a connection key (it starts with stj_). Drag SimpleTradingJournal onto any chart, open the Inputs tab, paste the key into ApiKey and click OK. When the top-left of the chart shows that the connection is working, you are done. It also shows which journal the trades go to (Journal: …) — check that it is the one you expect.

Each key belongs to one journal and locks to the first trading account that connects with it, so trades from two accounts never mix in the same journal. For a second account, create a second key.

Which chart should it go on?

MetaTrader runs one expert advisor per chart. If you already use another EA, open a new, empty chart just for the journal add-on and leave it open — every closed trade then arrives on its own while you keep trading on your other charts. If you would rather not keep an extra chart, you can drop the add-on on a chart only when you want to sync; it catches up on everything closed in between.

What gets recorded

  • Symbol, direction, lot size, entry and exit price and time.
  • Stop loss and take profit. The stop you entered with is kept even if you move it later, so your risk and R-multiples stay honest.
  • Gross result, commission and swap, and the net result.
  • On MetaTrader 5, a position closed in parts (TP1, TP2…) is recorded as one trade once it is fully closed. On MetaTrader 4, a partial close gives the rest of the order a new number, so it shows as a separate trade.

Troubleshooting

  • Nothing arrives: check that the address in step 2 is exactly https://www.simpletradejournal.io, that the chart with the add-on is still open, and that the key was pasted without spaces.
  • "Key bound to another account": the key already belongs to a different trading account. Create a new key for this account.
  • Trades land in the wrong journal: the "Journal:" line on the chart shows where they go. If it names another journal, the add-on is still using an old key. Open its Inputs, clear ApiKey completely, paste the new key, press Enter and then OK. The old key closes by itself as soon as the new one connects.
  • On MetaTrader 4 the add-on is greyed out and cannot be dragged: use SimpleTradingJournal.ex4 downloaded from the MetaTrader screen, then right-click Expert Advisors in the Navigator and choose Refresh.
  • Lost the key: MetaTrader remembers it. If you really lost it, create a new one in the app; the old one closes by itself as soon as the new one connects.

Prefer not to install anything? You can also import MetaTrader's own report file — see the import guide.

Tools and pages for this topic

Start your journal for free

Connect MetaTrader or import your report — or look around with sample data before signing up.

You may also find useful