termix-official/cryptoclaw/macro-calendar

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/

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

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

Key Series

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 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

Key Events for Crypto

High Impact

Medium Impact

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 crypto-news 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