A one-time job: install FroggyTrader, drop the advisor into MetaTrader 5, set an investor password and switch XAU/USD on. Step 9 adds Telegram notifications if you want them. Your detected system opens automatically; the other instructions stay one click away.
About 20 minutes if MetaTrader 5 is already installed.
Nothing beyond your own account and a computer. We never ask for access to your funds and we hold no money.
1
5 min
Already have the terminal and log into your account with it? Skip this step. FroggyTrader works with the MT5 installed on the same computer.
One install = one account
One FroggyTrader serves one trading account. For several accounts you need a separate machine per account, each with its own terminal and client.
2
3 min
Download the archive for your system — the buttons are on the home page: FroggyTrader-macos.zip or FroggyTrader-windows.zip. Both archives hold the same two things: the client installer and the trading advisor for MetaTrader 5. The client goes in now, the advisor in step 4. The cloud is remote — there is nothing else to install.
FroggyTrader-macos.zip — inside are the installer FroggyTrader-<version>.dmg (for example, FroggyTrader-0.1.0.dmg) and the advisor FroggyTraderProductEA.ex5..dmg and drag FroggyTrader into Applications.FroggyTrader-windows.zip — inside are the installer FroggyTrader-<version>-windows.exe (for example, FroggyTrader-0.1.0-windows.exe) and the advisor FroggyTraderProductEA.ex5..exe: it lets you pick a folder and creates a FroggyTrader shortcut. If SmartScreen shows a blue screen — More info → Run anyway.Windows is not code-signed yet
The macOS build is signed and only needs the ordinary Open confirmation for an app downloaded outside the App Store. The Windows installer is still unsigned, so SmartScreen may require More info → Run anyway.
3
1 min
FroggyTrader has no big window. It lives as a frog icon next to the system clock, and everything is controlled from the web panel that icon opens.
4
4 min
The advisor is a bridge: it hands your broker's candles to the bot and executes the commands that come back. The file is:
It is already compiled — no MetaEditor, no compiling. The file sits in the same archive you installed the client from in step 2, right next to the installer.
MQL5 → Experts and create a FroggyTrader folder.FroggyTraderProductEA.ex5 there. The final path:
MT5 on Mac runs in its own Wine layer: File → Open Data Folder opens MT5's built-in file manager rather than Finder, and you cannot drag a file into it from Finder. One command is easier. Open Terminal (Applications → Utilities → Terminal), paste all four lines at once and press Enter:
It creates the FroggyTrader folder, copies the advisor into it and opens it in Finder, so you can see the file arrived.
cp , drag the advisor file into the Terminal window — the path fills itself in — then add "$DEST/".No such file or directory on the very first folder, MetaTrader 5 is installed somewhere else. Check that you installed the official MetaQuotes build for Mac (step 1).The last bit is the same on both systems: in the Navigator pane, right-click Expert Advisors → Refresh. If it still doesn't show up, restart MT5.
MQL5.
MQL5 you need Experts — that's where FroggyTrader goes. On macOS this window is MT5's built-in file manager.5
1 min
MetaTrader blocks HTTP requests from advisors by default. You need to allow exactly one address, once — the local engine on your own machine.
6
6 min
XAUUSD, XAUUSD.p, XAUUSDm, GOLD. Use the one your account actually trades — the advisor works with its own chart's symbol.FroggyTrader/FroggyTraderProductEA from the Navigator onto the chart.
To verify, open the Experts tab at the bottom of the terminal. Healthy lines:
The first two lines appear once, when the advisor starts. The third repeats roughly every 5 minutes — that's your sign the bot is alive. "no entry signal" is normal: the bot waits for its setup and may not enter for days. While the market is closed (weekends) there are no ticks, so no new lines appear — also normal.
Switching the timeframe is fine, switching the symbol is not
Switching the chart makes MetaTrader detach and re-attach the advisor: the Experts tab will show EA stopped and then EA started. Changing the timeframe is safe — same symbol, so every position stays under management.
Changing the symbol on that chart while a position is open is not. The advisor works with its own chart's symbol: switch the chart from gold to another instrument and open gold positions stop being serviced by it. The stop-loss and take-profit stay with the broker, but nothing will manage the trade or close it on signal any more. If you need another instrument, open a separate chart window and leave the advisor's chart alone.
The MT5 watcher can relaunch the terminal after a crash, but it cannot attach an advisor to a chart. The active MT5 profile must already contain the correct chart and FroggyTrader.
FroggyTrader as the profile name and press OK. Leave that profile active.
What the watcher status means
MT5 watcher: online means the terminal process is being watched. After a recovery, the real confirmation is a fresh FroggyTrader line in the Experts tab.
7
3 min
The investor password is read-only: it can see the account and its history, but cannot trade, touch positions or withdraw. We ask for it so we can check your account state independently — if a period's profit is ever disputed, for instance. It is stored encrypted, and without it live trading stays off.
The fee itself is calculated from the closed trades the advisor reports — you can see them in the dashboard's "deals" tab, and those are the same numbers that appear on the renewal invoice.
Where to change it: Tools → Options → Server → Password: Change — or right-click the account in the Navigator → Change Password.
In the Change Password dialog, in order:
Common journal errors:
| current password error | "Current password" isn't the master account password. |
| password isn't complex enough | The new password lacks complexity — see item 3. |
8
5 min
The last step happens in the panel: FroggyTrader icon → Open FroggyTrader.
0.01.Check that the bot is really running. cloud: online alone is not enough — it only says the cloud is reachable. All four have to line up:
FroggyTrader: active, no entry signal (or a trade message). That line is what means "the bot is alive". backend=connected is printed only when the advisor starts, so its age tells you nothing. There must be no recent backend unavailable or WebRequest failed;If any one of them is off, the bot won't enter the market. What to do in each case is in "When something doesn't work".
About lot size and risk
The bot can hold up to 5 positions at once on a single instrument — but it doesn't have to: how many there are is up to the market, and often it's one or none. Size your risk off the upper bound: the maximum combined volume is 5 × your lot on XAU/USD. Start at the minimum: you can raise it any time, and the first weeks are best spent watching how the bot enters on your broker. If your broker requires a different volume step, the card warns you and shows both values.
The instrument toggle is not decoration: switch it off and new entries stop immediately, even with the advisor still on the chart. Positions already open are still managed to their exit.
9 · optional
5 min
Telegram is configured once in its own card under FroggyTrader settings. There is nothing to enter in the advisor and no Telegram URL to add in MT5. Skip this step if you do not want notifications.
/newbot, and save the Bot Token. It is a secret — never send it to support or expose it in a screenshot./start.https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates in a browser and locate the number in "chat":{"id":...}. Group chat IDs usually begin with a minus sign.What you will receive
Advisor starts and stops, trading events, and execution errors. On macOS the MT5 watcher also reports a terminal crash, restart attempts, the advisor heartbeat returning, or MT5 coming back without the advisor. The token stays encrypted on this device and is never sent to the cloud.
The bot decides on the candles the advisor brings it. No terminal, or a sleeping computer, means no candles and no entries. This is the number-one reason behind "the bot isn't doing anything".
VPS: untested
Nothing technically stops you from installing MetaTrader 5 and FroggyTrader on a VPS, and for continuous uptime it sounds sensible. But we have not tested that configuration and cannot guarantee it — go that route at your own risk. The tested setup is an ordinary Mac or Windows PC that doesn't sleep.
No subscription, no card on file. The fee is 6.5% of the profit the bot closed over a 30-day period. If the period ends negative, the renewal is free.
.ex5 over the old one (step 4) and restart MT5.| Message or symptom | Cause and fix |
|---|---|
| WebRequest failed. error=4006 | The local address isn't allowed. Go back to step 5 and check the list contains exactly http://127.0.0.1:8082. |
| backend unavailable | The engine isn't running. FroggyTrader icon → Start engine; if the state says failed, use Restart. |
| engine unavailable (in the panel) | Same thing: the panel is up, the engine isn't. Start it from the icon menu. |
| trading blocked by license status | No right to trade: the free month ended, the renewal is unpaid, the Terms aren't accepted, or account setup isn't finished. Open the subscription tab — it names the exact reason. |
| trading blocked: real account required | A demo account is connected. The bot only trades a live account. |
| live account setup: not completed | Server, account number or investor password is missing — step 8. If all three are filled in, check that you really did set the investor password in MT5 (step 7). |
| The advisor shows a cross on the chart | Algo trading is off: press Algo Trading in MT5 and allow it in the advisor's properties. |
| The advisor isn't in the Navigator | The file isn't under MQL5/Experts/, or the Navigator wasn't refreshed. Check the path from step 4 and restart MT5. |
| No trades, but everything is green | Normal. The strategy waits for its setup and may not enter for days. |
| The card warns the lot was reduced | Your broker uses a different minimum volume step. The card shows both the requested value and the one that will actually go through. |
| I switched the chart to another symbol and the bot stopped managing a position | The advisor only services its own chart's symbol. Switch the chart back to gold — the advisor will see the open positions again and resume managing them. The broker-side stop-loss and take-profit stay in force the whole time. |
| The bot went quiet overnight / missed a day | Almost always the machine slept or the terminal was closed — see "Keeping the bot from missing trades". |
We haven't tested that, so we don't recommend it: technically the steps are the same (MetaTrader 5 and FroggyTrader on one machine), but VPS operation is unverified and unguaranteed — at your own risk. The tested setup is an ordinary Mac or Windows PC that doesn't sleep.
No. The panel is a remote control, not the bot. A closed tab changes nothing; trading stops only if you switch the instrument off, stop the engine, or choose Exit in the icon menu.
So we can look at the account independently of the client program if a period's profit is ever disputed. The fee itself is computed from the closed trades shown in your dashboard. The investor password is read-only: it cannot trade, modify positions or withdraw. We never ask for the master account password.
Yes. The bot never touches your own trades and they are excluded from the profit share. Keep in mind that manual positions still consume margin on the account.
The macOS build is signed, but macOS can still ask you to confirm opening an app downloaded outside the App Store — click Open. The Windows installer is not signed yet, so SmartScreen may require More info → Run anyway.
Not a problem: the advisor uses the symbol of the chart it sits on, and the engine matches the name allowing for broker suffixes. Open your broker's gold chart (XAUUSD.p, XAUUSDm, GOLD) and drop the advisor there. One thing matters: it must be gold — never attach the advisor to another instrument's chart, the strategy is built for XAU/USD.
Message support and attach the Experts tab from MT5 — those lines give the reason away almost every time.