# Fathom Macroeconomic Data API — Bulk Series Fetch

> Fathom Macroeconomic Data API — Bulk Series Fetch is a paid API for AI agents from fredthom.vercel.app, paid per call via x402, $0.35/call, status unknown (last checked 2026-09-13).

Fetches recent observations for multiple FRED economic time series in a single bulk request, covering GDP, inflation, unemployment, interest rates, and 816,000+ other series.

## Facts

- Endpoint: POST https://fredthom.vercel.app/api/bulk
- Price: $0.35/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fathom-macroeconomic-data-api-bulk-series-fetch-604b451d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tIIpFMyXvoYwBigcs_rGZ

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-bulk-series-fetch-604b451d -d '<json body>'
```

Example prompt: Pull the latest 5 observations each for GDP, UNRATE, CPIAUCSL, and FEDFUNDS from Fathom's FRED-powered bulk API so I can compare recent trends in growth, unemployment, inflation, and interest rates.

## When to prefer this

Use this endpoint when you need to fetch multiple FRED economic time series in a single call rather than making individual requests per series. Ideal for macroeconomic dashboards, economic research, financial analysis workflows, or any agent task requiring simultaneous access to indicators like GDP, CPI, unemployment rate, or interest rates. Prefer over direct FRED API when you want a simplified x402-payable interface without managing FRED API keys.

## Known failure modes

- Invalid or unrecognized FRED series ID returns error or empty result for that series
- Payment of 0.35 USDC not provided — 402 Payment Required response
- Too many series IDs in a single request may cause timeout or partial results
- Limit parameter set too high may slow response
- FRED upstream outage causes data unavailability

## 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 FRED and a 'results' object keyed by each requested series ID, containing recent observation values and metadata for each economic time series.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "seriesIds"
 ],
 "properties": {
  "limit": {
   "type": "string",
   "description": "Observations per series (default: 5)"
  },
  "seriesIds": {
   "type": "array",
   "description": "Array of FRED series IDs (e.g. ['GDP', 'UNRATE', 'CPIAUCSL'])"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source"
 ],
 "properties": {
  "source": {
   "type": "string"
  },
  "results": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fathom-macroeconomic-data-api-bulk-series-fetch-604b451d/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)