# Fathom Macroeconomic Data API — Release Series Lookup

> Fathom Macroeconomic Data API — Release Series Lookup 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-15).

Returns all economic time series belonging to a specific FRED data release, such as all series in the GDP or CPI release.

## Facts

- Endpoint: POST https://fredthom.vercel.app/api/release-series
- Price: $0.4/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fathom-macroeconomic-data-api-release-series-lookup-2d7419c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5y95Y2s_U8CZs36WV8LLS

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-lookup-2d7419c3 -d '<json body>'
```

Example prompt: Can you pull all the economic time series that are part of FRED release 10 — show me up to 50 results?

## When to prefer this

Use this endpoint when you need to discover or enumerate all economic time series that belong to a specific FRED data release (e.g., all series under the GDP release, the CPI release, or the Employment Situation release). Prefer this over a general series search when you already know the FRED release ID and want a structured list of all its constituent indicators.

## Known failure modes

- Missing or invalid releaseId returns an error or empty series array
- Non-existent FRED release ID returns empty results
- Limit parameter ignored or defaulted to 20 if not provided
- Payment failure (402) if x402 payment is not properly attached
- Network timeout on Vercel serverless cold start

## 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 an array of economic time series objects associated with the specified FRED release ID, along with the source label and release ID echoed back. Each series object in the array contains metadata about an individual economic indicator belonging to 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-lookup-2d7419c3/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)