# Fathom Macroeconomic Data API — Tags Endpoint

> Fathom Macroeconomic Data API — Tags Endpoint is a paid API for AI agents from fathoms.vercel.app, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-15).

Retrieves and searches available tags/categories for 816,000+ FRED-powered macroeconomic economic time series

## Facts

- Endpoint: POST https://fathoms.vercel.app/api/tags
- Price: $0.04/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-tags-endpoint-00732286
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2A9LGoQo2R1p0acVqt9x9

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-tags-endpoint-00732286 -d '<json body>'
```

Example prompt: Search the Fathom macroeconomic database for tags related to 'inflation' and show me up to 20 results so I can find the right category for economic time series data.

## When to prefer this

Use this endpoint when you need to discover or browse available categories/tags within the Fathom macroeconomic database before querying specific time series. It is ideal as a first step in a workflow where you want to find the right classification for GDP, inflation, unemployment, interest rates, or other economic indicators. Prefer this over direct series queries when you don't yet know the exact tag or category name for the data you need.

## Known failure modes

- Invalid or missing body parameters may return an error or default response
- No tags found matching the search keyword returns an empty tags array
- Server-side FRED data source unavailability may cause delayed or failed responses
- Overly broad or misspelled search terms may return irrelevant or no tags
- Rate limiting or payment failure may block access to the endpoint

## 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 an array of tag objects (each describing an available macroeconomic category or classification from the FRED-backed database) and a source string indicating the data provider. Tags can be used to filter or discover specific economic time series.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "string",
   "description": "Max results (default: 50)"
  },
  "search": {
   "type": "string",
   "description": "Filter tags by keyword"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source"
 ],
 "properties": {
  "tags": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "source": {
   "type": "string"
  }
 }
}
```

## More

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