Economic Calendar & Macro Data
Track macroeconomic events and economic indicators that impact crypto markets.
Data Sources
1. FRED API (Federal Reserve Economic Data)
https://api.stlouisfed.org/fred/
If
is set, use it. Otherwise, note the data is unavailable and suggest the user register for a free key.
Key Series
| Series ID | Description |
|---|
| Federal Funds Effective Rate |
| Consumer Price Index (CPI) |
| Unemployment Rate |
| Gross Domestic Product |
| 10-Year Treasury Yield |
| 2-Year Treasury Yield |
| 10Y-2Y Spread (yield curve) |
| M2 Money Supply |
| Fed Balance Sheet Total Assets |
| USD/EUR Exchange Rate |
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
https://finnhub.io/api/v1/calendar/economic
Free API key: register at
https://finnhub.io. Set
.
Endpoint
GET /calendar/economic?from={YYYY-MM-DD}&to={YYYY-MM-DD}&token={key}
Returns upcoming economic events with:
- — event name
- — country code
- — , ,
- / / — data values
- — event timestamp
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 |
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 |
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
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 for full market context
- If no API keys are available, summarize what data would be accessible and suggest registration
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