Agent skill · data analytics · tradermonty
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.
Why this skill is useful
Adds a Python script to fetch macroeconomic event data from FXMacroData, which is not commonly known or available in public documentation.
What it needs
Requires python3 installed locally. Requires fxmacrodata account access. About 1k tokens when loaded. Last updated 2026-08-06. 2,581 stars on the source repository.
What this skill does
FXMacroData Calendar Retrieve official-source macro release-calendar events from FXMacroData. Use this skill when a trade plan needs event timing, confirmed release dates, or a top-tier macro risk check. Workflow 1. Run the calendar script: 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 dataquality 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. Authentication Set FXMACRODATAAPIKEY for authenticated FXMacroData endpoints. Public USD calendar rows can be fetched without a key. The client uses the canonical https://api.fxmacrodata.com/v1 endpoint and accepts --min-tier values 1, 2, or 3 only. Live calendar responses currently include markettier; the skill treats it as an extension field and requires integer values 1 through 3 for filtering, although the current CalendarReleaseRow OpenAPI schema does not declare that field.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills tradermonty/fxmacrodata-calendar