# FRED Economic Series Search

> FRED Economic Series Search is a paid API for AI agents from fred-x402.vercel.app, paid per call via x402, $0.002/call, status down (last checked 2026-10-12).

Search the Federal Reserve Economic Data (FRED) database by keyword, returning top matching series ranked by popularity with their IDs, titles, and data frequency.

## Facts

- Endpoint: GET https://fred-x402.vercel.app/fred/search?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: down
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fred-x402-vercel-app-e1ea44d0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WdoyUuo6rY-bqIeAypaBQ

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 fred-x402-vercel-app-e1ea44d0
```

Example prompt: Search FRED for economic series related to 'housing starts' and show me the top 8 results with their series IDs and how frequently they're updated.

## When to prefer this

Use this endpoint when you don't know the exact FRED series ID and need to discover it by keyword. It's the right first step before fetching actual data values. Prefer this over guessing series IDs directly, especially for niche or less common indicators.

## Known failure modes

- Empty query string returns error or no results
- Overly broad or misspelled queries may return irrelevant series
- Limit exceeding 20 is silently capped or returns an error
- Network or upstream FRED API unavailability causes 5xx response
- Payment failure (402) if USDC balance is insufficient

## How this service works

Search FRED for economic series by keyword. Returns top matches ranked by popularity with series IDs, titles, and frequency. Useful when you don't know the exact series ID.

## Output

An array of matching FRED series objects, each containing a series ID (e.g. UNRATE), full title, units, data frequency (e.g. Monthly, Weekly), and a popularity score — sorted by popularity descending. Typically returns up to 8 results by default or up to 20 if specified.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "q": "GDP growth",
   "limit": "8"
  }
 }
}
```

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Search query (e.g. 'housing prices', 'yield curve', 'consumer confidence')"
      },
      "limit": {
       "type": "string",
       "description": "Number of results (default 8, max 20)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "id": {
        "type": "string"
       },
       "title": {
        "type": "string"
       },
       "popularity": {
        "type": "number"
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fred-x402-vercel-app-e1ea44d0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fred-x402.vercel.app](https://www.zero.xyz/host/fred-x402.vercel.app/llms.txt)