FX Context
FX macro context for CPI, NFP, PCE, Fed, ECB, BoE, BoJ, historical analogs, and FX market reactions.
我该使用它吗
质量与安全性
发现（4）
- HIGHTool poisoning patterns detected
- LOWTool 'get_historical_reaction_context' name length outside 3-30 range在 get_historical_reaction_context 中
- LOWTool description contains negative instruction about its own use在 get_historical_analogs 中
- LOWTool description contains negative instruction about its own use在 get_historical_reaction_context 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"fx-context": {
"url": "https://fx.coco-pier.com/mcp"
}
}
}远程端点
https://fx.coco-pier.com/mcpstreamable-http它能做什么
工具清单
工具（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.
输入模式
{
"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"
}输出模式
{
"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.
输入模式
{
"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"
}输出模式
{
"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.
输入模式
{
"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"
}输出模式
{
"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.
输入模式
{
"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"
}输出模式
{
"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.
输入模式
{
"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"
}输出模式
{
"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.
输入模式
{
"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"
}输出模式
{
"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"
}社区
证据