Fxmacrodata Calendar

Fetch official FXMacroData macro release-calendar events for trade planning, macro regime checks, and event-risk filters. Use before CPI, NFP, GDP, PCE, retail sales, PMI, and central-bank decision windows.

No API

Download Skill Package (.skill) View Source on GitHub

Table of Contents

1. Overview

FXMacroData Calendar

2. Prerequisites

  • FXMacroData REST API; public USD calendar rows work without a key
  • Python 3.9+ recommended

3. Quick Start 

python3 skills/fxmacrodata-calendar/scripts/fetch_calendar.py --currency usd --min-tier 1

4. Workflow

  1. Run the calendar script:

    python3 skills/fxmacrodata-calendar/scripts/fetch_calendar.py --currency usd --min-tier 1

  2. Review events[] for top-tier releases.

    Treat a nonzero exit as an unverified event-risk state, never as an empty calendar. Only a successful response containing events: [] establishes that no matching events were returned. The client accepts results only when the response currency matches the request and data_quality confirms an official, current, non-proxy, non-fallback, timestamp-complete, point-in-time-safe source. Each event must include an announcement timestamp and a non-empty release identifier.

  3. Fold the event timing into the trade plan:

    • pause new entries around high-impact releases;
    • reduce leverage or position size;
    • schedule follow-up review after the actual value is available;
    • explain which event and timestamp drove the adjustment.

5. Resources

Scripts:

  • skills/fxmacrodata-calendar/scripts/fetch_calendar.py