Connect Your Trading
Connect MetaTrader 5
MT5 syncs through an Expert Advisor running in your own terminal. Ledgerr never sees your broker password.
What You Need
- MetaTrader 5, on a machine or VPS that stays on while you trade.
- An EA API key from Ledgerr — created in Account Settings.
- Permission for the terminal to reach Ledgerr (one setting, below).
Pick an EA
Ledgerr Sync is a small, read-only Expert Advisor that does one thing: it sends every closed trade to your journal. It never opens, modifies or closes a position, and it works alongside any other EA or manual trading.
If you already use the Position Sizer EA for risk management, you can skip Ledgerr Sync — the Position Sizer build on the Downloads page has the same sync built in. Run one or the other on an account; if both are attached, only one of them syncs.
Install the Expert Advisor
- 1In Ledgerr, open Settings, then Downloads, and download Ledgerr Sync (or the Position Sizer EA).
- 2In MetaTrader 5, open File, then Open Data Folder, and go into MQL5 then Experts.
- 3Copy the downloaded file into that folder.
- 4Back in MetaTrader, right-click Expert Advisors in the Navigator panel and choose Refresh. The EA appears in the list.
Paste Your API Key
- 1In Ledgerr, open Settings, then Accounts, and click EA API Key.
- 2Create a key if you have none, then copy it.
- 3Drag the EA onto one chart per account in MetaTrader. Its Inputs tab opens.
- 4Paste the key into the LedgerrApiKey input and click OK.
- 5Ledgerr Sync shows a status panel on the chart. “Syncing” in green means it is connected.
One chart is enough
One key, several terminals
Allow the Connection to Ledgerr
MetaTrader blocks Expert Advisors from reaching the internet until you list the address. Open Tools, then Options, then Expert Advisors, tick “Allow WebRequest for listed URL” and add:
https://app.ledgerr.coLedgerr Sync only reads your history, so it does not need algorithmic trading switched on. The Position Sizer EA does, for its own trade buttons.
What Syncs, and When
- Closed positions only. An open position appears once it closes.
- Entry and exit price, lot size, commission, swap, net profit, open and close time, and the session the trade opened in.
- Your existing history, backfilled on each start — the last 90 days by default, set by the LedgerrReconcileLookbackDays input.
The terminal has to be running for a trade to sync. If you close MetaTrader for a week, the trades from that week arrive the next time it opens with the EA attached.
If Nothing Arrives
- Read the status panel on the chart, or the Experts tab at the bottom of MetaTrader, for messages from the EA.
- Confirm https://app.ledgerr.co is listed under Allow WebRequest in Tools, Options, Expert Advisors.
- Re-copy the API key — a key pasted with a trailing space will not authenticate.
- Confirm the account is not already over your plan’s connected-account limit.
Still stuck? Open a ticket from inside the app, or read the API key guide.