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

# How to Use Forex Factory economic calendar in Muse 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 Muse 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 Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse 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: Muse Code finds Forex Factory economic calendar on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-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 Muse 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 Muse Code guides](https://spiral.ai/integrations/muse-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)
- [Claude Code](https://spiral.ai/integrations/claude-code/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)
- [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 Muse Code guides

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

## Questions about Forex Factory economic calendar in Muse Code

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

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

**How much does Forex Factory economic calendar cost in Muse 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 Muse Code plan is separate.

**Do I need an Alexandria account to use Forex Factory economic calendar in Muse 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 Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

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

Forex Factory economic calendar runs in the background. Muse 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.

