Macro Data

Overview

Macro Data includes 2 tools for this workflow area.

Available tools: get_macro_data, get_rate_expectations.

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

get_macro_data

Returns macro/market data, dispatched by dataset. dataset=market_sessions: which major trading sessions (Sydney, Tokyo, London, New York) are currently open and when the next session opens/closes. Pure server-side UTC computation — no EA dispatch required. Available at Free+ tier. No parameters beyond dataset. dataset=interest_rates: current central bank policy interest rates for major currencies, sourced from MT5's built-in Calendar API, including the date of the last change and next scheduled decision. Requires the analytics capability (Team+ tier). Optional currencies array (default G10). dataset=macro_indicators: key macroeconomic indicators (CPI, GDP, NFP, PMI, unemployment, retail sales, trade balance) for a currency with the latest actual, previous, forecast, and surprise values, from MT5's built-in Calendar API. Requires the analytics capability. Requires currency; optional indicators filter. dataset=cot_report: the latest CFTC Commitments of Traders (COT) report data for a currency or commodity, from the CFTC Socrata public API (free, no key required), cached 24 hours. Supported symbols: EUR, GBP, JPY, CHF, AUD, CAD, NZD, GOLD, OIL. Returns { error: 'COT_UNAVAILABLE' } if the feed is unreachable. Requires the analytics capability. Requires symbol; optional report_type (default TFF) and weeks (default 4). dataset=rate_differential: the interest rate differential between the two currencies in a pair, plus the annualised swap cost/credit for the specified volume, computed server-side from interest_rates and get_symbol_info data. Requires the analytics capability. Requires symbol; optional volume (default 1.0). interest_rates/macro_indicators/rate_differential return { error: 'NOT_SUPPORTED_ON_MT4' } on MT4 terminals.

Parameters

Example Request

{
  "tool": "get_macro_data",
  "arguments": {
    "dataset": "market_sessions"
  }
}

get_rate_expectations

Returns the market's expected policy path per G10 central bank: next scheduled meeting + countdown, current policy rate, last decision, and — for USD when a Fed Funds futures quote source is configured — market-implied cut/hold/hike probabilities and the implied year-end rate. Every response is labelled data_quality: implied | calendar_only; calendar-only entries omit probability fields entirely (never a fabricated guess). Implied values are DELAYED and APPROXIMATE (approximate: true, method: ff_futures_derived). Fully EA-independent (server-side + cache; works with no terminal connected). Pass a single G10 currency or ALL for the full map. Upstream failures serve cached data with stale: true or return { error: 'RATE_EXPECTATIONS_UNAVAILABLE' }. Requires the analytics capability (Team+ tier).

Parameters

Example Request

{
  "tool": "get_rate_expectations",
  "arguments": {
    "currency": "USD"
  }
}