fxmacrodata-calendar

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

FXMacroData Calendar

FXMacroData 日历

Retrieve official-source macro release-calendar events from FXMacroData. Use this skill when a trade plan needs event timing, confirmed release dates, or a top-tier macro risk check.

从FXMacroData获取官方来源的宏观数据发布日历事件。当交易计划需要事件时间安排、确认的发布日期或顶级宏观风险检查时，请使用此技能。

Workflow

工作流程

Run the calendar script:

bash

python3 skills/fxmacrodata-calendar/scripts/fetch_calendar.py --currency usd --min-tier 1

Review
```
events[]
```
for top-tier releases.
Treat a nonzero exit as an unverified event-risk state, never as an empty calendar. Only a successful response containing
```
events: []
```
establishes that no matching events were returned. The client accepts results only when the response currency matches the request and
```
data_quality
```
confirms an official, current, non-proxy, non-fallback, timestamp-complete, point-in-time-safe source. Each event must include an announcement timestamp and a non-empty release identifier.
Fold the event timing into the trade plan:
- pause new entries around high-impact releases;
- reduce leverage or position size;
- schedule follow-up review after the actual value is available;
- explain which event and timestamp drove the adjustment.

运行日历脚本：

bash

python3 skills/fxmacrodata-calendar/scripts/fetch_calendar.py --currency usd --min-tier 1

查看
```
events[]
```
中的顶级发布事件。
非零退出码表示事件风险状态未经验证，绝不能视为日历为空。只有包含
```
events: []
```
的成功响应才能确定没有返回匹配的事件。客户端仅接受响应货币与请求匹配且
```
data_quality
```
确认来源为官方、当前、非代理、非 fallback、时间戳完整、时点安全的结果。每个事件必须包含公告时间戳和非空的发布标识符。
将事件时间整合到交易计划中：
- 在高影响发布时段暂停新仓位入场；
- 降低杠杆或仓位规模；
- 在实际数值公布后安排后续复盘；
- 说明是哪一事件及其时间戳驱动了调整。

Authentication

身份验证

Set

FXMACRODATA_API_KEY

for authenticated FXMacroData endpoints. Public USD calendar rows can be fetched without a key. The client uses the canonical

https://api.fxmacrodata.com/v1

endpoint and accepts

--min-tier

values 1, 2, or 3 only. Live calendar responses currently include

market_tier

; the skill treats it as an extension field and requires integer values 1 through 3 for filtering, although the current

CalendarReleaseRow

OpenAPI schema does not declare that field.

设置

FXMACRODATA_API_KEY

以访问需要身份验证的FXMacroData端点。无需密钥即可获取公开的USD日历数据。客户端使用标准的

https://api.fxmacrodata.com/v1

端点，且仅接受

--min-tier

取值为1、2或3。当前实时日历响应包含

market_tier

字段；本技能将其视为扩展字段，要求使用1到3的整数值进行过滤，尽管当前

CalendarReleaseRow

的OpenAPI架构并未声明该字段。