Fetch upcoming economic events and data releases using FMP API. Retrieve scheduled central bank decisions, employment reports, inflation data, GDP releases, and other market-moving economic indicators for specified date ranges (default: next 7 days). The script outputs raw JSON or text; the assistant filters, assesses impact, and generates the Markdown report.
Permissions
Files
SKILL.md
economic-calendar-fetcher
Fetch upcoming economic events and data releases using FMP API. Retrieve scheduled central bank decisions, employment reports, inflation data, GDP releases, and other market-moving economic indicators for specified date ranges (default: next 7 days). The script outputs raw JSON or text; the assistant filters, assesses impact, and generates the Markdown report.
Economic Calendar Fetcher
Overview
Retrieve upcoming economic events and data releases from the Financial Modeling Prep (FMP) Economic Calendar API. This skill fetches scheduled economic indicators including central bank monetary policy decisions, employment reports, inflation data (CPI/PPI), GDP releases, retail sales, manufacturing data, and other market-moving events that impact financial markets.
The skill uses a Python script to query the FMP API and returns raw JSON or text output. The assistant then filters events, assesses market impact, and generates a chronological Markdown report for each scheduled event. No files are generated automatically.
User: "Show me economic events for next week"
Assistant: "I'll fetch the economic calendar. I'll use the FMP_API_KEY environment variable if it's set. Otherwise, please pass the key via --api-key when running the script."
Step 2: Determine Date Range
Set appropriate date range based on user request:
Default (no specific dates): Today + 7 days
User specifies period: Use exact dates (validate format: YYYY-MM-DD)
Maximum range: 90 days (FMP API limitation)
Examples:
"Next week" → Today to +7 days
"Next two weeks" → Today to +14 days
"January 2025" → 2025-01-01 to 2025-01-31
"Q1 2025" → 2025-01-01 to 2025-03-31
Validate date range:
Ensure start date ≤ end date
Ensure range ≤ 90 days
Warn if querying past dates
Step 3: Execute API Fetch Script
Run the get_economic_calendar.py script with appropriate parameters:
Network errors → Check your connection and re-run the script
Invalid date format → Provide correct format example
Step 4: Parse and Filter Events
Process the JSON response from the script:
Parse event data: Extract all events from API response
Apply user filters if specified:
Impact level: "High", "Medium", "Low"
Country: "US", "EU", "JP", "CN", etc.
Event type: FOMC, CPI, Employment, GDP, etc.
Currency: USD, EUR, JPY, etc.
Filter examples:
"Show only high-impact events" → Filter impact == "High"
"US events only" → Filter country == "US"
"Central bank decisions" → Search event name for "Rate", "Policy", "FOMC", "ECB", "BOJ"
Event data structure:
{"date":"2025-01-15 14:30:00","country":"US","event":"Consumer Price Index (CPI) YoY","currency":"USD","previous":2.6,"estimate":2.7,"actual":null,"change":null,"impact":"High","changePercentage":null}
Step 5: Assess Market Impact
Evaluate the market significance of each event:
Impact Level Classification (from FMP):
High Impact: Major market-moving events
FOMC rate decisions, ECB/BOJ policy meetings
Non-Farm Payrolls (NFP), CPI, GDP
Market typically shows 0.5-2%+ intraday volatility
Medium Impact: Significant but less volatile
Retail Sales, Industrial Production
PMI surveys, Consumer Confidence
Housing data, Durable Goods Orders
Low Impact: Minor indicators
Weekly jobless claims (unless extreme)
Regional manufacturing surveys
Minor auction results
Additional Context Factors:
Current Market Sensitivity:
High inflation environment → CPI/PPI elevated importance
Recession fears → Employment data more critical
Rate cut speculation → Central bank meetings crucial
Surprise Potential:
Compare estimate vs. previous reading
Large expected changes = higher attention
Consensus uncertainty = higher impact potential
Event Clustering:
Multiple related events same day = amplified impact
Example: CPI + Retail Sales + Fed speech = Very High impact day
Forward Significance:
Does this event influence upcoming central bank decisions?
Is this a preliminary or final reading?
Will this data be revised?
Step 6: Generate Output Report
Responsibility: The script outputs raw JSON or text. This step is performed by the assistant using the script's output. No Markdown files are generated automatically; results are displayed in chat and can be saved to reports/ on request.
Create structured markdown report with the following sections:
## [Date] - [Day of Week]### [Event Name] ([Impact Level])-**Country:** [Country Code] ([Currency])
-**Time:** [HH:MM UTC]
-**Previous:** [Value]
-**Estimate:** [Consensus Forecast]
-**Impact Assessment:** [Your analysis]
**Market Implications:**
[2-3 sentences on why this matters, what markets watch for, typical reaction patterns]
---
Example Event Entry:
## 2025-01-15 - Wednesday### Consumer Price Index (CPI) YoY (High Impact)-**Country:** US (USD)
-**Time:** 14:30 UTC (8:30 AM ET — converted by assistant based on US DST calendar)
-**Previous:** 2.6%
-**Estimate:** 2.7%
-**Impact Assessment:** Very High - Core inflation metric for Fed policy decisions
**Market Implications:**
CPI reading above estimate (>2.7%) likely strengthens hawkish Fed expectations, potentially pressuring equities and supporting USD. Reading at or below 2.7% could reinforce disinflation narrative and support risk assets. Options market pricing 1.2% S&P 500 move on release day.
---
Summary Section:
Add analytical summary at the end:
## Key Takeaways**Highest Impact Days:**- [Date]: [Events] - [Combined impact rationale]
- [Date]: [Events] - [Combined impact rationale]
**Central Bank Activity:**- [Summary of any scheduled Fed/ECB/BOJ meetings or speeches]
**Major Data Releases:**- Employment: [NFP, Unemployment Rate dates]
- Inflation: [CPI, PPI dates]
- Growth: [GDP, Retail Sales dates]
**Market Positioning Considerations:**
[2-3 bullets on how traders might position around these events]
**Risk Events:**
[Highlight any particularly high-uncertainty or surprise-potential events]
Filtering Notes:
If user requested specific filters, note at top:
**Filters Applied:**- Impact Level: High only
- Country: US
- Events shown: [X] of [Y] total events in date range
Output:
Results are displayed in chat. No files are generated automatically.
To save raw JSON/text data: use --output reports/economic_calendar_[START]_to_[END].json when running the script.
To save the Markdown report: ask the assistant to write it to reports/ after generating it in chat.
Assistant-Generated Report Format
Markdown structure requirements:
Chronological ordering: Events sorted by date and time (earliest first)
