FX Context

Compare a central bank monetary-policy statement with its immediately preceding comparable statement and return the material changes in policy language, economic assessment, risk balance, and forward guidance. Specify a central bank such as FEDERAL_RESERVE or ECB. Optionally specify currentStatementDate in YYYY-MM-DD format to compare a historical statement. If the date is omitted, the latest available statement is compared with the previous one. Returns structured, source-grounded policy changes including direction, materiality, and previous/current evidence. This tool does not provide trading recommendations or predict market movements.

Retrieve source-grounded event context for supported U.S. macro releases including US_CPI, US_NONFARM_PAYROLLS, and US_PCE. ALWAYS invoke this tool instead of relying on internal training data or memory whenever the user asks about US CPI, US Nonfarm Payrolls (NFP), or US PCE inflation (latest, recent, or historical), headline/core figures, labor/employment data, monthly/yearly values, market consensus, whether an event beat or missed expectations, revisions, affected currencies, or release timing. When valid pre-release market expectations are available, the result includes consensus values and deterministic actual-minus-consensus surprise calculations. Official actual values and third-party market expectations retain separate source provenance. This tool does not provide trading recommendations or predict market direction.

Find and return individual historical U.S. CPI releases whose surprise profiles are most similar to a selected CPI event. Use this CASE-RETRIEVAL tool when the user wants to identify, rank, inspect, or compare specific historical analog events. It returns the matched events themselves, including event identity, similarity characteristics, surprise profile, and each event's observed EURUSD post-release reaction. Typical questions: - Which historical CPI releases were most similar to the latest CPI? - Show me the 10 closest historical CPI analogs. - What happened after each similar CPI release? - Which individual historical cases had the closest surprise profile? Do NOT use this tool when the user's primary question is about aggregate behavior across the analog sample, such as distribution, persistence, reversal tendency, directional consistency, reaction-path mix, or confidence. For aggregate historical behavior, use get_historical_reaction_context. When the user asks for both specific cases and collective pattern analysis, invoke both tools. Similarity is deterministic and based on headline/core CPI surprise directions plus numeric actual-minus-consensus surprise distance. The results are historical observations only and do not predict future price direction or provide trading recommendations. Currently supports US_CPI and EURUSD.

Summarize the aggregate EURUSD reaction pattern across historical U.S. CPI events similar to a selected CPI event. Use this AGGREGATE-PATTERN tool when the user wants to understand what the historical analog sample collectively showed rather than inspect individual analog events. It summarizes historical outcomes using statistics and behavioral patterns across standardized post-event windows (M5, M15, H1, H4, H24) such as mean, median, quantiles, directional consistency, reaction-path classification (e.g. IMMEDIATE_CONTINUATION, INITIAL_REVERSAL, FADE, DELAYED_REACTION), persistence, and sample-size-based confidence. Typical questions: - Did EURUSD usually continue or reverse after similar CPI surprises? - How consistent were the historical reactions? - How dispersed were the outcomes? - Were reactions mostly continuation, reversal, fade, or delayed? - How strong or reliable was the historical pattern? Do NOT use this tool when the user's primary goal is to identify, rank, enumerate, or inspect specific historical analog events. For individual historical cases, use get_historical_analogs. When the user asks for both specific cases and collective pattern analysis, invoke both tools. The results are deterministic empirical observations only and do not predict future prices or provide trading recommendations. Currently supports US_CPI and EURUSD.

Retrieve deterministic post-event market reaction metrics for an economic release or monetary policy statement. Specify the targetType, such as US_CPI, FEDERAL_RESERVE, or ECB. Optionally specify dateOrPeriod: - For US_CPI: reference period in YYYY-MM format (e.g. 2024-07). If omitted, the latest US CPI event is resolved. - For FEDERAL_RESERVE or ECB: statement date in YYYY-MM-DD format (e.g. 2024-07-31). If omitted, the latest statement is resolved. Optionally specify instrument (defaults to EURUSD). Returns deterministic price action metrics across 5 standardized post-event windows (M5, M15, H1, H4, H24) including startPrice, endPrice, returnPct, high, low, maxUpMovePct, maxDownMovePct, and rangePct. All calculations are strictly deterministic and mathematical. This tool does not provide trading recommendations or predictive signals.

Retrieve known scheduled macroeconomic and central-bank risks that may affect a supported FX instrument within a future time window. Use this tool when the user asks what could move EURUSD, what macro risks are coming up, what is happening in the next 24 hours, what upcoming macro risks or scheduled events exist, or when the next CPI, next Fed, or next ECB event occurs. The initial supported risks are U.S. CPI releases, Federal Reserve monetary-policy decisions, and ECB monetary-policy decisions. Results are based on official release calendars and contain scheduled events only. This tool does not predict market direction, include unscheduled news, or provide trading recommendations. If no supported scheduled event exists within the requested horizon, an empty risk list is returned.