skills.rest
tradermonty
tradermontyCOMMUNITY
Explore all skills by this author →
GitHub

fxmacrodata-calendar

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
One-click install
npx skills add https://github.com/tradermonty/claude-trading-skills --skill fxmacrodata-calendar
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Finance & Accounting Skills→
darkounus90darkounus90
1

uptrend-analyzer

Analyze market breadth and uptrend ratios from Monty's Uptrend Ratio Dashboard data.

Community
Advanced
datagridSolutiondatagridSolution

DCA Bot Skill

Automates dollar-cost averaging trading with configurable safety orders and exit rules.

Official
Intermediate
openaiopenai
488

portfolio-risk-management

Compute risk-aware position sizing and hedge design for public-equity portfolios.

Official
Advanced
k1064190k1064190
2

economic-calendar-fetcher

Retrieve economic events and data releases from the FMP Economic Calendar API.

Community
Intermediate