# 2s FRED Economic Releases

> 2s FRED Economic Releases is a paid API for AI agents from 2s.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Retrieves upcoming or past Federal Reserve Economic Data (FRED) release schedules, optionally filtered by date, name, or release ID

## Facts

- Endpoint: GET https://2s.io/api/econ/fred-releases
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-fred-economic-releases-decc4b62
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xd_1YpclghvrV9tYVG7GD

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 2s-fred-economic-releases-decc4b62
```

Example prompt: Show me the next 10 FRED economic data releases starting from 2025-01-15, and filter them to anything related to the Consumer Price Index.

## When to prefer this

Use this endpoint when you need structured, ground-truth Federal Reserve (FRED) economic release schedule data — especially for building economic calendars, triggering workflows on data publication events, or answering questions about when specific macroeconomic indicators (CPI, employment, GDP) will be published. Prefer this over scraped news sources when accuracy and structured output are required.

## Known failure modes

- Invalid date format for 'from' parameter returns an error
- Limit out of range (outside 1-100) returns a validation error
- No releases match the name filter — returns empty list
- FRED upstream data temporarily unavailable — may return 5xx
- Payment not accepted — 402 response if USDC payment fails

## How this service works

The US economic-data release CALENDAR — when official economic reports are published, from the Federal Reserve's FRED. Returns upcoming release dates (date, release name, FRED release id), starting from `from` (default today), ascending. Filter by name to find a specific report's schedule (e.g. name="Consumer Price Index" → the next CPI dates; "Employment Situation" → jobs report; "Gross Domestic Product"; "FOMC"), or by releaseId. Free, public-domain (FRED). Future release dates an LLM cannot possibly know — essential for trading, scheduling, and macro-monitoring agents that need to act around data drops. Pair with econ.fred to pull the actual numbers once a release is out.

## Output

A list of FRED economic data release records including release names, scheduled dates, and FRED release IDs, filtered by the specified date range, name keyword, or release ID, up to the requested limit.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "properties": {
      "from": {
       "type": "string",
       "description": "Earliest release date YYYY-MM-DD (default today)."
      },
      "name": {
       "type": "string",
       "description": "Filter by release name, e.g. \"Consumer Price Index\", \"Employment Situation\"."
      },
      "limit": {
       "type": "integer",
       "description": "Max releases (1-100, default 20)."
      },
      "releaseId": {
       "type": "integer",
       "description": "Filter by FRED release id."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-fred-economic-releases-decc4b62/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)