fxmacrodata-calendar

Q: How do I install fxmacrodata-calendar?

Run npx skills add https://github.com/tradermonty/claude-trading-skills --skill fxmacrodata-calendar in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/fxmacrodata-calendar/ (personal) or .claude/skills/fxmacrodata-calendar/ (project).

by tradermontyProductivity & Automation

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.

Installs: 2.5K
Last 24h: +21
Trending rank: #5747
Security: Not audited

Install

Works with every agent the skills CLI supports.

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

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads fxmacrodata-calendar automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

Run the calendar script:

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

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.
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.

FAQ

What does the fxmacrodata-calendar skill do?

How do I install fxmacrodata-calendar?

Run npx skills add https://github.com/tradermonty/claude-trading-skills --skill fxmacrodata-calendar in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/fxmacrodata-calendar/ (personal) or .claude/skills/fxmacrodata-calendar/ (project).

Which AI agents can use fxmacrodata-calendar?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is fxmacrodata-calendar safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains fxmacrodata-calendar?

It is published by tradermonty in tradermonty/claude-trading-skills. It has 2,492 recorded installs.