# Fathom Macroeconomic Data API — Release Series Lookup

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

Returns all economic time series belonging to a specific FRED data release, given a FRED release ID

## Facts

- Endpoint: POST https://fathoms.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-lookup-4606a40e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hU2tw6LEKfK3DxnEOdsi-

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-4606a40e -d '<json body>'
```

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

## When to prefer this

Use this endpoint when you know a specific FRED release ID and want to enumerate all the time series it contains — ideal for discovery workflows where you need to explore what indicators are available within a macroeconomic data release before fetching individual series. Prefer this over a general series search when you already have the release context and want a structured list of series grouped under that release.

## Known failure modes

- Invalid or non-existent releaseId returns an empty series array or an error
- releaseId not provided triggers a 400 validation error (required field)
- limit parameter ignored or clamped if set to an unsupported value
- Network or upstream FRED API unavailability causes a 500 or timeout
- Payment not provided or insufficient USDC causes a 402 Payment Required 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

An array of economic time series objects associated with the specified FRED release, along with the source identifier and the release ID used in the query. Each series object contains metadata such as the series ID, name, frequency, units, and other FRED series attributes.

## 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-4606a40e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fathoms.vercel.app](https://www.zero.xyz/host/fathoms.vercel.app/llms.txt)