[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Forex Factory economic calendar](https://spiral.ai/integrations/claude-code/forex-factory-economic-calendar)

# How to Use Forex Factory economic calendar in Claude Code

Returns scheduled economic events with currencies, expected impact, release times, and available actual, forecast, and previous figures. Use it to plan around upcoming announcements or review a past date window.

|  |  |
| --- | --- |
| Model | Forex Factory economic calendar |
| Available through | Alexandria |
| Category | Finance |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Forex Factory economic calendar in Claude Code

- Use Forex Factory economic calendar to populate this project's calendar view with high-impact US dollar and euro events for November 23 through November 27, 2026, showing UTC times and available figures.
- Use Forex Factory economic calendar to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Forex Factory economic calendar and tell me what changed since last week.
- Check Forex Factory economic calendar and summarize what you find in three bullet points.
- Pull the newest data from Forex Factory economic calendar and give me the result as a table.

## How to set up Forex Factory economic calendar in Claude Code

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Forex Factory economic calendar**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "forexfactory-com/economic-calendar/list_events",
    "input": {
      "end": "<end>"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Forex Factory economic calendar on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## Forex Factory economic calendar tools and prices

- [Forex Factory economic calendar · List events](https://spiral.ai/tools/alexandria/forexfactory-com/economic-calendar/list_events) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| end |  | — | Custom range end, YYYY-MM-DD (requires `start`). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| date |  | — | Anchor date, YYYY-MM-DD. Defaults to today (UTC). Mutually exclusive with `start`/`end`. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| view | day, week, month | week | Window around `date`: the day itself, the Sunday-to-Saturday week containing it, or its calendar month. Ignored when `start`/`end` are given. |
| start |  | — | Custom range start, YYYY-MM-DD (requires `end`; at most 62 days inclusive). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| impacts |  | — | Keep only these impact levels (`holiday` is the site's Non-Economic grey level). Default: all. |
| currencies |  | — | Keep only events of these currencies (the nine the site filters on). Default: all. |

## What can you do with Forex Factory economic calendar in Claude Code?

Build a macro research view that puts Forex Factory release dates beside indicator definitions and historical forecast differences. A coding agent can turn the returned records into calendar views, reference tables, and charts in your project.

### Prepare an inflation review

Find US CPI and Core PCE indicators, identify their scheduled releases, read their measurement notes, inspect earlier announcements, and chart actual readings against forecasts.

### Build a payroll release briefing

Locate US Non-Farm Employment Change, check its release date, explain its definition, review previous announcements and revisions, and calculate historical forecast differences.

### Research central bank decisions

Identify Bank of England and Bank of Canada rate indicators, check upcoming decision dates, read their specifications, inspect past decisions, and plot reported rates against forecasts.

### Compare growth announcements

Find US and UK GDP indicators, identify the release editions on the calendar, check measurement definitions, inspect earlier releases, and chart each series separately.

### Prepare a foreign currency payment briefing

List economic announcements before a EUR/USD payment deadline, explain the relevant indicators, and review how their recent actual readings compared with forecasts.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## Forex Factory economic calendar in other agents

- [Amp](https://spiral.ai/integrations/amp/forex-factory-economic-calendar)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/forex-factory-economic-calendar)
- [Claude](https://spiral.ai/integrations/claude-desktop/forex-factory-economic-calendar)
- [Cline](https://spiral.ai/integrations/cline/forex-factory-economic-calendar)
- [Codex](https://spiral.ai/integrations/codex/forex-factory-economic-calendar)
- [Cursor](https://spiral.ai/integrations/cursor/forex-factory-economic-calendar)
- [Devin](https://spiral.ai/integrations/devin/forex-factory-economic-calendar)
- [dots](https://spiral.ai/integrations/dots/forex-factory-economic-calendar)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/forex-factory-economic-calendar)
- [Gemini](https://spiral.ai/integrations/gemini/forex-factory-economic-calendar)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/forex-factory-economic-calendar)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/forex-factory-economic-calendar)
- [goose](https://spiral.ai/integrations/goose/forex-factory-economic-calendar)
- [Grok](https://spiral.ai/integrations/grok/forex-factory-economic-calendar)
- [Grok Build](https://spiral.ai/integrations/grok-build/forex-factory-economic-calendar)
- [Hermes](https://spiral.ai/integrations/hermes/forex-factory-economic-calendar)
- [Instinct](https://spiral.ai/integrations/instinct/forex-factory-economic-calendar)
- [Manus](https://spiral.ai/integrations/manus/forex-factory-economic-calendar)
- [Muse](https://spiral.ai/integrations/muse/forex-factory-economic-calendar)
- [Muse Code](https://spiral.ai/integrations/muse-code/forex-factory-economic-calendar)
- [n8n](https://spiral.ai/integrations/n8n/forex-factory-economic-calendar)
- [Notion](https://spiral.ai/integrations/notion/forex-factory-economic-calendar)
- [OpenClaw](https://spiral.ai/integrations/openclaw/forex-factory-economic-calendar)
- [opencode](https://spiral.ai/integrations/opencode/forex-factory-economic-calendar)
- [Perplexity](https://spiral.ai/integrations/perplexity/forex-factory-economic-calendar)
- [Raycast](https://spiral.ai/integrations/raycast/forex-factory-economic-calendar)
- [VS Code](https://spiral.ai/integrations/vscode/forex-factory-economic-calendar)
- [Windsurf](https://spiral.ai/integrations/windsurf/forex-factory-economic-calendar)
- [Zapier](https://spiral.ai/integrations/zapier/forex-factory-economic-calendar)

## More Claude Code guides

- [Fiscal.ai template metric definitions](https://spiral.ai/integrations/claude-code/fiscal-ai-template-metric-definitions)
- [Forex Factory event details](https://spiral.ai/integrations/claude-code/forex-factory-event-details)
- [Fiscal.ai stock split history](https://spiral.ai/integrations/claude-code/fiscal-ai-stock-split-history)
- [Forex Factory indicator chart data](https://spiral.ai/integrations/claude-code/forex-factory-indicator-chart-data)
- [Fiscal.ai standardized metric catalog](https://spiral.ai/integrations/claude-code/fiscal-ai-standardized-metric-catalog)
- [Forex Factory indicator search](https://spiral.ai/integrations/claude-code/forex-factory-indicator-search)

## Questions about Forex Factory economic calendar in Claude Code

**Can Claude Code use Forex Factory economic calendar?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Forex Factory economic calendar like any built-in tool.

**How much does Forex Factory economic calendar cost in Claude Code?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

**Do I need an Alexandria account to use Forex Factory economic calendar in Claude Code?**

No. Spiral runs Forex Factory economic calendar on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Forex Factory economic calendar in Claude Code?**

About two minutes: add the hosted server, then sign in.

**Does Claude Code wait while Forex Factory economic calendar runs?**

Forex Factory economic calendar runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

**What part of Forex Factory does this data cover?**

It covers the public economic calendar: scheduled releases, indicator descriptions, and historical readings. The documented scope is public, read-only economic data.

**How quickly does Forex Factory publish new readings?**

Forex Factory says its website calendar displays economic data as it becomes available, without a page refresh. That statement concerns the website and does not establish a separate delivery-time guarantee for these endpoints.

**Can a historical reading change?**

Yes. Forex Factory explicitly displays revisions, marking revised readings with a yellow triangle and exposing the previous value on hover.

**Does the first history response contain every release?**

The first expansion contains about 15 recent releases. Further expansions return a longer prefix, and the response indicates whether more history remains.

**Does public access allow me to republish the calendar?**

Forex Factory's notices expressly prohibit copying, republication, or redistribution of its FEED calendar compilation, including partial copies. Public availability does not provide blanket permission to republish it.

