economic-calendar-fetcher

---
name: economic-calendar-fetcher
description: Use when the user asks about upcoming economic events, central bank decisions, employment, inflation, or GDP releases, or wants a market-moving events calendar for a date range.
category: Market & Macro
version: 1.0.0
tools: []
---

# Economic Calendar Fetcher

## Overview

Retrieve upcoming economic events and data releases — central bank monetary policy decisions, employment reports, inflation data (CPI/PPI), GDP releases, retail sales, manufacturing data, and other market-moving indicators — for a specified date range (default: next 7 days). Filter events, assess market impact, and present a chronological markdown report in chat.

**Key capabilities**: retrieve economic events for a date range (max 90 days); filter by impact level, country, or event type; present filtered results as a structured markdown report with impact analysis; default to the next 7 days for a quick market outlook.

**Data source**: the Financial Modeling Prep (FMP) Economic Calendar, covering major economies (US, EU, UK, Japan, China, Canada, Australia) and event types (central bank decisions, employment, inflation, GDP, trade, housing, surveys). Use web_search to query FMP's stable economic-calendar endpoint (`financialmodelingprep.com/stable/economic-calendar`) for the requested date range. The legacy `api/v3/economic_calendar` endpoint (plural "economics-calendar" is also a dead URL) was fully retired by FMP on 2025-08-31 and now errors — never use it, including as a fallback.

## When to Use

Use this skill when the user requests:

1. **Economic calendar queries** — "What economic events are coming up this week?", "Show me the calendar for the next two weeks", "When is the next FOMC meeting?", "What major economic data is being released next month?"
2. **Market event planning** — "What should I watch for in the markets this week?", "Are there any high-impact releases coming?", "When is the next jobs report / CPI release / GDP report?"
3. **Specific date ranges** — "Get economic events from January 1 to January 31", "What's on the calendar for Q1?"
4. **Country-specific queries** — "Show me US data releases next week", "What ECB events are scheduled?", "When is Japan releasing inflation data?"

Do not use this skill for past economic events, corporate earnings calendars (this excludes earnings), real-time market quotes, or chart-based technical analysis.

## Workflow

### Step 1: Determine the Date Range

- Default (no specific dates): today + 7 days.
- User specifies a period: use exact dates (validate YYYY-MM-DD format).
- 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: start date ≤ end date, range ≤ 90 days, and warn if querying past dates.

### Step 2: Retrieve Calendar Data

Use web_search to query the FMP stable economic-calendar endpoint for the requested date range. Handle responses carefully:

- A restricted/paid-tier response should be surfaced to the user as "this endpoint requires a higher FMP subscription tier" — do not treat it as "zero events."
- An empty result for a plausible current/future range is a genuine "no events" response; re-verify the date range only if you have another reason to suspect missing data.
- Responses can include rows just outside the requested window — after fetching, filter events locally by parsed date so only the requested range is reported.
- Rate limits apply on the free tier (250 requests/day, 5 requests/second); if hit, tell the user rather than fabricating results.

**Event fields**: date, country, event name, currency, previous, estimate, actual, impact (High/Medium/Low).

### Step 3: Parse and Filter Events

Apply any user-specified filters:
- Impact level: High, Medium, Low
- Country: US, EU, JP, CN, etc.
- Event type: FOMC, CPI, Employment, GDP, etc. — search the event name for "Rate," "Policy," "FOMC," "ECB," "BOJ" for central bank decisions
- Currency: USD, EUR, JPY, etc.

### Step 4: Assess Market Impact

**Impact level classification**:
- **High**: major market-moving events — FOMC rate decisions, ECB/BOJ policy meetings, Non-Farm Payrolls (NFP), Consumer Price Index (CPI), GDP. Markets typically show 0.5-2%+ intraday volatility.
- **Medium**: significant but less volatile — Retail Sales, Industrial Production, PMI surveys, Consumer Confidence, housing data, Durable Goods Orders.
- **Low**: minor indicators — weekly jobless claims (unless extreme), regional manufacturing surveys, minor auction results.

**Additional context factors**:
1. Current market sensitivity — high inflation raises CPI/PPI importance; recession fears raise employment-data importance; rate-cut speculation raises central-bank-meeting importance.
2. Surprise potential — compare estimate vs. previous reading; large expected changes or high consensus uncertainty mean higher attention.
3. Event clustering — multiple related events on the same day amplify impact (e.g., CPI + Retail Sales + Fed speech = very high-impact day).
4. Forward significance — does this event influence upcoming central bank decisions? Is it preliminary or final? Will it be revised?

### Step 5: Generate the Report

Present results in chat as a chronological markdown report (no files are generated automatically; offer to save to the Knowledge Base on request):

**Header**: period, report-generated timestamp, total events, high-impact event count. If filters were applied, note them and how many of the total events are shown.

**Per-event entry** (chronological, earliest first):
```
## [Date] - [Day of Week]

### [Event Name] ([Impact Level])
- Country: [Country Code] ([Currency])
- Time: [HH:MM UTC]
- Previous: [Value]
- Estimate: [Consensus Forecast]
- Impact Assessment: [analysis]

Market Implications: [2-3 sentences on why this matters, what markets watch for, typical reaction patterns]
```

Example:
```
## 2025-01-15 - Wednesday

### Consumer Price Index (CPI) YoY (High Impact)
- Country: US (USD)
- Time: 14:30 UTC (8:30 AM ET)
- Previous: 2.6%
- Estimate: 2.7%
- Impact Assessment: Very High - core inflation metric for Fed policy decisions

Market Implications: A reading above estimate (>2.7%) likely strengthens hawkish Fed expectations, pressuring equities and supporting USD. A reading at or below estimate could reinforce the disinflation narrative and support risk assets.
```

For dense listings, an optional table format works too: `| Date/Time (UTC) | Event | Country | Impact | Previous | Estimate | Assessment |`.

**Key Takeaways summary** at the end:
- Highest-impact days and why (combined-event rationale)
- Central bank activity (scheduled Fed/ECB/BOJ meetings or speeches)
- Major data releases grouped by category: Employment (NFP, Unemployment Rate), Inflation (CPI, PPI), Growth (GDP, Retail Sales)
- Market positioning considerations (2-3 bullets on how traders might position)
- Risk events — particularly high-uncertainty or surprise-potential releases

## Report Format Requirements

- Chronological ordering by date and time (earliest first).
- Impact labels on every event: (High Impact), (Medium Impact), (Low Impact).
- Always specify UTC; convert to ET/PT only when useful, accounting for US DST.
- Include all available fields; use "N/A" or "No estimate" for nulls.
- Every high- or medium-impact event needs a market-implications write-up.
- All output in English.