# Fathom Macroeconomic Data API

> Fathom Macroeconomic Data API is a paid API for AI agents from fsthum.vercel.app, paid per call via x402, $0.4/call, status unknown (last checked 2026-10-27).

Fetches historical observations for any FRED economic time series (GDP, inflation, unemployment, interest rates, etc.) with optional date filtering, frequency, and unit transformations

## Facts

- Endpoint: POST https://fsthum.vercel.app/api/observations?utm_source=zero.xyz
- Price: $0.4/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fathom-macroeconomic-data-api-89151fd5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PdHScfm1sGTOgt0PQOlCK

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-89151fd5 -d '<json body>'
```

Example prompt: Can you pull the last 20 quarterly observations of US GDP from FRED, sorted from most recent to oldest, using percent change from a year ago as the unit?

## When to prefer this

Choose this endpoint when you need historical macroeconomic time series data sourced from FRED — covering GDP, inflation, unemployment, interest rates, and 816,000+ other economic indicators — especially when you want flexible date filtering, frequency aggregation, or unit transformations (e.g. percent change) in a single call. Prefer this over manually scraping FRED or building your own integration when you need rapid, programmatic access to authoritative US and global economic data in an agent workflow.

## Known failure modes

- Invalid or unknown FRED series ID returns empty or error response
- Date range with no available data returns zero observations
- Invalid units or frequency parameter may return an error or fall back to default
- Network or upstream FRED API timeout causing failed response
- Malformed request body (missing required seriesId) returns validation error

## 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 label, a count of returned observations, and an array of observation objects — each typically including a date and the corresponding economic value for that period.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "seriesId"
 ],
 "properties": {
  "end": {
   "type": "string",
   "description": "End date YYYY-MM-DD"
  },
  "sort": {
   "type": "string",
   "description": "Sort order: asc or desc (default: desc)"
  },
  "limit": {
   "type": "string",
   "description": "Max observations (default: 10)"
  },
  "start": {
   "type": "string",
   "description": "Start date YYYY-MM-DD"
  },
  "units": {
   "type": "string",
   "description": "Units transformation (lin, chg, ch1, pch, pca, cch, cca, log)"
  },
  "seriesId": {
   "type": "string",
   "description": "FRED series ID (e.g. GDP, UNRATE, CPIAUCSL)"
  },
  "frequency": {
   "type": "string",
   "description": "Frequency (d, w, bw, m, q, sa, a)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source"
 ],
 "properties": {
  "count": {
   "type": "number"
  },
  "source": {
   "type": "string"
  },
  "series_id": {
   "type": "string"
  },
  "observations": {
   "type": "array",
   "items": {
    "type": "object"
   }
  }
 }
}
```

## More

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