# Fathom Macroeconomic Data API — FRED Releases

> Fathom Macroeconomic Data API — FRED Releases is a paid API for AI agents from fredthom.vercel.app, paid per call via x402, $0.4/call, status unknown (last checked 2026-09-14).

Returns a list of FRED economic data releases (e.g. GDP, CPI, unemployment reports) with optional date filtering and result limits

## Facts

- Endpoint: POST https://fredthom.vercel.app/api/releases
- Price: $0.4/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fathom-macroeconomic-data-api-fred-releases-10b20b55
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9yA0iSzWUGfv_bcveMu4A

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 fathom-macroeconomic-data-api-fred-releases-10b20b55 -d '<json body>'
```

Example prompt: Can you pull the list of the first 10 FRED macroeconomic data releases — just the dates, not the full release details?

## When to prefer this

Use this endpoint when you need to discover or enumerate what economic data releases are available via FRED (816,000+ series) — especially useful for building release schedules, browsing available macroeconomic indicators, or paginating through available reports. Prefer this over direct FRED API access when you want a pre-integrated, pay-per-call wrapper with no API key management.

## Known failure modes

- Invalid limit value (non-numeric string) may cause unexpected truncation or error
- Empty releases array if FRED upstream is unavailable
- Payment failure (402) if USDC balance is insufficient before call proceeds
- Timeout if FRED data pipeline is slow or unresponsive
- Malformed response if Vercel serverless function cold-starts under load

## How this service works

Free macroeconomic data API powered by FRED. 816,000+ economic time series. GDP, inflation, unemployment, interest rates, and more.

## Output

A JSON object with a 'source' field identifying the data source and a 'releases' array containing release objects from FRED, each describing an available economic data release publication (e.g. GDP, CPI, unemployment). The number of results is bounded by the limit parameter (default 20). When dates=true, only date values are returned.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "dates": {
   "type": "boolean",
   "description": "If true, return dates only"
  },
  "limit": {
   "type": "string",
   "description": "Max results (default: 20)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source"
 ],
 "properties": {
  "source": {
   "type": "string"
  },
  "releases": {
   "type": "array",
   "items": {
    "type": "object"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fathom-macroeconomic-data-api-fred-releases-10b20b55/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fredthom.vercel.app](https://www.zero.xyz/host/fredthom.vercel.app/llms.txt)