# Fathom Macroeconomic Data API

> Fathom Macroeconomic Data API 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-15).

Fetches economic time series data from FRED (Federal Reserve Economic Data) by series ID, returning historical macroeconomic indicators like GDP, inflation, and unemployment.

## Facts

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

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-09f9b12e -d '<json body>'
```

Example prompt: Pull the FRED series for US unemployment rate — the series ID is UNRATE — and show me the latest data points.

## When to prefer this

Choose this endpoint when you need structured access to any of FRED's 816,000+ macroeconomic time series by their known FRED series ID, especially for US economic indicators like GDP, CPI, unemployment, or interest rates. It is ideal when you already know the FRED series ID and need a quick, pay-per-call lookup without setting up a full FRED API key or subscription.

## Known failure modes

- Invalid or non-existent FRED series ID returns an error or empty result
- Network timeout if FRED upstream is slow
- Payment failure (x402) if insufficient USDC balance
- Rate limiting if too many requests are made in quick succession
- Malformed request body missing the required seriesId field

## 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 the FRED series ID, the data source identifier, and an info object with metadata and historical data points for the requested economic time series.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "seriesId"
 ],
 "properties": {
  "seriesId": {
   "type": "string",
   "description": "FRED series ID (e.g. GDP, UNRATE)"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

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