Market Intelligence

Overview

Market Intelligence includes 4 tools for this workflow area.

Available tools: get_economic_calendar, get_market_depth, get_spread_alert, scan_symbols.

Use the parameter tables and examples below as the canonical request contract.

get_economic_calendar

Returns upcoming and recent economic calendar events. Prefers MT5's built-in Calendar API when a terminal is connected; falls back to the server-side calendar (free feed) on MT4 or when disconnected. Response includes a source field ('terminal' or 'server') and a deterministic category per event (central_bank | inflation | labor | growth | sentiment | energy | metals | agriculture | bonds | holiday | other). Requires the analytics capability (Team+ tier).

Parameters

Example Request

{
  "tool": "get_economic_calendar",
  "arguments": {}
}

get_market_depth

Returns Depth of Market (DOM) bid/ask levels for a symbol. Requires the broker to supply DOM data — if unavailable, returns empty arrays with a note. On MT4 terminals, returns { error: 'NOT_SUPPORTED_ON_MT4' }. Requires the read capability (Pro+ tier).

Parameters

Example Request

{
  "tool": "get_market_depth",
  "arguments": {
    "symbol": "EURUSD"
  }
}

get_spread_alert

Returns the current spread for a symbol compared to an estimated historical average. The 30-day average is estimated from daily high-low range (not tick-level data). A spread is flagged as abnormal if it exceeds threshold_multiplier × the estimated average. Requires the analytics capability (Team+ tier).

Parameters

Example Request

{
  "tool": "get_spread_alert",
  "arguments": {
    "symbol": "EURUSD"
  }
}

scan_symbols

Scans Market Watch symbols and filters by spread, RSI, or ATR thresholds. At least one filter criterion must be provided. Returns up to 50 symbols. Stops early, with partial=true, either after 10 seconds or once limit matches are found — scanned_count then covers only the scanned prefix, not the full symbol universe, so scanned_count - dispatch_errors - count is only meaningful when partial is false. dispatch_errors counts symbols where a required tick/RSI/ATR call failed or returned an unusable payload, distinct from symbols that were fetched fine but didn't pass the filter. Requires the read capability (Pro+ tier).

Parameters

Example Request

{
  "tool": "scan_symbols",
  "arguments": {
    "filter": {},
    "timeframe": "M1"
  }
}

Usage Notes

• Use one timeframe for quick checks and multiple timeframes only when you need cross-timeframe analysis.