Health check - verifies the MT5 terminal is reachable.

Returns {"ok": bool, "latency_ms": int, "via": str | None}. via names the layer that answered (terminal_info, account_info, or tick_probe) and is omitted when ok is false. Cheap; agents should call this after idle periods or errors that smell like disconnection.

MT5 terminal connection state and broker TZ offset.

Balance, equity, margin, leverage, currency, margin mode.

Current bid/ask for a symbol. Prepares the symbol in Market Watch if needed.

List tradeable instruments, optionally filtered by category (e.g. 'Forex', 'Metals').

Whether the given symbol's session is open right now.

v1 limitation: is_open is derived from trade_mode (open when non-zero). next_open and next_close are always None in v1 - parsing symbol_info().sessions_quotes is scheduled for a later release. Agents needing precise session boundaries should consult their broker's published schedule.

OHLC bars for symbol at timeframe, most recent first.

timeframe: one of M1, M5, M15, M30, H1, H4, D1, W1, MN1. count is clamped to [1, 5000].

Broker-authoritative margin for a hypothetical order.

Wraps mt5.order_calc_margin. If price is omitted, uses the current ask (buy) / bid (sell). Returned margin is in deposit currency.

Open positions, optionally filtered to a single symbol.

Close an open position in full or part by ticket.

Pending orders, optionally filtered to a single symbol.

Place a market or pending order. Optional SL / TP / deviation.

When policy.auto_approve_notional is set > 0, orders whose notional is at or above it return an ApprovalPreview; retry with approval_confirmed=true and the same request fields to proceed. At the default of 0 the gate is off and orders auto-execute. Pass idempotency_key (UUIDv4 recommended) to dedupe retries within idempotency.ttl_seconds.

Modify SL/TP on a position or price/expiration on a pending order.

When the consent gate is armed (policy.auto_approve_notional > 0), widening or removing an existing SL/TP requires approval; tightening always auto-approves. At the default of 0 the gate is off and every modify auto-executes.

Cancel a pending order by ticket. No consent gate (reduces exposure).

Closed deals (trades) within [from_ts, to_ts]. Timestamps must be ISO 8601 UTC.