# Fathom Macroeconomic Data API (FRED)

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

Retrieves macroeconomic time series data from FRED (Federal Reserve Economic Data) by series ID, covering GDP, inflation, unemployment, interest rates, and 816,000+ other indicators.

## Facts

- Endpoint: POST https://fredfathom.vercel.app/api/series?utm_source=zero.xyz
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fathom-macroeconomic-data-api-fred-246021e5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nteIiBdLEdxiPYUQTgEZP

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-fred-246021e5 -d '<json body>'
```

Example prompt: Pull the FRED series for US unemployment rate (UNRATE) so I can see how it's trended over time.

## When to prefer this

Choose this endpoint when you need programmatic access to any of FRED's 816,000+ macroeconomic time series without setting up a FRED API key. Ideal for agents performing economic research, financial analysis, or data enrichment tasks where the specific FRED series ID is known. Prefer this over direct FRED API calls when operating in a pay-per-use agent context using x402 micropayments.

## Known failure modes

- Invalid or unknown FRED series ID returns an error or empty result
- Missing required seriesId field causes a validation error
- FRED upstream API downtime may result in failed responses
- Misspelled series IDs (e.g. 'GDB' instead of 'GDP') will not return data
- Payment failure (x402) blocks the request before it reaches FRED

## 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 an object containing the FRED series metadata (info object), the series ID, and a source attribution string. The info object likely contains the time series observations, units, frequency, and descriptive metadata for the requested economic indicator.

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