fxmacrodata-calendar

Name: fxmacrodata-calendar
Availability: InStock
Author: tradermonty

Fetch official macro release-calendar events from the FXMacroData API for trade planning.

2.8k|632|Updated Oct 19, 2025

Search Tags:#api #Python #trade planning #event risk #economic events #fxmacrodata #macro calendar

Ready to run

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

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: fxmacrodata-calendar
Source: https://github.com/tradermonty/claude-trading-skills/tree/main/skills/fxmacrodata-calendar
Command: npx skills add https://github.com/tradermonty/claude-trading-skills --skill fxmacrodata-calendar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Traders risk entering positions right before high-impact macro releases like CPI, NFP, or central-bank decisions. This Skill retrieves verified, official-source macro release-calendar events so trade plans account for event timing and event risk.

Core Features & Use Cases

Official Calendar Retrieval: Queries the FXMacroData API for macro release events filtered by currency and market tier (1-3).
Strict Data-Quality Validation: Rejects responses that are stale, proxy-based, fallback, or missing announcement timestamps, treating failures as unverified event-risk states rather than empty calendars.
Use Case: Before opening a swing trade on Monday, run the calendar check for USD tier-1 events, then pause new entries around an upcoming FOMC decision and reduce position size accordingly.

Quick Start

Ask the assistant to check the FXMacroData calendar for upcoming top-tier USD macro releases before planning this week's trades.

Frequently Asked Questions about fxmacrodata-calendar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I check upcoming macro economic events before trading?▼

Run the fetch_calendar.py script with a currency code and minimum tier, for example --currency usd --min-tier 1, to retrieve top-tier releases like CPI and NFP. Fold the returned event timestamps into your trade plan by pausing entries around high-impact releases.

What is the FXMacroData calendar API used for?▼

The FXMacroData calendar API provides official-source macro release schedules with announcement timestamps and market tiers. Traders use it for macro regime checks, event-risk filters, and scheduling reviews after actual values are published.

Do I need an API key for the FXMacroData calendar?▼

Public USD calendar rows can be fetched without a key. For authenticated endpoints, set the FXMACRODATA_API_KEY environment variable, which the script appends as an api_key query parameter.

Why does the calendar script fail with a data_quality error?▼

The script rejects responses where data_quality flags indicate proxy, fallback, stale, or non-official sources, or missing announcement timestamps. A nonzero exit means the event-risk state is unverified, not that the calendar is empty.

What market tier values does the FXMacroData calendar support?▼

The --min-tier argument accepts only integers 1, 2, or 3, where 1 represents the highest-impact releases. Each event must include a valid integer market_tier in this range or the response is rejected.