# 2s FRED Categories Lookup

> 2s FRED Categories Lookup is a paid API for AI agents from 2s.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Fetches FRED (Federal Reserve Economic Data) category hierarchy and series listings by category ID

## Facts

- Endpoint: GET https://2s.io/api/econ/fred-categories
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-fred-categories-lookup-8eefcfff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xl-HiRwg_9IjtbGWOxxsn

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 2s-fred-categories-lookup-8eefcfff
```

Example prompt: Show me the top-level FRED economic data categories and list up to 20 series for category ID 32991.

## When to prefer this

Use this endpoint when you need to browse or navigate the FRED economic data taxonomy, discover what macroeconomic series are available under a given category, or build a hierarchy of Federal Reserve data topics without needing a full FRED API key.

## Known failure modes

- Invalid categoryId returns empty or error response
- seriesLimit outside 0-50 range may be rejected or clamped
- Payment failure if insufficient USDC balance via x402
- Rate limiting or timeout on FRED upstream

## How this service works

Browse the Federal Reserve FRED category tree to DISCOVER economic series. Pass a categoryId to get that category (name + parent), its child categories, and the most-popular series filed under it (id, title, units, frequency) — then pull the data with econ.fred. Omit categoryId (or pass 0) for the eight top-level categories: Money/Banking/Finance, Population/Employment/Labor, National Accounts, Production & Business Activity, Prices, International Data, U.S. Regional Data, Academic Data. Walk down via each child's id. Free, public-domain (FRED). The structured map of what FRED actually contains — far more reliable than guessing series ids. Companion to econ.fred (fetch/search) and econ.fred-releases (calendar).

## Output

Returns a list of FRED categories (with IDs, names, and parent relationships) along with up to the requested number of economic data series belonging to the specified category, drawn from the Federal Reserve Bank of St. Louis FRED database.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "properties": {
      "categoryId": {
       "type": "integer",
       "description": "FRED category id (0 or omitted = top level)."
      },
      "seriesLimit": {
       "type": "integer",
       "description": "Max series to list for the category (0-50, default 10; 0 = none)."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-fred-categories-lookup-8eefcfff/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)