Macro intelligence
for FX agents.

• event observations & versions
• headline & core inflation (CPI & PCE)
• payrolls, unemployment & earnings (NFP)
• headline Manufacturing & Services PMI (ISM)
• consensus and surprise when available (explicit status when not)
• revision information & affected currencies
• official source provenance (BLS, BEA, ISM)

get_event_context({
  "eventType": "US_CPI"
})

Use it when an agent needs structured factual context for supported macroeconomic releases (US_CPI, US_NONFARM_PAYROLLS, US_PCE, US_ISM_MANUFACTURING, US_ISM_SERVICES). Omitting referencePeriod resolves the latest release.

• overall policy shift
• current policy bias
• policy action
• inflation language changes
• labor-market changes
• growth assessment
• forward guidance
• risk balance
• source-grounded evidence

get_central_bank_changes({
  "centralBank": "FEDERAL_RESERVE"
})

Use it when an agent needs to understand what actually changed between central-bank meetings. Supports FEDERAL_RESERVE, ECB, BANK_OF_ENGLAND (BOE), and BANK_OF_JAPAN (BOJ).

Reaction windows: 5 minutes · 15 minutes · 1 hour · 4 hours · 24 hours

• start and end price
• percentage return
• high and low prices
• maximum upside move
• maximum downside move
• trading range percentage
• multi-instrument support (EURUSD, GBPUSD, USDJPY)

get_market_reaction({
  "targetType": "US_CPI",
  "instrument": "GBPUSD"
})

Use it when an agent needs deterministic price reaction metrics across 5 standardized post-event windows (M5 to H24). Supports US_CPI, US_NONFARM_PAYROLLS, US_PCE, US_ISM_MANUFACTURING, US_ISM_SERVICES, FEDERAL_RESERVE, ECB, BANK_OF_ENGLAND (BOE), and BANK_OF_JAPAN (BOJ; maps to USDJPY) across EURUSD, GBPUSD, and USDJPY (defaults to EURUSD).

• official release calendars
• scheduled event times
• US CPI, NFP, PCE, ISM Manufacturing & Services, Federal Reserve, ECB, Bank of England, and Bank of Japan events
• currency-sensitive risk filtering (EURUSD, GBPUSD, USDJPY)
• forward-looking lookahead window

get_upcoming_risks({
  "instrument": "GBPUSD",
  "horizonHours": 24
})

Look ahead up to 720 hours (30 days). Returns scheduled events only, with an empty list when none fall within the window, plus per-event-type schedule coverage so gaps in a calendar are reported rather than hidden. Currency-sensitive: every pair tracks the U.S. releases (CPI, NFP, PCE, ISM) and the Fed; EURUSD adds the ECB, GBPUSD the BoE, and USDJPY the BoJ.

• individual similar historical releases
• event-specific surprise profile matching (CPI headline/core; NFP payroll, unemployment & earnings)
• direction match count & surprise distance
• observed post-release reaction
• M5 to H1 reaction persistence
• multi-instrument historical reaction corpus (EURUSD, GBPUSD, USDJPY)

get_historical_analogs({
  "eventType": "US_CPI",
  "instrument": "EURUSD",
  "maxAnalogs": 10
})

Use it when an agent needs to retrieve, rank, or inspect specific historical analog cases. Historical observations only; not forecasts or trading signals. Supports US_CPI and US_NONFARM_PAYROLLS across EURUSD, GBPUSD, and USDJPY (defaults to EURUSD). US_PCE and the ISM PMIs return INSUFFICIENT_HISTORICAL_CALIBRATION until enough verified consensus exists.

Reaction windows: 5 minutes · 15 minutes · 1 hour · 4 hours · 24 hours

• sample return distributions (mean, median, quantiles)
• directional consistency across windows
• reaction-path classification (continuation, reversal, fade, delayed)
• sample-size-based pattern confidence
• standardized post-event windows (M5 to H24)
• multi-instrument historical reaction corpus (EURUSD, GBPUSD, USDJPY)

get_historical_reaction_context({
  "eventType": "US_CPI",
  "instrument": "GBPUSD",
  "limit": 10
})

Use it when an agent needs collective pattern statistics and behavioral classification across similar releases rather than individual case inspection. Supports US_CPI and US_NONFARM_PAYROLLS across EURUSD, GBPUSD, and USDJPY (defaults to EURUSD). The ISM PMIs return INSUFFICIENT_HISTORICAL_CALIBRATION until enough verified consensus exists.