---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/economic-calendar
---
# Economic Calendar

Financial calendar covering earnings reports, IPO pipeline, global economic events, exchange holidays (NYSE, CME, LSE, TSE), options expiry, central bank meetings (FOMC, ECB, BOE), and data release schedules (NFP, CPI, PPI, GDP, ISM).

- **Version:** 0.03
- **Categories:** finance

## Skills (9)

### Market Holidays (`market_holidays`)

Returns stock exchange holidays for a given year. Covers NYSE, CME, LSE (London), and TSE (Tokyo). US holidays include major federal holidays. LSE follows UK bank holidays. TSE follows Japanese national holidays. Handles weekend observance rules.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `year` | number | No | Year to get holidays for (e.g. 2026). Defaults to current year. |
| `exchange` | string | No | Exchange to get holidays for. "nyse" (default), "cme", "lse" (London), "tse" (Tokyo), or "all". (nyse, cme, lse, tse, all) |

**Returns:** Array of holidays with date, name, day of week, exchange, and whether the date is an observed holiday (shifted from weekend).

**Examples:**

*Get NYSE holidays for 2026:*

```json
{
  "year": 2026
}
```

*Get all exchange holidays for current year:*

```json
{
  "exchange": "all"
}
```

*Get London Stock Exchange holidays:*

```json
{
  "exchange": "lse"
}
```

*Get Tokyo Stock Exchange holidays:*

```json
{
  "exchange": "tse"
}
```

### Options Expiry (`options_expiry`)

Calculates options expiration dates for U.S. equity options. Supports monthly (3rd Friday), weekly (every Friday), and quarterly (3rd Friday of Mar/Jun/Sep/Dec) expiration types. Filter by month or get the full year.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `year` | number | No | Year to calculate expirations for. Defaults to current year. |
| `month` | number | No | Month (1-12) to filter results. Omit for all months. |
| `type` | string | No | Expiration type: "monthly" (default), "weekly", "quarterly", or "all". (monthly, weekly, quarterly, all) |

**Returns:** Array of expiration dates with type (monthly/weekly/quarterly), day of week, and notes on settlement rules.

**Examples:**

*Get monthly options expiry dates for 2026:*

```json
{
  "year": 2026
}
```

*Get all expiry types for March 2026:*

```json
{
  "year": 2026,
  "month": 3,
  "type": "all"
}
```

*Get quarterly expiry dates:*

```json
{
  "type": "quarterly"
}
```

### FOMC Meetings (`fomc_meetings`)

Returns the Federal Reserve FOMC meeting schedule for a given year. Includes confirmed dates for 2024-2026 and estimated dates for other years. Shows which meetings include the Summary of Economic Projections (SEP/dot plot) and statement release timing.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `year` | number | No | Year to get FOMC schedule for. Defaults to current year. |

**Returns:** Array of FOMC meetings with start/end dates, statement release date, whether SEP/dot plot is included, and whether dates are confirmed or estimated.

**Examples:**

*Get 2026 FOMC meeting schedule:*

```json
{
  "year": 2026
}
```

*Get current year FOMC schedule:*

```json
{}
```

### Data Releases (`data_releases`)

Generates the schedule for major U.S. economic data releases including NFP (employment), CPI/PPI/PCE (inflation), GDP, ISM Manufacturing and Services, Retail Sales, Housing Starts, and Initial Claims. Filter by month and category.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `year` | number | No | Year for the release schedule. Defaults to current year. |
| `month` | number | No | Month (1-12) to filter results. Omit for all months. |
| `category` | string | No | Filter by category: "employment", "inflation", "gdp", "housing", "manufacturing", "consumer", or "all" (default). (employment, inflation, gdp, housing, manufacturing, consumer, all) |

**Returns:** Array of economic data releases with date, indicator name, category, description, and release frequency pattern.

**Examples:**

*Get all economic releases for March 2026:*

```json
{
  "year": 2026,
  "month": 3
}
```

*Get inflation data release dates:*

```json
{
  "category": "inflation"
}
```

*Get employment releases for current month:*

```json
{
  "category": "employment"
}
```

### ECB Meetings (`ecb_meetings`)

Returns the ECB Governing Council monetary policy meeting schedule for a given year. Includes confirmed dates for 2025-2026 and estimated dates for other years. All meetings include a press conference. Rate decisions announced at 14:15 CET.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `year` | number | No | Year to get ECB schedule for. Defaults to current year. |

**Returns:** Array of ECB Governing Council monetary policy meetings with dates, press conference timing, and whether dates are confirmed or estimated.

**Examples:**

*Get 2026 ECB meeting schedule:*

```json
{
  "year": 2026
}
```

*Get current year ECB schedule:*

```json
{}
```

### BOE MPC Meetings (`boe_meetings`)

Returns the Bank of England Monetary Policy Committee (MPC) meeting schedule for a given year. Includes confirmed dates for 2025-2026 and estimated dates for other years. Shows which meetings coincide with the Monetary Policy Report (Feb, May, Aug, Nov). Rate decisions announced at 12:00 GMT.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `year` | number | No | Year to get BOE MPC schedule for. Defaults to current year. |

**Returns:** Array of Bank of England MPC meetings with dates, Monetary Policy Report flag, and whether dates are confirmed or estimated.

**Examples:**

*Get 2026 BOE MPC meeting schedule:*

```json
{
  "year": 2026
}
```

*Get current year BOE schedule:*

```json
{}
```

### Earnings Calendar (`earnings_calendar`)

Corporate earnings reporting schedule from Nasdaq. Shows which companies report on a given date with EPS forecasts, market cap, number of analyst estimates, and reporting time (pre-market or after-hours). Supports multi-day views up to 7 days.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `date` | string | No | Date in YYYY-MM-DD format. Defaults to today. |
| `days` | number | No | Number of days to fetch (1-7). Defaults to 1. |

**Returns:** Array of earnings reports with symbol, company name, market cap, EPS forecast, number of estimates, reporting time, and prior year comparison.

**Examples:**

*Get today's earnings calendar:*

```json
{}
```

*Get earnings for a specific date:*

```json
{
  "date": "2026-03-24"
}
```

*Get earnings for the next 5 days:*

```json
{
  "days": 5
}
```

### IPO Calendar (`ipo_calendar`)

IPO pipeline from Nasdaq covering upcoming, priced, filed, and withdrawn initial public offerings. View the full IPO calendar for any month with share prices, exchange listings, and deal values.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `month` | string | No | Month in YYYY-MM format. Defaults to current month. |
| `section` | string | No | IPO section to view: "upcoming" (default), "priced", "filed", "withdrawn", or "all". (upcoming, priced, filed, withdrawn, all) |

**Returns:** Array of IPOs with ticker, company, exchange, share price range, shares offered, dollar value, date, and deal status.

**Examples:**

*Get upcoming IPOs this month:*

```json
{}
```

*Get all IPO activity for a specific month:*

```json
{
  "month": "2026-04",
  "section": "all"
}
```

*Get recently priced IPOs:*

```json
{
  "section": "priced"
}
```

### Economic Events (`economic_events`)

Global economic event calendar for the current week from ForexFactory. Covers major market-moving events like Non-Farm Payrolls, CPI, rate decisions, GDP, and more across all major economies (US, Euro Area, UK, Japan, Australia, Canada, etc.). Filter by impact level or country.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `impact` | string | No | Filter by impact level: "high" (market-movers only), "medium", "low", or "all" (default). (high, medium, low, all) |
| `country` | string | No | Filter by currency code: USD, EUR, GBP, JPY, AUD, NZD, CAD, CHF, CNY. |

**Returns:** Array of economic events with title, country, currency, date, time, impact level, forecast, and previous values. Includes impact breakdown summary.

**Examples:**

*Get all economic events this week:*

```json
{}
```

*Get only high-impact events:*

```json
{
  "impact": "high"
}
```

*Get US economic events:*

```json
{
  "country": "USD"
}
```

*Get high-impact Euro Area events:*

```json
{
  "impact": "high",
  "country": "EUR"
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call economic-calendar market_holidays --year 2026

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"economic-calendar","skill":"market_holidays","input":{"year":2026}}' \
     https://api.toolrouter.com/v1/tools/call
```

## Frequently Asked Questions

### Can I see earnings for a specific date or the next few days?

`earnings_calendar` shows companies reporting on a given date and supports multi-day views up to 7 days, with EPS forecasts and reporting time.

### Does it cover IPOs and central bank meetings?

Yes. `ipo_calendar` tracks upcoming, priced, filed, and withdrawn IPOs, while `fomc_meetings`, `ecb_meetings`, and `boe_meetings` cover the major central bank schedules.

### Can I check exchange holidays and options expiry dates?

`market_holidays` covers NYSE, CME, LSE, and TSE holidays, and `options_expiry` returns monthly, weekly, or quarterly U.S. equity options expiry dates.

### Is this just for the US market?

No. `economic_events` is a global weekly calendar, while `data_releases` focuses on major U.S. releases like NFP, CPI, PPI, GDP, ISM, and retail sales.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs