Skip to content
SkillScript-led454 tokens in use

FXMacroData Calendar

Fetches official macro release-calendar events from FXMacroData, filtered by currency and importance tier, for event-risk checks in trade plans.

7,427 stars on the repository MIT Licensetradermonty/claude-trading-skills · skills/fxmacrodata-calendar

Skill label

measured from its files

What installing FXMacroData Calendar costs

52tokens idle
454tokens in use
468tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Script-led

Script-ledMixedModel-led

Most of this skill is scripts, so it behaves much the same whichever model runs it.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/fetch_calendar.py.

Touches

shelldetectednetworkdetectedcredentialsdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter8/15
  • Structure22/25
  • Examples6/15
  • Output5/15
  • Size15/15
  • Resources7/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Good
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 24
  • Reaches the network−10

    does this on the machine, and the frontmatter does not say so

    scripts/fetch_calendar.py, line 7
  • Reads credentials−15

    does this on the machine, and the frontmatter does not say so

    scripts/fetch_calendar.py, line 195

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity100
  • Maintenance52
  • Community68
  • Maturity36
  • Momentum40

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.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers