TradeLista
Setup guide

Get your trades into TradeLista

Auto-sync every closed trade with the MT4/MT5 Expert Advisor, or add trades yourself in a few clicks — both land on the same calendar.

How do you want to add trades?
ℹ️
The EA only sends trades while your desktop terminal is running, with the EA attached to a chart. A trade you place from your phone still syncs automatically as long as your desktop is running at the time; if your desktop is closed when the trade happens, add that trade to TradeLista manually. (On startup it also re-sends recent closed trades as a best-effort catch-up — see the CatchUpDays note in step 8.)
1

Install MetaTrader 54

Already have it installed? Skip to step 2.

Go to metatrader5.com/en/download and click "Download MetaTrader 5". Open the downloaded file and click through the installer — the default settings are fine.

Go to metatrader4.com/en/download and click "Download MetaTrader 4" (or ask your broker for their MT4 installer, if they provide their own branded one). Open the downloaded file and click through the installer — the default settings are fine.

MetaTrader 5 installer window
📷 Screenshot: the MT5 installer window
The MetaTrader 4 download page with Download for Windows highlighted
📷 Screenshot: the MT4 download page
2

Open a trading account in MetaTrader

Already have a demo or live account set up? Skip to step 3.

Open MetaTrader. A window called "Open an Account" should appear by itself. If it doesn't, click File → Open an Account at the top.

For a free demo account (no real money, good for testing):

Choose "MetaQuotes-Demo" as the server, then "New Demo Account". Fill in a name, email and starting balance — any values work — and click through to finish.

If you already trade with a real broker, choose that broker's server instead and log in with the account details they gave you.

MetaTrader 'Open an Account' window
📷 Screenshot: the "Open an Account" window
3

Allow MetaTrader to talk to TradeLista

This one setting lets the EA send your closed trades to TradeLista. Without it, nothing will arrive — and MetaTrader won't tell you why.

In MetaTrader, click Tools in the top menu bar, then Options. Open the "Expert Advisors" tab.

MetaTrader Tools menu with Options highlighted
📷 Screenshot: Tools → Options

Check the box "Allow WebRequest for listed URL". Click into the empty field below it, paste this address, and press Enter:

https://xkmpknoughjnxalkoatx.supabase.co

Click OK.

Tools > Options > Expert Advisors tab with the WebRequest URL added
📷 Screenshot: the WebRequest URL added in Options
4

Get your personal API key from TradeLista

This key is how TradeLista knows which account a trade belongs to. EA auto-sync is a Pro feature, so log in at tradelista.com with a Pro account (upgrade here first if you're still on Free).

Click your avatar in the top-right corner, then "Account settings". Scroll down to "Trading accounts" and click "+ Add trading account".

Give it a name (e.g. "My MT5""My MT4"), choose Live or Demo, choose MT5MT4 as the platform, and click "Add account".

Click "🔑 Copy key" next to your new account. Keep this tab open — you'll paste this key in step 8.

Lost the key later or need it on another device? It's always there — open your avatar → "Account settings""Trading accounts" and click "🔑 Copy key" next to that account again.

5

Download the TradeLista Expert Advisor

Click below to save the file to your computer (it usually lands in your Downloads folder):

⬇ Download TradeListaSync.mq5

Click below to save the file to your computer (it usually lands in your Downloads folder):

⬇ Download TradeListaSync.mq4

This EA is read-only: it only reports trades you've already closed. It never places, closes or changes a trade for you — see the FAQ below for details.

🔄
Already using an older version? Download it again and replace the old file — this version also reports the stop loss and take profit a trade was opened with, and how long it was held, which is what TradeLista needs to show your results in R and to tell you whether your stops were honoured. Your API key and everything in steps 1–4 stay exactly as they are; just redo steps 5–9 with the new file. Trades already in your journal keep their existing data.
6

Put the file where MetaTrader can find it

In MetaTrader, click File → Open Data Folder. A Windows folder window opens.

MetaTrader File menu with Open Data Folder highlighted
📷 Screenshot: File → Open Data Folder

Double-click the MQL5MQL4 folder, then double-click Experts.

The MQL5 folder selected in the data folder
📷 Screenshot: the MQL5 folder
The Experts folder selected inside MQL5
📷 Screenshot: the Experts folder
The MQL4 folder selected in the data folder
📷 Screenshot: the MQL4 folder
The Experts folder selected inside MQL4
📷 Screenshot: the Experts folder

Copy the TradeListaSync.mq5TradeListaSync.mq4 file you downloaded in step 5 into this Experts folder (drag and drop, or copy-paste).

The MQL5\Experts folder with TradeListaSync.mq5 copied in
📷 Screenshot: the file placed in the MQL5\Experts folder
The MQL4\Experts folder with TradeListaSync.mq4 copied in — MT4 auto-compiles it into a .ex4
📷 Screenshot: the file placed in the MQL4\Experts folder
7

Compile itRefresh the Navigator

Back in MetaTrader, look at the Navigator panel on the left (press Ctrl+N if you don't see it).

Right-click "Expert Advisors" and click "Refresh". TradeListaSync should now appear in that list.

Right-clicking Expert Advisors and selecting Refresh in the Navigator
📷 Screenshot: right-click → Refresh
TradeListaSync now listed under Expert Advisors in the Navigator
📷 Screenshot: TradeListaSync appears in the list

That's all for MetaTrader 4 — it compiles the file automatically as soon as it shows up in the list, so there's no separate editor or compile step. Continue to step 8.

Right-click it and choose "Modify" — this opens a second window called MetaEditor with the code inside. (Double-clicking attaches it straight to a chart instead — that's step 8, not this one.)

Seeing a "MQL Wizard" window instead (asking what you'd like to create)? That's MetaEditor's new-program wizard — it means the right-click landed on the "Expert Advisors" folder title rather than on TradeListaSync itself. Just click Cancel, then in MetaEditor's own Navigator panel on the left expand Experts and double-click TradeListaSync to open the code.

In MetaEditor, click the "Compile" button near the top (or press F7). This turns the code into a program MetaTrader can actually run — without it, there's nothing to attach to a chart in step 8. At the bottom it should say "0 errors, 0 warnings".

MetaEditor with the TradeListaSync code open and the Compile button highlighted
📷 Screenshot: successful compile in MetaEditor
8

Attach the EA to a chart and paste your key

Switch back to the main MetaTrader window. In the Navigator, under Expert Advisors, find TradeListaSync and drag it onto any open chart — the symbol and timeframe don't matter, it watches your whole account.

Dragging TradeListaSync from the Navigator onto an open chart
📷 Screenshot: dragging TradeListaSync onto a chart

A window pops up. Click the "Inputs" tab and paste the API key you copied in step 4 into the ApiKey field.

The EA Inputs tab with the TradeLista account API key field ready to paste into
📷 Screenshot: pasting the API key into the Inputs tab
The MT4 Common tab with Allow live trading and Allow import of external experts ticked
📷 Screenshot: Common tab — allow live trading
The MT4 Inputs tab with the API key field filled and the OK button
📷 Screenshot: Inputs tab — paste key, then OK

Click the "Common" tab and make sure "Allow algorithmic trading""Allow live trading" is checked. Then click OK to attach the EA. (Ignore the "Save" button — that only exports your settings as a file and isn't needed; if a "Save as" dialog pops up, just cancel it.)

There's also a CatchUpDays field (defaults to 30) — on startup the EA re-sends closed trades from the past that many days that are already in this terminal's history, a best-effort catch-up after a restart. It's not a guarantee: a trade you placed from your phone while your desktop was closed may not sync on its own, so add those to TradeLista manually.

9

Turn on Algo TradingAutoTrading (the master switch)

The checkbox in step 8 only gave this one EA permission. There's also a terminal-wide switch that has to be on: near the top of the MetaTrader window, find the button labeled "Algo Trading""AutoTrading" and click it so it's turned on. Both have to be on for the EA to run.

The Algo Trading button showing a red square icon — turned off
📷 Screenshot: Algo Trading off (red)
The Algo Trading button showing a green play icon — turned on
📷 Screenshot: Algo Trading on (green)

The button's icon changes from a red square (off, left) to a green triangle (on, right). Now look at the top-right corner of your chart: a small smiling-face icon next to TradeListaSync means it's active and running.

10

Test it

Open a small trade (e.g. the smallest lot size your account allows) and close it again right away — this is just to confirm everything works.

Go back to your TradeLista Dashboard, switch to the account you just connected (the account switcher near the top of the page, or in your avatar menu), and the trade should appear on today's date within a few seconds.

Every trade you close from now on will land there automatically — no more manual exporting.

11

Already been trading? Import your history PRO

The EA only sends trades that close after it's attached — everything you traded before today would otherwise start out blank. To bring that in too: in MetaTrader, go to the History tab, right-click anywhere in it, and choose "Save as Report" (saves an .html file).

Then on your Dashboard, click "⬆ Import" next to "+ Add trade", upload that file, review the trades it found, and import them. One-time thing — not a live sync, just a way to backfill what already happened.

Trades aren't showing up on the calendar
Double-check step 3 — the API URL must be added exactly under "Allow WebRequest for listed URL". Also confirm Algo Trading is enabled (the button in the MetaTrader toolbar should be highlighted, not greyed out).
How do I see the exact error, if something's wrong?
In MetaTrader, look at the bottom of the window for a tab called "Experts" (next to "Journal"). Every time a trade closes, TradeListaSync writes a line there — either "sent ... (HTTP 200)" (success), or a specific error message explaining what went wrong (e.g. a missing API key, or the URL not being whitelisted). That line tells you exactly which step to redo.
My test trade didn't do anything when I clicked Buy/Sell
Forex markets are closed on weekends (roughly Friday evening to Sunday evening, depending on your broker/timezone). If you try to place a trade while the market's closed, MetaTrader rejects it with a short error sound — that's normal, not a bug. Try again once the market's open, or check with your broker for exact hours.
The EA icon in the top-right shows a sad face
This is about the small face icon in the top-right corner of the chart itself (not the graduation-cap icon next to TradeListaSync in the Navigator panel — that one's just a file icon, it doesn't indicate anything is wrong). A sad face on the chart means Algo Trading is disabled for that chart. Click the Algo Trading button in the toolbar, or right-click the chart → Expert Advisors → "Allow live trading".
Can I connect more than one account?
Free plan: 1 account (manual entry only). Pro plan: up to 5 connected accounts. Repeat steps 4 and 8 for each additional account (each gets its own API key and its own EA on its own chart), then switch between them using the account switcher in your avatar menu or the account selector on your Calendar page.
Does the EA place or modify trades?
No — and it's built so that it can't. TradeListaSync contains no order-placement code at all: it only reads your account's closed trade history and reports it to your calendar over a one-way connection. It can't open, close or modify a position, and it never touches your balance, withdrawals, or your MetaTrader login.

Sent for each closed trade, and nothing else: symbol, lot size, entry and exit price, the stop loss and take profit it was opened with, the result (including swap and commission), close date and time plus your computer's UTC offset, how long it was held, buy or sell, the trade's ticket number, and your API key so it lands in the right account. Your login, password, investor password, balance and open positions are never read or sent — the full list is in our Privacy Policy, section 3.3.

The Algo Trading / "Allow algorithmic trading" toggle from steps 8–9 can look like you're granting trading permissions — you're not. MetaTrader requires that toggle to be on for any Expert Advisor to run at all, including a purely read-only one like this. It's a MetaTrader-wide switch, not a permission specific to TradeListaSync.

And your API key only authorizes writing that one account's trade data into your own TradeLista calendar — it can't be used to access your broker account, place trades, or touch any other account.
I don't use an EA — can I still use TradeLista?
Yes. Manual entry works on both Free and Pro plans — just add each trade's symbol, lot size, entry, exit and profit/loss straight from the Calendar page.
Can I import trades I made before connecting the EA?
Yes, on Pro — see step 11 above. Export your account's History as a report from MetaTrader, then use the "⬆ Import" button on your Calendar to bring it in. It's a one-time import, not a live sync — repeat it any time you want to backfill more.
Pro plan required for EA auto-sync. Free accounts get 1 manually-managed account; Pro unlocks EA auto-sync and up to 5 connected accounts.
1

Log in (or create a free account)

Manual entry works on both the Free and Pro plans — no EA, no download, no setup outside TradeLista itself.

Go to tradelista.com and log in, or create a free account if you don't have one yet.

↑ top-right corner of every TradeLista page
2

Open your Calendar

Click "Dashboard" in the top menu, or go straight to tradelista.com/app.html.

3

Add a trade — two ways to do it

Option A: click "+ Add trade" near the top-right of the Calendar. It opens a blank form and lets you pick the date yourself.

Live — FTMO 100k (USD)

Option B: click directly on the day in the Calendar you traded on, then click "Add trade for this day" inside it. The date is filled in for you automatically.

MonTueWedThuFriSatSun
17
18
19
20
21
↑ 1. click any day on the Calendar
Sunday, July 19
↑ 2. inside the day view, click "Add trade for this day"

Both options open the exact same form — pick whichever is faster for you.

4

Fill in the trade

Required: Date, Symbol / pair (e.g. EURUSD), Lot size, and Profit / loss.

Optional: Entry price and Exit price — add them if you have them, but they're not required to save the trade.

2026-07-20
EURUSD
1.0
+45.20
1.0850
1.0890
5

Click "Add" — you're done

The trade appears on the calendar immediately, colored green or red depending on the result.

Want to add more detail? Click the trade afterward to open it — you can write a note and add tags on any plan; screenshots, reflection questions and Golden Trading Rules are part of Pro.

MonTueWedThuFriSatSun
17
18
19
20+45.20
21
↑ your new trade, added just now
Can I edit or delete a trade after adding it?
Yes. Open the trade from the calendar — you can edit any field directly there, or delete it entirely from the same view.
Can I switch to EA auto-sync later?
Yes, any time. Manually-entered trades stay exactly where they are — switching just means new trades from that point on can also arrive automatically. Pick MT4 or MT5 above whenever you're ready.

Ready to get started?

Open your Calendar and add your first trade — it takes less than a minute.