List terminals in the registry.

Pass include_discovered=true to also list installs found under %APPDATA%\MetaQuotes\Terminal that are not in the registry yet. Password values are not included.

Add a discovered terminal, or a path, to the registry.

This writes terminals.toml. It does not copy or create an install. name becomes the registry id when it is set. A junction to an install is refused. Register the real directory.

Remove a terminal from the registry. The install and data folder stay on disk.

Start a MetaTrader terminal. Pass a registry id, a discovered id, or any terminal path.

If that terminal64.exe is already running, this leaves it alone. A junction is refused, because MetaTrader would open a second data folder.

Attach the API to a terminal that is already logged in.

This never sends a login or password. If the open account is not the one named in the registry, log in from the terminal window.

Report the active terminal: build, company, server clock, timezone offset, login, and demo or real.

Drop the Python API connection. The terminal window stays open.

Read account health for the active terminal.

Returns balance, equity, margin, free margin, margin level, floating profit, whether trading is allowed, open positions, and pending orders. This does not place, modify, or close anything.

List open positions on the active account. Read-only.

List pending orders on the active account. Read-only.

Write a JSON profile of the active broker: clock, account mode, and every symbol.

Each symbol stores the full symbol_info record plus weekday sessions. The tool result is a summary and a file path, not the whole symbol list.

Read a saved broker profile. Without symbol, return the summary. With symbol, return that instrument.

List saved broker profiles and how many symbols each one contains.

Diff saved broker profiles on the fields that decide whether a backtest can transfer.

Pass at least two ids from list_profiles. Symbol names must match exactly. Compared fields are spread, the floating-spread flag, swap, swap mode, stops level, contract size, filling mode, and session hours. Unchanged symbols are counted and omitted.

List symbol names on the active terminal. limit=0 returns every name.

Return the full symbol_info record, the latest tick, and weekday sessions.

Return the latest bid, ask, last, and time for one symbol.

Add or remove a symbol in Market Watch so history can download.

Download bars, paging until the terminal runs out, and write CSV or Parquet.

Omit both dates to request every bar the terminal still serves. Pass both dates for one window. Bars outside that window are dropped, including the older bar the terminal returns when the window is before cached history. This is not how far back M1 goes. Use history_coverage for bars already on disk and extend_history with kind=m1 to download older months. The result is a file path, a count, a time range, and a short preview.

Probe how far back daily, weekly, or monthly bars already go, and save that series by default.

Omit symbol to survey every symbol, or pass a group mask. Daily bars are stored as data//rates/D1/.csv with a survey.json index. The tool result is the summary, not the bars. This does not measure M1. history_coverage reads the earliest M1 bar already on disk. extend_history with kind=m1 downloads older months until one comes back empty.

Report stored bar and tick depth for one symbol without downloading a gap.

m1.time_from is the earliest minute bar already in the yearly .hcc files. A missing earlier year has not been fetched. A year file the terminal has open is read back with one request bounded to that year. This call does not request an earlier year. Bar years and tick months come from the same cache. When verify is true, one bounded UTC request is made inside that cache for daily bars and for ticks.

Download older history one chunk at a time and stop at the first empty chunk.

kind=d1 walks one UTC year backward from the oldest cached year. kind=m1 walks one UTC month backward from the month before the earliest cached M1 bar. A bar outside that month does not count. The first month with no bars inside it is the broker limit. max_steps is the number of months in one call. Call again when reached_broker_limit is false. kind=ticks walks one UTC month backward from the oldest cached tick month.

Download ticks to a file. Set all_history=true when dates are omitted.

Unbounded tick history is large, so all_history is required for that case.

List .mq5 sources and .ex5 binaries under the active terminal Experts folder.

Compile one .mq5 file with MetaEditor and return structured errors and warnings.

Compile an EA, run that one day, and scan the tester journal.

date is both FromDate and ToDate. timeout_sec defaults to 180. Blocking lines are init failures, history not synchronized, tester rejects, and runtime errors. A history-sync miss is retried once. This does not place a live order.

Parse input declarations from an Expert Advisor source file.

Write a headless tester.ini. ShutdownTerminal is always 1 and Visual is always 0.

model is every_tick, ohlc, open_prices, or real_ticks. Pass source to seed TesterInputs from the EA, or pass inputs as a name-to-value map.

Run terminal64.exe /config on a tester ini and wait until it exits.

The ini must contain only [Tester] and [TesterInputs], with ShutdownTerminal=1. The launch path is used as written. A junction, an already-open terminal, or the same program running from another path is refused. The report is the file named by Report in the ini. Before the launch, the EA sources and the ini are copied into a snapshot. The manifest is updated with the report path.

Parse a tester HTML report into a summary, every closed trade, and a breakdown.

Omit path to use the newest report for the active terminal. Each trade has entry and exit time, side, volume, prices, profit, and comment. The breakdown splits long and short expectancy, holding time, and entry hour on the report clock.

List source snapshots written by run_backtest, newest first.

Read one snapshot manifest: EA sources, tester inputs, and the report path.

Diff two tester reports field by field.

Tail the tester journal or the terminal journal. mode is tester or journal.

Stop a Strategy Tester process this server started.