# FRED Economic Data Release Calendar

> FRED Economic Data Release Calendar is a paid API for AI agents from finanz.halowerk.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns scheduled economic-data release dates from the Federal Reserve Bank of St. Louis (FRED) for a caller-selected window of up to 366 days, optionally filtered by release ID or release name.

## Facts

- Endpoint: POST https://finanz.halowerk.com/v1/econ-calendar
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fred-economic-data-release-calendar-5b9dd682
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JUMXoDNE4tR8rtCUZ3A5k

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fred-economic-data-release-calendar-5b9dd682 -d '<json body>'
```

Example prompt: What economic data releases does FRED have scheduled over the next 60 days? I'm especially interested in anything related to inflation — search by release name for 'CPI'.

## When to prefer this

Use this endpoint when you need a forward-looking or near-term schedule of specific FRED economic data releases, especially when filtering by release name or ID. Prefer this over bulk FRED API access when you only need the calendar/scheduling metadata (dates, press-release flags, publisher links) rather than the actual data observations. Ideal for agents that need to trigger downstream actions around known publication dates.

## Known failure modes

- Window exceeds 366 days — request rejected with validation error
- Invalid release ID — returns empty results or not-found error
- Release name search with no matches — returns empty list
- Date window in the past with no historical releases — returns empty list
- FRED upstream unavailable — service may return a gateway or timeout error

## How this service works

Returns scheduled economic-data release dates from the Federal Reserve Bank of St. Louis for a caller-selected window of at most 366 days. Results can be restricted by release id or searched by release name and include the publisher link and press-release flag from the FRED release directory. This is an on-demand calendar lookup, not a mirror or bulk export. Dates are source publication dates and do not guarantee that observations are already available in FRED.

## Output

A list of scheduled economic-data release dates within the requested window, each entry including the release name, scheduled publication date, publisher link, press-release flag, and release ID. Dates reflect FRED's planned source publication schedule and do not confirm that observations are already available.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 50,
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum returned dates."
  },
  "search": {
   "type": "string",
   "maxLength": 100,
   "minLength": 2,
   "description": "Optional case-insensitive text filter on the release name."
  },
  "end_date": {
   "type": "string",
   "format": "date",
   "description": "Last release date, YYYY-MM-DD. Defaults to start_date plus window_days."
  },
  "start_date": {
   "type": "string",
   "format": "date",
   "description": "First release date, YYYY-MM-DD. Defaults to today UTC."
  },
  "release_ids": {
   "type": "array",
   "items": {
    "type": "integer",
    "minimum": 1
   },
   "maxItems": 30,
   "description": "Optional FRED release ids.",
   "uniqueItems": true
  },
  "window_days": {
   "type": "integer",
   "default": 30,
   "maximum": 366,
   "minimum": 1,
   "description": "Window length when end_date is omitted."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fred-economic-data-release-calendar-5b9dd682/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from finanz.halowerk.com](https://www.zero.xyz/host/finanz.halowerk.com/llms.txt)
