# Fathom Macroeconomic Data Search API

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

Searches 816,000+ FRED-powered economic time series by keyword and returns matching macroeconomic indicators

## Facts

- Endpoint: POST https://fathoms.vercel.app/api/search
- 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-search-api-96fb6d44
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2SQa3TsOf9bnUjZu48sOH

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-search-api-96fb6d44 -d '<json body>'
```

Example prompt: Search the FRED macroeconomic database for time series related to 'housing starts' and give me the top 5 results.

## When to prefer this

Choose this endpoint when you need to discover or search across a massive catalog of macroeconomic and government statistical time series, especially US economic indicators sourced from FRED. Ideal for research agents, financial analysis workflows, or any task requiring discovery of GDP, inflation, unemployment, interest rate, or other macroeconomic data series by keyword before fetching specific values.

## Known failure modes

- Missing required 'query' parameter returns validation error
- Empty or overly broad query may return low-quality or irrelevant series
- Limit parameter ignored if not a valid string-encoded integer
- Series array may be empty if no matching indicators exist for niche queries
- Payment failure via x402 protocol blocks request before processing

## 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 original query string, total count of matched series, data source attribution (FRED), and an array of matching economic time series objects with metadata about each series.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "limit": {
   "type": "string",
   "description": "Max results (default: 10)"
  },
  "query": {
   "type": "string",
   "description": "Search keywords (e.g. 'inflation rate', 'housing starts')"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

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