# Fathom Macroeconomic Data API — Release Series

> Fathom Macroeconomic Data API — Release Series is a paid API for AI agents from fathom-opal.vercel.app, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-14).

Returns all economic data series belonging to a specific FRED data release, such as GDP or CPI releases

## Facts

- Endpoint: POST https://fathom-opal.vercel.app/api/release-series
- Price: $0.06/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-release-series-4e5187b1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FB_zfcDwNo8qKl_DoVzYD

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-release-series-4e5187b1 -d '<json body>'
```

Example prompt: Can you pull up all the economic time series included in FRED release 10 — that's the Employment Situation report — and show me up to 50 series?

## When to prefer this

Use this endpoint when you need to discover or enumerate all economic time series belonging to a specific FRED data release (e.g., GDP, CPI, Employment Situation). It is ideal when you know the FRED release ID and want to understand what series/indicators are published under that release before fetching individual time series data. Prefer this over a general series search when you have a specific release in mind.

## Known failure modes

- Invalid or non-existent releaseId returns empty series array or error
- Missing required releaseId field causes request validation failure
- Limit parameter ignored or defaulted to 20 if not provided
- Rate limiting or payment failure (x402) prevents access
- FRED upstream outage may cause delayed or failed response

## How this service works

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

## Output

Returns a JSON object containing an array of economic time series objects associated with the specified FRED release, along with the source identifier and the release ID. Each series item includes metadata describing the individual economic indicators available within that release.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "releaseId"
 ],
 "properties": {
  "limit": {
   "type": "string",
   "description": "Max results (default: 20)"
  },
  "releaseId": {
   "type": "string",
   "description": "FRED release ID"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fathom-macroeconomic-data-api-release-series-4e5187b1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fathom-opal.vercel.app](https://www.zero.xyz/host/fathom-opal.vercel.app/llms.txt)