Documentation · v0.1.4
Operator guide
Traderoo runs locally on Windows as a bridge between MetaTrader 5 and OpenAI agents — for analysis, risk checks, and order execution on your machine.
Requirements
- Windows 10 or 11
- MetaTrader 5 installed and logged in
- OpenAI API key
- Broker account with algorithmic trading allowed
Install
- Download the Windows installer
- Run setup (current-user install). Windows may warn if the build is not Authenticode-signed yet.
- In MetaTrader 5 open Tools → Options → Expert Advisors and enable Allow Algorithmic Trading.
- Launch Traderoo — the trading engine starts with the app. Keep MT5 running while connected.
Onboarding
- Paste your OpenAI API key (stored in Windows Credential Manager / OS keychain).
- Enter MT5 login, password, server, and optional terminal path.
- Connect and select allowed markets from your live MT5 symbol list.
- Choose approval mode: Confirm each trade or Autonomous.
- Set risk limits: max lot, max positions, daily loss %, news blackout, stop-loss requirement.
- Acknowledge live-trading risk before enabling real-money accounts.
Trading sessions
Start a continuous session from the dashboard. The floor chief runs on your loop interval, consults specialists, then either evaluates/places trades or hibernates until a better window. In Confirm mode, pending approvals pause further ticks until you approve or reject.
- Close the window to hide to the system tray (session can keep running).
- Quit from the tray menu to stop the app and engine.
- Keep-awake engages while a session is active so Windows sleep does not interrupt ticks.
- Kill switch stops trading immediately and can be reset from session controls.
- Hibernate pauses ticks until wake (UI, agent tool, or elapsed time).
Approval modes
Confirm each trade
Safest default. Nothing hits MT5 until you approve the order summary in the app.
Autonomous
The agent may place trades within your risk limits while the session runs. Switch anytime in Settings.
Risk controls
- Max lot size and max open positions
- Max daily loss percentage
- News blackout window around high-impact calendar events
- Optional required stop-loss on market orders
- Live MT5 accounts require acknowledgement and an explicit allow toggle
- Local API calls require the app auth token issued by the desktop shell
What the agent can do
- Chat — research markets, review positions, and ask for setups with tool-backed answers.
- Specialists — strategist, technical analyst, and research analyst consulted before session orders or hibernate.
- Technical analysis — multi-timeframe indicators (EMA, RSI, MACD, ATR, Bollinger, ADX, and more) computed in code.
- Economic calendar — news blackout checks with cached calendar data.
- Strategies — built-in playbooks plus custom strategies in Settings.
- Memory — durable notes and gameplans recalled across turns.
- Risk gate — lot, positions, daily loss, R:R, spread, stop-loss, and live-account blocks.
Settings
- Strategy — pick or author the playbook the agent follows.
- Approval — Confirm vs Autonomous.
- Markets — search and toggle MT5 symbols.
- Risk — limits, loop interval, model picker, live account allow.
- Credentials — OpenAI key and MT5 connection details.
Troubleshooting
Use Retry connection. The desktop shell auto-starts the local trading engine.
Confirm the terminal is open, algo trading is enabled, and credentials match the login dialog.
Calendar feed may be rate-limited. Traderoo caches successful pulls and surfaces cooldown status.
Expected until the installer is signed with a commercial Authenticode certificate.
Next step
Install the Windows app, complete onboarding on a demo account, then start a Confirm-mode session.