Skill: Economic Calendar

When to use

• - The user wants the economic calendar for today, this week, or a custom date range.
• The user asks for upcoming macro events, scheduled releases, or high/medium/low impact events.
• The user wants a forward-looking list of calendar items before trading.

When NOT to use

• - The user wants broad market news and sentiment only -> use INLINECODE0
• The user wants a stock price or company-specific quote -> use INLINECODE1
• The user wants company fundamentals -> use INLINECODE2

Authentication

• - Preferred: set TRADING_ECONOMICS_API_KEY to your TradingEconomics credential string
• Supported value format: INLINECODE4
• Optional: copy .env.example to .env at the repo root and fill in INLINECODE7
• Fallback: if no API key is present, the script uses Yahoo Finance's economic calendar endpoint
• Important: Yahoo fallback can omit importance and market-expectation fields, and country values are returned as short codes like US, EU, or INLINECODE10

Commands

Get the default calendar window

CODEBLOCK0

Defaults to 7 days inclusive from the query day.

Get a custom calendar window

CODEBLOCK1

Dates must use YYYY-MM-DD.

Examples

CODEBLOCK2

Output

The command returns:

• - Requested date range
• Auth source used (TradingEconomics API or Yahoo Finance fallback)
• Total event count and covered day count
• Events grouped by day
• For each event: UTC time, country, event name, and available actual / forecast / previous values

Notes

• - The script reads TRADING_ECONOMICS_API_KEY from the environment first.
• If no env var is set, it also checks a repo-root .env file before falling back to Yahoo Finance.
• Yahoo fallback is better than guest TradingEconomics for current/future windows, but it does not expose the same richness of metadata.
• Do NOT use the economic-calendar-pro.sh wrapper in normal skill execution - call uv run src/main.py directly as shown above.
• Do NOT use web search for this workflow - use the script so the output is date-filtered and formatted consistently.