Economic Calendar

Fetch and display filtered macro-economic events from Investing.com with no API key, supporting date range, importance, country, timezone, and JSON output.

Fetch macro-economic events (Fed, ECB, CPI, etc.) from Investing.com. No API key required — pure scraping.

Usage

bash

# Today's high-importance US events (table output)
python scripts/economic_calendar.py

# Specific date with custom filters
python scripts/economic_calendar.py --date 2026-03-01 --importance high medium --countries "united states" germany

# Multiple days (next 7 days)
python scripts/economic_calendar.py --days 7 --importance high medium --countries "united states"

# JSON to stdout (for automation/piping)
python scripts/economic_calendar.py --date tomorrow --json stdout

# JSON to file (default: calendar_YYYYMMDD.json)
python scripts/economic_calendar.py --days 3 --json file

Options

Flag	Description	Default
--date	Start date: today, tomorrow, yesterday, or YYYY-MM-DD	today
--days	Fetch range of N days (overrides --date)	—
--importance	Filter levels: low, medium, high (space-separated)	high
--countries	Countries (space-separated, quotes for multi-word)	united states
--timezone	Timezone for event times	GMT +1:00
--json	JSON mode: file, stdout, none	file

Countries

Available country names (use quotes for multi-word):

• united states
• germany
• united kingdom
• france
• japan
• china
• canada
• australia
• switzerland
• eurozone

Timezones

Common timezones:

• GMT +1:00 — Berlin/Vienna (CET) ✓ default
• GMT +2:00 — Berlin/Vienna (CEST)
• GMT -5:00 — New York (EST)
• GMT -4:00 — New York (EDT)
• GMT — UTC

Output Formats

Table (default)

Human-readable formatted table to stdout:

text

================================================================================
  Economic Calendar  |  25.02.2026
  Countries: United States  |  Timezone: GMT +1:00  |  Importance: high
================================================================================
  Time    Imp.     Curr.  Event                          Forecast  Previous  Actual
  ------- -------- ------ ------------------------------ --------- --------- --------
  14:30   high     USD    Unemployment Claims            215K      219K      —
  14:30   high     USD    Core PPI m/m                   0.3%      0.4%      —
================================================================================
  2 event(s) found.

JSON

json

{
  "from": "2026-02-25",
  "to": "2026-02-25",
  "timezone": "GMT +1:00",
  "importances": ["high"],
  "countries": ["united states"],
  "events": [
    {
      "date": "Tuesday, February 25, 2026",
      "time": "14:30",
      "currency": "USD",
      "importance": 3,
      "event": "Unemployment Claims",
      "actual": "",
      "forecast": "215K",
      "previous": "219K"
    }
  ]
}

Dependencies

bash

pip install requests beautifulsoup4 lxml

Notes

• Source: Investing.com (server-side rendered, reliable CSS selectors)
• Rate limiting: Built-in delays between requests
• Session handling: Maintains cookies across requests for proper session state
• Data validity: Historical data + 1+ years forward
• No API key: All data is publicly scraped

Use in Workflows

bash

# Daily briefing — get today's high/medium US events as JSON
python3 skills/economic-calendar/scripts/economic_calendar.py \
  --date today \
  --importance high medium \
  --countries "united states" \
  --json stdout