# Macro Calendar (`catalysts_economic_calendar`)

> CPI, FOMC, jobs and GDP — the macro releases that move crypto anyway — from two days back to a week ahead, filtered by importance.

- Category: Events & catalysts
- MCP tool: `catalysts_economic_calendar`
- REST: `GET /catalysts/economic-calendar`
- x402 price: $0.01 per call (USDC on Base)
- HTML: https://www.f1ow.com/docs/tools/catalysts_economic_calendar

## What it does

Scheduled macroeconomic data releases (CPI, FOMC, jobs, GDP, etc.) from the last ~2 days through the next 7 days. Optionally set 'min_importance' (1-3, default 2) to filter out low-impact releases.

## Parameters

| Name | Type | In | Required | Description |
| --- | --- | --- | --- | --- |
| `min_importance` | integer | query | no | Minimum importance level to include: 1 (all), 2 (medium+), 3 (high only). Defaults to 2. |

## Call it

### cURL

```bash
curl "https://mcp.f1ow.com/v1/catalysts/economic-calendar?min_importance=3" \
  -H "Authorization: Bearer $F1OW_API_KEY"
```

### MCP

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "catalysts_economic_calendar",
    "arguments": {
      "min_importance": 3
    }
  }
}
```

### TypeScript

```ts
const res = await fetch("https://mcp.f1ow.com/v1/catalysts/economic-calendar?min_importance=3", {
  headers: { Authorization: `Bearer ${process.env.F1OW_API_KEY}` },
});
const data = await res.json(); // the tool's result as JSON, typed in the OpenAPI spec
console.log(data);
```

### Python

```python
import os, requests

res = requests.get(
    "https://mcp.f1ow.com/v1/catalysts/economic-calendar?min_importance=3",
    headers={"Authorization": f"Bearer {os.environ['F1OW_API_KEY']}"},
)
data = res.json()  # the tool's result as JSON, typed in the OpenAPI spec
print(data)
```

### WebSocket

```jsonc
// wss://mcp.f1ow.com/v1/ws — subprotocol "jsonrpc-2.0", Authorization: Bearer <key>
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "catalysts_economic_calendar",
    "arguments": {
      "min_importance": 3
    }
  }
}

// Or push a fresh result whenever it changes (minimum interval 15 s)
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "subscriptions/subscribe",
  "params": {
    "name": "catalysts_economic_calendar",
    "arguments": {
      "min_importance": 3
    },
    "intervalSeconds": 60
  }
}
```

### x402

```bash
# No account: the first call answers 402 with a PAYMENT-REQUIRED challenge;
# an x402 client pays it in USDC on Base and retries.
curl "https://mcp.f1ow.com/x402/v1/catalysts/economic-calendar?min_importance=3"
```

## Related tools

- [ETF Flows](https://www.f1ow.com/docs/tools/catalysts_etf_flows) — Daily spot-ETF net flows for BTC, ETH, SOL and XRP — the latest day, the per-fund breakdown, and the trailing trend it has to be read against.
- [Prediction Odds](https://www.f1ow.com/docs/tools/events_prediction_odds) — What real money says about a question: per-outcome probabilities, the volume standing behind them, and when the market resolves.
- [Crypto Calendar](https://www.f1ow.com/docs/tools/catalysts_calendar) — Crypto events landing inside the next seven days, filterable to a single coin when only its own catalysts matter.
- [Exchange Listings](https://www.f1ow.com/docs/tools/catalysts_exchange_listings) — Official venue notices for new listings, delistings and other trading changes, with scheduled times, recent history, and coin or venue filters.