FXMacroData Calendar runs a small Python script that calls the FXMacroData API and returns upcoming macro release events for a chosen currency, such as CPI, NFP, GDP, PCE, retail sales, PMI and central-bank decisions. Results can be filtered to tier 1, 2 or 3 releases.
The client accepts a response only when it is for the requested currency and its data-quality fields confirm an official, current, timestamped source. A failed call is treated as unverified event risk, never as an empty calendar. It describes release timing and gives no investment advice.
What You Get
- A list of macro release events with announcement timestamps and release identifiers
- Filtering by currency and by importance tier from 1 to 3
- A nonzero exit code when data cannot be verified, so a failure is never read as a quiet calendar
- Public USD calendar rows without a key, and authenticated endpoints with one
Common Use Cases
- Checking for CPI, NFP or GDP releases before opening a position
- Looking at central-bank decision windows for a currency pair
- Listing top-tier events for the week as part of a macro regime check
- Noting which event and timestamp drove a change to a trade plan
What Makes It Unique
The client validates what it receives: the response currency must match the request, and the data-quality fields must confirm an official, current, non-proxy, non-fallback, point-in-time-safe source. Each event needs a timestamp and a release identifier. Only a successful response with an empty events list counts as no events, so an outage cannot look like a safe day.
Under The Hood
Claude runs a Python script (fetch_calendar.py) from the skill folder through the shell. The script uses only the standard library and calls the FXMacroData web API at api.fxmacrodata.com. It reads an optional API key from the FXMACRODATA_API_KEY environment variable. It checks the response, prints the events and returns a nonzero exit code if verification fails.