# Fathom Macroeconomic Data API — Category Tags

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

Returns the tags associated with a specific FRED economic data category by category ID

## Facts

- Endpoint: POST https://fredfathom.vercel.app/api/category-tags?utm_source=zero.xyz
- Price: $0.04/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-category-tags-de280d1f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_67ZyYVZoIcIYOTmg72G9R

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-category-tags-de280d1f -d '<json body>'
```

Example prompt: Can you pull the tags associated with FRED category ID 32455 so I can see what themes or labels are attached to that economic data group?

## When to prefer this

Use this endpoint when you need to discover or enumerate the metadata tags associated with a specific FRED economic category, particularly when building data catalogs, filtering series by topic, or exploring what themes are represented within a FRED category. Prefer this over general FRED series search when you already know the category ID and need its tag taxonomy rather than full time series data.

## Known failure modes

- Invalid or non-existent category ID returns empty tags array or error
- Category ID with no associated tags returns empty array
- Malformed request missing required categoryId field returns validation error
- Rate limiting or payment failure returns 402 or 429 error
- FRED upstream service unavailability causes timeout or 503

## 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 associated with the requested FRED category, the category ID, and the data source identifier. Each tag object includes metadata about the tag such as its name, group ID, notes, creation date, popularity, and series count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "categoryId"
 ],
 "properties": {
  "categoryId": {
   "type": "string",
   "description": "FRED category ID"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

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