macro-calendar

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Economic Calendar & Macro Data

经济日历与宏观数据

Track macroeconomic events and economic indicators that impact crypto markets.

追踪影响加密货币市场的宏观经济事件和经济指标。

Data Sources

数据来源

1. FRED API (Federal Reserve Economic Data)

1. FRED API（Federal Reserve Economic Data）

https://api.stlouisfed.org/fred/

Free API key: register at https://fred.stlouisfed.org/docs/api/api_key.html

FRED_API_KEY

is set, use it. Otherwise, note the data is unavailable and suggest the user register for a free key.

https://api.stlouisfed.org/fred/

免费API密钥：在https://fred.stlouisfed.org/docs/api/api_key.html注册获取。

如果已设置

FRED_API_KEY

，则使用该密钥；否则，提示数据不可用并建议用户注册免费密钥。

Key Series

核心数据序列

Series ID	Description
`FEDFUNDS`	Federal Funds Effective Rate
`CPIAUCSL`	Consumer Price Index (CPI)
`UNRATE`	Unemployment Rate
`GDP`	Gross Domestic Product
`DGS10`	10-Year Treasury Yield
`DGS2`	2-Year Treasury Yield
`T10Y2Y`	10Y-2Y Spread (yield curve)
`M2SL`	M2 Money Supply
`WALCL`	Fed Balance Sheet Total Assets
`DEXUSEU`	USD/EUR Exchange Rate

序列ID	描述
`FEDFUNDS`	联邦基金有效利率
`CPIAUCSL`	消费者价格指数（CPI）
`UNRATE`	失业率
`GDP`	国内生产总值
`DGS10`	10年期美国国债收益率
`DGS2`	2年期美国国债收益率
`T10Y2Y`	10年期与2年期国债利差（收益率曲线）
`M2SL`	M2货币供应量
`WALCL`	美联储资产负债表总资产
`DEXUSEU`	美元/欧元汇率

Endpoints

接口端点

Latest observation:

GET /fred/series/observations?series_id={id}&sort_order=desc&limit=1&api_key={key}&file_type=json

Historical data:

GET /fred/series/observations?series_id={id}&observation_start={YYYY-MM-DD}&api_key={key}&file_type=json

Series metadata:

GET /fred/series?series_id={id}&api_key={key}&file_type=json

2. Finnhub Economic Calendar

2. Finnhub经济日历

https://finnhub.io/api/v1/calendar/economic

Free API key: register at https://finnhub.io. Set

FINNHUB_API_KEY

https://finnhub.io/api/v1/calendar/economic

免费API密钥：在https://finnhub.io注册获取。设置`FINNHUB_API_KEY`环境变量。

Endpoint

接口端点

GET /calendar/economic?from={YYYY-MM-DD}&to={YYYY-MM-DD}&token={key}

Returns upcoming economic events with:

```
event
```
— event name
```
country
```
— country code
```
impact
```
—
```
high
```
,
```
medium
```
,
```
low
```
```
actual
```
/
```
estimate
```
/
```
prev
```
— data values
```
time
```
— event timestamp

GET /calendar/economic?from={YYYY-MM-DD}&to={YYYY-MM-DD}&token={key}

返回即将到来的经济事件，包含以下字段：

```
event
```
— 事件名称
```
country
```
— 国家代码
```
impact
```
—
```
high
```
（高）、
```
medium
```
（中）、
```
low
```
（低）
```
actual
```
/
```
estimate
```
/
```
prev
```
— 实际值/预期值/前值
```
time
```
— 事件时间戳

Key Events for Crypto

对加密货币有影响的核心事件

High Impact

高影响事件

Event	Frequency	Why It Matters
FOMC Rate Decision	8x/year	Rate hikes → risk-off → crypto down
CPI (Inflation)	Monthly	High CPI → more hikes expected
Non-Farm Payrolls (NFP)	Monthly	Strong jobs → hawkish Fed
GDP	Quarterly	Recession fears → flight to safety
PCE Price Index	Monthly	Fed's preferred inflation gauge

事件	频率	重要性原因
FOMC利率决议	每年8次	加息→风险规避→加密货币下跌
CPI（通货膨胀）	每月	CPI高企→市场预期更多加息
非农就业数据（NFP）	每月	就业数据强劲→美联储鹰派立场
GDP（国内生产总值）	每季度	衰退担忧→资金转向安全资产
PCE物价指数	每月	美联储首选的通胀衡量指标

Medium Impact

中影响事件

Event	Frequency	Why It Matters
PMI (Manufacturing)	Monthly	Economic health indicator
Retail Sales	Monthly	Consumer spending strength
Jobless Claims	Weekly	Labor market pulse
ISM Services	Monthly	Service sector health

事件	频率	重要性原因
PMI（制造业）	每月	经济健康状况指标
零售销售	每月	消费者支出强度指标
初请失业金人数	每周	劳动力市场动态
ISM非制造业指数	每月	服务业健康状况指标

Impact on Crypto

对加密货币的影响

General patterns (not financial advice):

Rate cuts / dovish Fed → bullish for crypto (more liquidity)
Rate hikes / hawkish Fed → bearish for crypto (less liquidity)
CPI above expectations → bearish (more hikes coming)
CPI below expectations → bullish (rate cuts possible)
Strong jobs data → mixed (good economy but hawkish Fed)
Yield curve inversion → recession signal, initially bearish then bullish

一般规律（非财务建议）：

降息/美联储鸽派立场 → 对加密货币利好（流动性增加）
加息/美联储鹰派立场 → 对加密货币利空（流动性减少）
CPI高于预期 → 利空（预期更多加息）
CPI低于预期 → 利好（可能降息）
强劲就业数据 → 影响复杂（经济向好但美联储鹰派）
收益率曲线倒挂 → 衰退信号，初期利空随后利好

Usage Notes

使用注意事项

Always note that macro-to-crypto correlation is not guaranteed
Present event times in the user's timezone when possible
For FOMC meetings, note both the date and the press conference time
Combine with
```
crypto-news
```
for full market context
If no API keys are available, summarize what data would be accessible and suggest registration

需注意宏观经济与加密货币的相关性并非绝对
尽可能以用户所在时区展示事件时间
对于FOMC会议，需同时注明会议日期和新闻发布会时间
结合
```
crypto-news
```
获取完整市场背景
如果没有可用的API密钥，概括说明可获取的数据内容并建议用户注册

Example Interactions

示例交互

User: "When is the next Fed meeting?" → Check Finnhub calendar for FOMC events, report date and current rate expectations

User: "What's the current CPI?" → Fetch FRED series CPIAUCSL, report latest reading and YoY change

User: "Any major economic events this week?" → Fetch Finnhub calendar for current week, filter by high impact, list events

User: "How does the yield curve look?" → Fetch DGS10, DGS2, T10Y2Y from FRED, report current spread and inversion status

用户：“下一次美联储会议是什么时候？” → 查看Finnhub日历中的FOMC事件，报告会议日期和当前利率预期

用户：“当前CPI是多少？” → 从FRED获取CPIAUCSL序列数据，报告最新读数及同比变化

用户：“本周有哪些重大经济事件？” → 从Finnhub获取本周日历，筛选高影响事件并列出

用户：“收益率曲线情况如何？” → 从FRED获取DGS10、DGS2、T10Y2Y数据，报告当前利差及倒挂状态