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 rangeget_historical_reaction_context 内
- LOWTool description contains negative instruction about its own useget_historical_analogs 内
- LOWTool description contains negative instruction about its own useget_historical_reaction_context 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `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"
}コミュニティ
エビデンス