mcpField
F
fxmacrodata-calendar

fxmacrodata-calendar

github.com/tradermontyOther3.4k2.5k installsUpdated 2d ago
Repository

About fxmacrodata-calendar

fxmacrodata-calendar is a skill for retrieving official-source FXMacroData release dates and using them to assess macro event risk in trade plans. It checks data quality and distinguishes an unverified result from a confirmed empty calendar.

Key features

  1. 01Fetches macro release events
  2. 02Filters by currency and tier
  3. 03Checks source and timestamp quality
  4. 04Treats errors as unverified risk
  5. 05Adds event timing to trade plans

Use cases

  1. 01Check upcoming USD releases before trading
  2. 02Pause entries around high-impact events
  3. 03Adjust leverage or position size
  4. 04Schedule review after an actual release

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/tradermonty/claude-trading-skills --skill fxmacrodata-calendar

After installing, type/fxmacrodata-calendarin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

requirements.txt
scripts/
fetch_calendar.py
scripts/tests/
test_fetch_calendar.py

Details

From the project README

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:

    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.

Authentication

Set FXMACRODATA_API_KEY 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 market_tier; 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.

Comments

Markdown supported