economic-calendar-fetcher

Fetch economic events from the FMP Economic Calendar API with configurable filters.

2.6k|600|Updated Oct 19, 2025
One-click install
npx skills add https://github.com/tradermonty/claude-trading-skills --skill economic-calendar-fetcher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: economic-calendar-fetcher
Source: https://github.com/tradermonty/claude-trading-skills/tree/main/skills/economic-calendar-fetcher
Command: npx skills add https://github.com/tradermonty/claude-trading-skills --skill economic-calendar-fetcher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves the manual burden of tracking and summarizing scheduled economic events from the FMP Economic Calendar, enabling traders and researchers to plan around data releases with clear, report-ready outputs.

Core Features & Use Cases

  • Fetch events for specified date ranges (default: next 7 days; maximum 90 days)
  • API key provisioning via environment variable or user input
  • Filter results by impact level, country, or event type
  • Generate structured Markdown reports (or JSON) for notes, briefs, and sharing
  • Includes past events with actual values and future estimates for analysis

Quick Start

  • Set your FMP API key:
    • export FMP_API_KEY=your_api_key
  • Run the fetch script for a date range (example):
    • python3 scripts/get_economic_calendar.py --from 2025-01-01 --to 2025-01-07 --format json --output calendar.json
  • If you omit --api-key, the script will use the FMP_API_KEY environment variable automatically
  • You can also specify shorter ranges (1-7 days) for near-term monitoring

Frequently Asked Questions about economic-calendar-fetcher

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

FAQPage Schema
How do I fetch economic calendar events from FMP for a specific date range?

You can fetch economic calendar events by running the Python script with start and end date arguments. The script supports configurable date ranges up to 90 days and outputs structured Markdown or JSON reports for trading analysis.

What is the default date range when fetching economic events from the FMP API?

The default date range for fetching economic events is the next 7 days. You can specify custom date ranges up to a maximum of 90 days to monitor upcoming data releases and past events with actual values.

Can I filter economic calendar results by impact level, country, or event type?

Yes, the FMP economic calendar fetcher includes post-processing filters. You can filter results by impact level, country, or event type to isolate specific market-moving data releases for your trading and research workflows.

Do I need an FMP API key to retrieve economic data releases, and how do I configure it?

Yes, an FMP API key is required to retrieve economic data releases. You can provision it by setting the FMP_API_KEY environment variable or by passing the key directly via the command line using the --api-key argument.

What is the maximum date range allowed when pulling economic calendar data from FMP?

The maximum allowed date range for pulling economic calendar data is 90 days. For near-term monitoring, you can specify shorter ranges between 1 and 7 days to track upcoming scheduled economic events.

Why does my FMP economic calendar API call fail or return empty results?

FMP economic calendar API calls may fail due to missing or invalid API keys, or incorrectly formatted date ranges. The script validates date ranges and provides retry guidance for common errors during the API request process.