FX Context
FX macro context for CPI, NFP, PCE, Fed, ECB, BoE, BoJ, historical analogs, and FX market reactions.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (4)
- HIGHTool poisoning patterns detected
- LOWTool 'get_historical_reaction_context' name length outside 3-30 rangein get_historical_reaction_context
- LOWTool description contains negative instruction about its own usein get_historical_analogs
- LOWTool description contains negative instruction about its own usein get_historical_reaction_context
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"fx-context": {
"url": "https://fx.coco-pier.com/mcp"
}
}
}Remote-Endpunkte
https://fx.coco-pier.com/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (6)
🟢get_central_bank_changes(centralBank, currentStatementDate)
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, ECB, BANK_OF_ENGLAND (alias BOE), or BANK_OF_JAPAN (alias BOJ). 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.
Eingabe-Schema
{
"type": "object",
"properties": {
"centralBank": {
"type": "string",
"description": "Canonical central bank identifier: FEDERAL_RESERVE, ECB, BANK_OF_ENGLAND (alias BOE), or BANK_OF_JAPAN (alias BOJ)."
},
"currentStatementDate": {
"type": "string",
"description": "Optional publication date in YYYY-MM-DD format (e.g. 2024-07-31). If omitted, the latest available statement is compared with the previous one."
}
},
"required": [
"centralBank"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"centralBank": {
"type": "string"
},
"changes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"changeType": {
"type": "string",
"enum": [
"ADDED",
"REMOVED",
"STRENGTHENED",
"SOFTENED",
"REFRAMED",
"UNCHANGED"
]
},
"currentQuote": {
"type": "string"
},
"direction": {
"type": "string",
"enum": [
"HAWKISH",
"DOVISH",
"NEUTRAL",
"UNCHANGED",
"UNCLEAR",
"MIXED"
]
},
"materiality": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW"
]
},
"previousQuote": {
"type": "string"
},
"summary": {
"type": "string"
},
"topic": {
"type": "string",
"enum": [
"POLICY_ACTION",
"INFLATION",
"GROWTH",
"LABOR_MARKET",
"FORWARD_GUIDANCE",
"RISK_BALANCE",
"POLICY_BIAS",
"OTHER"
]
}
},
"required": [
"changeType",
"direction",
"materiality",
"summary",
"topic"
]
}
},
"currentPolicyAction": {
"type": "string",
"enum": [
"HIKE",
"CUT",
"HOLD",
"OTHER",
"UNCLEAR"
]
},
"currentPolicyBias": {
"type": "string",
"enum": [
"HAWKISH",
"DOVISH",
"NEUTRAL",
"MIXED",
"UNCLEAR"
]
},
"currentSourceUri": {
"type": "string",
"format": "uri"
},
"currentStatementDate": {
"type": "string",
"format": "date"
},
"currentStatementId": {
"type": "string"
},
"degraded": {
"type": "boolean"
},
"discardedChangeCount": {
"type": "integer",
"format": "int32"
},
"freshness": {
"type": "object",
"properties": {
"latestAvailableEvent": {
"type": "string",
"format": "date-time"
},
"latestExpectedEvent": {
"type": "string",
"format": "date-time"
},
"missingExpectedStatement": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"CURRENT",
"PENDING",
"STALE",
"UNKNOWN"
]
}
},
"required": [
"missingExpectedStatement",
"status"
]
},
"overallShift": {
"type": "string",
"enum": [
"HAWKISH",
"DOVISH",
"MIXED",
"UNCHANGED",
"UNCLEAR"
]
},
"previousSourceUri": {
"type": "string",
"format": "uri"
},
"previousStatementDate": {
"type": "string",
"format": "date"
},
"previousStatementId": {
"type": "string"
}
},
"required": [
"centralBank",
"changes",
"currentPolicyAction",
"currentPolicyBias",
"currentSourceUri",
"currentStatementDate",
"currentStatementId",
"overallShift",
"previousSourceUri",
"previousStatementDate",
"previousStatementId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_event_context(eventType, referencePeriod)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"eventType": {
"type": "string",
"description": "Canonical financial event type.\n\nSupported values:\nUS_CPI\nUS_NONFARM_PAYROLLS\nUS_PCE\n\nUse these values exactly."
},
"referencePeriod": {
"type": "string",
"description": "Optional reference period in YYYY-MM format (e.g. 2026-08). If omitted, the latest available event of that type is returned."
}
},
"required": [
"eventType"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"affectedCurrencies": {
"type": "array",
"items": {
"type": "string"
}
},
"category": {
"type": "string"
},
"eventId": {
"type": "string"
},
"eventType": {
"type": "string"
},
"jurisdiction": {
"type": "string"
},
"observations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"derivationMethod": {
"type": "string"
},
"derivedActual": {
"type": "string"
},
"expectation": {
"type": "object",
"properties": {
"capturedAt": {
"type": "string",
"format": "date-time"
},
"consensus": {
"type": "string"
},
"source": {
"$ref": "#/$defs/SourceContextResponse"
}
},
"required": [
"capturedAt",
"consensus",
"source"
]
},
"metric": {
"type": "string"
},
"publishedAt": {
"type": "string",
"format": "date-time"
},
"reportedActual": {
"type": "string"
},
"revised": {
"type": "boolean"
},
"surprise": {
"type": "object",
"properties": {
"basis": {
"type": "string"
},
"derivedActual": {
"type": "string"
},
"direction": {
"type": "string"
},
"reportedActual": {
"type": "string"
},
"unit": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"direction",
"unit",
"value"
]
},
"unit": {
"type": "string"
},
"value": {
"type": "string"
},
"valueType": {
"type": "string"
},
"versionCount": {
"type": "integer",
"format": "int32"
}
},
"required": [
"metric",
"publishedAt",
"revised",
"unit",
"value",
"versionCount"
]
}
},
"referencePeriod": {
"type": "string"
},
"releasedAt": {
"type": "string",
"format": "date-time"
},
"scheduledAt": {
"type": "string",
"format": "date-time"
},
"source": {
"$ref": "#/$defs/SourceContextResponse"
},
"status": {
"type": "string"
}
},
"required": [
"affectedCurrencies",
"category",
"eventId",
"eventType",
"jurisdiction",
"observations",
"scheduledAt",
"source",
"status"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$defs": {
"SourceContextResponse": {
"type": "object",
"properties": {
"externalId": {
"type": "string"
},
"provider": {
"type": "string"
},
"retrievedAt": {
"type": "string",
"format": "date-time"
},
"uri": {
"type": "string"
}
},
"required": [
"provider",
"retrievedAt"
]
}
}
}🟢get_historical_analogs(eventType, referencePeriod, instrument, maxAnalogs)
Find and return individual historical macroeconomic releases whose surprise profiles are most similar to a selected target 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 post-release reaction. Supported event types: US_CPI and US_NONFARM_PAYROLLS across EURUSD, GBPUSD, and USDJPY. US_PCE is recognized but not yet publicly available: the historical PCE calibration corpus currently has too few usable periods, and a request for US_PCE returns a structured INSUFFICIENT_HISTORICAL_CALIBRATION error (with usable/required event counts) instead of analog results until the corpus grows. Similarity methodology is event-specific: US_CPI uses headline/core surprise distance; US_NONFARM_PAYROLLS uses target-relative robust scale normalization (nfp-historical-analog-v1); US_PCE (once activated) uses the same raw surprise -distance approach as US_CPI (pce-historical-analog-v1). Do NOT use this tool when the user's primary question is about aggregate behavior across the analog sample; use get_historical_reaction_context instead. The results are historical observations only and do not predict future price direction or provide trading recommendations.
Eingabe-Schema
{
"type": "object",
"properties": {
"eventType": {
"type": "string",
"description": "Canonical target event type: US_CPI, US_NONFARM_PAYROLLS, or US_PCE."
},
"referencePeriod": {
"type": "string",
"description": "Optional reference period in YYYY-MM format (e.g. 2024-06 or 2026-08). If omitted, the latest available event is resolved as the target."
},
"instrument": {
"type": "string",
"description": "Optional trading instrument: EURUSD, GBPUSD, or USDJPY. Defaults to EURUSD."
},
"maxAnalogs": {
"type": "integer",
"format": "int32",
"description": "Optional maximum number of individual analogs to return (range 3 to 30, default 10)."
}
},
"required": [
"eventType"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"analogs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"comparableMetricCount": {
"type": "integer",
"format": "int32"
},
"directionMatchCount": {
"type": "integer",
"format": "int32"
},
"eventId": {
"type": "string"
},
"m5ToH1Persistence": {
"type": "string",
"enum": [
"PERSISTED",
"REVERSED",
"FADED",
"UNCHANGED"
]
},
"reaction": {
"type": "object"
},
"reactionWindowStates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"assessedAt": {
"type": "string",
"format": "date-time"
},
"boundary": {
"type": "string",
"format": "date-time"
},
"reason": {
"type": "string",
"enum": [
"MARKET_CLOSED",
"MARKET_DATA_UNAVAILABLE",
"PROVIDER_FAILURE"
]
},
"status": {
"type": "string",
"enum": [
"CALCULATED",
"PENDING",
"RETRYABLE",
"TERMINAL_UNAVAILABLE"
]
},
"window": {
"$ref": "#/$defs/ReactionWindowType"
}
},
"required": [
"assessedAt",
"boundary",
"status",
"window"
]
}
},
"referencePeriod": {
"type": "string"
},
"releasedAt": {
"type": "string",
"format": "date-time"
},
"similarityQuality": {
"type": "string",
"enum": [
"EXACT_PATTERN",
"STRONG",
"PARTIAL"
]
},
"surpriseProfile": {},
"totalSurpriseDistance": {
"type": "number"
}
},
"required": [
"comparableMetricCount",
"directionMatchCount",
"eventId",
"reaction",
"reactionWindowStates",
"referencePeriod",
"releasedAt",
"similarityQuality",
"surpriseProfile",
"totalSurpriseDistance"
]
}
},
"coverage": {
"type": "object",
"properties": {
"candidateEventsScanned": {
"type": "integer",
"format": "int32"
},
"candidateRange": {
"$ref": "#/$defs/CoveragePeriodRange"
},
"continuousCoverage": {
"$ref": "#/$defs/CoveragePeriodRange"
},
"earliestEligibleReferencePeriod": {
"type": "string"
},
"eligibleHistoricalEvents": {
"type": "integer",
"format": "int32"
},
"eligibleRange": {
"$ref": "#/$defs/CoveragePeriodRange"
},
"historyComplete": {
"type": "boolean"
},
"latestEligibleReferencePeriod": {
"type": "string"
},
"missingExpectationPeriods": {
"type": "array",
"items": {
"type": "string"
}
},
"returnedAnalogs": {
"type": "integer",
"format": "int32"
},
"withMinimumSurpriseMetrics": {
"type": "integer",
"format": "int32"
},
"withReaction": {
"type": "integer",
"format": "int32"
},
"withValidConsensus": {
"type": "integer",
"format": "int32"
}
},
"required": [
"candidateEventsScanned",
"eligibleHistoricalEvents",
"historyComplete",
"returnedAnalogs",
"withMinimumSurpriseMetrics",
"withReaction",
"withValidConsensus"
]
},
"eventType": {
"type": "string"
},
"instrument": {
"type": "string"
},
"methodology": {
"type": "object",
"properties": {
"minimumComparableMetrics": {
"type": "integer",
"format": "int32"
},
"ranking": {
"type": "array",
"items": {
"type": "string"
}
},
"version": {
"type": "string"
}
},
"required": [
"minimumComparableMetrics",
"ranking",
"version"
]
},
"methodologyVersion": {
"type": "string"
},
"reactionStatistics": {
"type": "array",
"items": {
"type": "object",
"properties": {
"flatCount": {
"type": "integer",
"format": "int32"
},
"maxReturnPct": {
"type": "number"
},
"meanReturnPct": {
"type": "number"
},
"medianReturnPct": {
"type": "number"
},
"minReturnPct": {
"type": "number"
},
"negativeCount": {
"type": "integer",
"format": "int32"
},
"positiveCount": {
"type": "integer",
"format": "int32"
},
"sampleSize": {
"type": "integer",
"format": "int32"
},
"window": {
"$ref": "#/$defs/ReactionWindowType"
}
},
"required": [
"flatCount",
"maxReturnPct",
"meanReturnPct",
"medianReturnPct",
"minReturnPct",
"negativeCount",
"positiveCount",
"sampleSize",
"window"
]
}
},
"referencePeriod": {
"type": "string"
},
"targetSurprise": {}
},
"required": [
"analogs",
"coverage",
"eventType",
"instrument",
"methodology",
"methodologyVersion",
"reactionStatistics",
"referencePeriod",
"targetSurprise"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$defs": {
"CoveragePeriodRange": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
}
},
"ReactionWindowType": {
"type": "string",
"enum": [
"M5",
"M15",
"H1",
"H4",
"H24"
]
}
}
}🟢get_historical_reaction_context(eventType, referencePeriod, instrument, limit)
Summarize the aggregate post-event reaction pattern across historical macroeconomic events similar to a selected target release. 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. Supported event types: US_CPI and US_NONFARM_PAYROLLS across EURUSD, GBPUSD, and USDJPY. Similarity methodology is event-specific: US_CPI uses headline/core surprise distance; US_NONFARM_PAYROLLS uses target-relative robust scale normalization (nfp-historical-analog-v1). 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.
Eingabe-Schema
{
"type": "object",
"properties": {
"eventType": {
"type": "string",
"description": "Canonical target event type: US_CPI or US_NONFARM_PAYROLLS."
},
"referencePeriod": {
"type": "string",
"description": "Optional reference period in YYYY-MM format (e.g. 2024-06 or 2026-08). If omitted, the latest available event is used as the target."
},
"instrument": {
"type": "string",
"description": "Optional trading instrument: EURUSD, GBPUSD, or USDJPY. Defaults to EURUSD."
},
"limit": {
"type": "integer",
"format": "int32",
"description": "Optional maximum number of similar historical events to include in aggregate analysis (range 3 to 30, default 10)."
}
},
"required": [
"eventType"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"aggregatePattern": {
"type": "object",
"properties": {
"confidence": {
"type": "string",
"enum": [
"VERY_LOW",
"LOW",
"MODERATE",
"HIGH"
]
},
"dominantWindow": {
"type": "string",
"enum": [
"M5",
"M15",
"H1",
"H4",
"H24"
]
},
"persistence": {
"type": "string"
},
"rationale": {
"type": "string"
},
"shortTermBias": {
"type": "string",
"enum": [
"POSITIVE",
"NEGATIVE",
"MIXED",
"NEUTRAL"
]
}
},
"required": [
"confidence",
"persistence",
"rationale",
"shortTermBias"
]
},
"analogs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"directionMatchCount": {
"type": "integer",
"format": "int32"
},
"eventId": {
"type": "string"
},
"persistence": {
"type": "string",
"enum": [
"PERSISTED",
"REVERSED",
"FADED",
"UNCHANGED"
]
},
"reaction": {
"type": "object"
},
"reactionPath": {
"type": "string",
"enum": [
"IMMEDIATE_CONTINUATION",
"INITIAL_REVERSAL",
"FADE",
"DELAYED_REACTION",
"WHIPSAW",
"NO_CLEAR_PATTERN"
]
},
"referencePeriod": {
"type": "string"
},
"releasedAt": {
"type": "string",
"format": "date-time"
},
"similarityQuality": {
"type": "string",
"enum": [
"EXACT_PATTERN",
"STRONG",
"PARTIAL"
]
},
"surpriseProfile": {},
"totalSurpriseDistance": {
"type": "number"
}
},
"required": [
"directionMatchCount",
"eventId",
"reaction",
"reactionPath",
"referencePeriod",
"releasedAt",
"similarityQuality",
"surpriseProfile",
"totalSurpriseDistance"
]
}
},
"coverage": {
"type": "object",
"properties": {
"analogEligibleEvents": {
"type": "integer",
"format": "int32"
},
"candidateHistoricalEvents": {
"type": "integer",
"format": "int32"
},
"candidateRange": {
"$ref": "#/$defs/CoveragePeriodRange"
},
"continuousCoverage": {
"$ref": "#/$defs/CoveragePeriodRange"
},
"eligibleRange": {
"$ref": "#/$defs/CoveragePeriodRange"
},
"eventsWithActuals": {
"type": "integer",
"format": "int32"
},
"eventsWithMarketReaction": {
"type": "integer",
"format": "int32"
},
"eventsWithValidExpectations": {
"type": "integer",
"format": "int32"
},
"historyComplete": {
"type": "boolean"
},
"missingExpectationPeriods": {
"type": "array",
"items": {
"type": "string"
}
},
"returnedAnalogs": {
"type": "integer",
"format": "int32"
}
},
"required": [
"analogEligibleEvents",
"candidateHistoricalEvents",
"eventsWithActuals",
"eventsWithMarketReaction",
"eventsWithValidExpectations",
"historyComplete",
"returnedAnalogs"
]
},
"eventType": {
"type": "string"
},
"instrument": {
"type": "string"
},
"reactionStatistics": {
"type": "object"
},
"referencePeriod": {
"type": "string"
},
"targetSurpriseProfile": {}
},
"required": [
"aggregatePattern",
"analogs",
"coverage",
"eventType",
"instrument",
"reactionStatistics",
"referencePeriod",
"targetSurpriseProfile"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$defs": {
"CoveragePeriodRange": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
}
}
}
}🟢get_market_reaction(targetType, dateOrPeriod, instrument)
Retrieve deterministic post-event market reaction metrics for an economic release or monetary policy statement. Specify the targetType, such as US_CPI, US_PCE (alias PCE), US_NONFARM_PAYROLLS (alias NFP), FEDERAL_RESERVE, ECB, BANK_OF_ENGLAND (alias BOE), or BANK_OF_JAPAN (alias BOJ). Optionally specify dateOrPeriod: - For US_CPI, US_PCE, and US_NONFARM_PAYROLLS: reference period in YYYY-MM format (e.g. 2024-07). If omitted, the latest event is resolved. - For FEDERAL_RESERVE, ECB, BANK_OF_ENGLAND, or BANK_OF_JAPAN: statement date in YYYY-MM-DD format (e.g. 2024-08-01). If omitted, the latest statement is resolved. Optionally specify instrument: EURUSD, GBPUSD, or USDJPY (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.
Eingabe-Schema
{
"type": "object",
"properties": {
"targetType": {
"type": "string",
"description": "Canonical target event type: US_CPI, US_PCE (alias PCE), US_NONFARM_PAYROLLS (alias NFP), FEDERAL_RESERVE, ECB, BANK_OF_ENGLAND (alias BOE), or BANK_OF_JAPAN (alias BOJ)."
},
"dateOrPeriod": {
"type": "string",
"description": "Optional reference period (YYYY-MM for US_CPI, US_PCE, and US_NONFARM_PAYROLLS) or statement date (YYYY-MM-DD for central banks). If omitted, the latest event is returned."
},
"instrument": {
"type": "string",
"description": "Optional trading instrument: EURUSD, GBPUSD, or USDJPY. Defaults to EURUSD."
}
},
"required": [
"targetType"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"calculatedAt": {
"type": "string",
"format": "date-time"
},
"coverageStatus": {
"type": "string"
},
"eventTime": {
"type": "string",
"format": "date-time"
},
"freshness": {
"type": "object",
"properties": {
"latestAvailableEvent": {
"type": "string",
"format": "date-time"
},
"latestExpectedEvent": {
"type": "string",
"format": "date-time"
},
"missingExpectedStatement": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"CURRENT",
"PENDING",
"STALE",
"UNKNOWN"
]
}
},
"required": [
"missingExpectedStatement",
"status"
]
},
"instrument": {
"type": "string"
},
"isComplete": {
"type": "boolean"
},
"isSettled": {
"type": "boolean"
},
"marketDataSource": {
"type": "string"
},
"reactionCoverage": {
"type": "object",
"properties": {
"availableWindows": {
"type": "array",
"items": {
"type": "string"
}
},
"isSettled": {
"type": "boolean"
},
"status": {
"type": "string"
},
"unavailableWindows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"boundary": {
"type": "string",
"format": "date-time"
},
"reason": {
"type": "string"
},
"status": {
"type": "string"
},
"window": {
"type": "string"
}
},
"required": [
"boundary",
"status",
"window"
]
}
}
},
"required": [
"availableWindows",
"isSettled",
"status",
"unavailableWindows"
]
},
"reactionId": {
"type": "string"
},
"targetDescription": {
"type": "string"
},
"targetId": {
"type": "string"
},
"targetType": {
"type": "string"
},
"windows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"calculatedAt": {
"type": "string",
"format": "date-time"
},
"endPrice": {
"type": "number"
},
"high": {
"type": "number"
},
"low": {
"type": "number"
},
"maxDownMovePct": {
"type": "number"
},
"maxUpMovePct": {
"type": "number"
},
"rangePct": {
"type": "number"
},
"returnPct": {
"type": "number"
},
"startPrice": {
"type": "number"
},
"windowType": {
"type": "string"
}
},
"required": [
"calculatedAt",
"endPrice",
"high",
"low",
"maxDownMovePct",
"maxUpMovePct",
"rangePct",
"returnPct",
"startPrice",
"windowType"
]
}
}
},
"required": [
"calculatedAt",
"eventTime",
"instrument",
"isComplete",
"isSettled",
"marketDataSource",
"reactionId",
"targetDescription",
"targetId",
"targetType",
"windows"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_upcoming_risks(instrument, horizonHours)
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, GBPUSD, or USDJPY, 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 PCE, next Fed, next ECB, next BoE, or next BoJ event occurs. The supported risks are U.S. CPI releases, U.S. PCE inflation releases, Federal Reserve monetary-policy decisions, ECB monetary-policy decisions, Bank of England monetary-policy decisions, and Bank of Japan 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.
Eingabe-Schema
{
"type": "object",
"properties": {
"instrument": {
"type": "string",
"description": "FX instrument: EURUSD, GBPUSD, or USDJPY. Defaults to EURUSD."
},
"horizonHours": {
"type": "integer",
"format": "int32",
"description": "Future time window in hours. Defaults to 24. Maximum is 168 (7 days)."
}
},
"required": [],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"asOf": {
"type": "string",
"format": "date-time"
},
"horizonHours": {
"type": "integer",
"format": "int32"
},
"instrument": {
"type": "string"
},
"risks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"affectedCurrencies": {
"type": "array",
"items": {
"type": "string"
}
},
"eventType": {
"type": "string",
"enum": [
"US_CPI",
"US_NONFARM_PAYROLLS",
"US_PCE",
"FEDERAL_RESERVE",
"ECB",
"BANK_OF_ENGLAND",
"BANK_OF_JAPAN"
]
},
"importance": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW"
]
},
"jurisdiction": {
"type": "string"
},
"minutesUntil": {
"type": "integer",
"format": "int64"
},
"reason": {
"type": "string"
},
"scheduledAt": {
"type": "string",
"format": "date-time"
},
"source": {
"type": "object",
"properties": {
"externalId": {
"type": "string"
},
"provider": {
"type": "string"
},
"retrievedAt": {
"type": "string",
"format": "date-time"
},
"uri": {
"type": "string",
"format": "uri"
}
},
"required": [
"externalId",
"provider",
"retrievedAt",
"uri"
]
}
},
"required": [
"affectedCurrencies",
"eventType",
"importance",
"jurisdiction",
"minutesUntil",
"reason",
"scheduledAt",
"source"
]
}
},
"windowEnd": {
"type": "string",
"format": "date-time"
}
},
"required": [
"asOf",
"horizonHours",
"instrument",
"risks",
"windowEnd"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis