# FRED Regional Economic Data Series

> FRED Regional Economic Data Series is a paid API for AI agents from 2s.io, paid per call via x402, $0.0045/call, status unknown (last checked 2026-09-14).

Retrieves cross-sectional regional economic data from the Federal Reserve's FRED regional database for a given series ID and optional date.

## Facts

- Endpoint: GET https://2s.io/api/econ/fred-regional
- Price: $0.0045/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fred-regional-economic-data-series-6604517d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3266TcFBhzSMaOnpNqFLU

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-regional-economic-data-series-6604517d
```

Example prompt: Pull the FRED regional series data for WIPCPI — I want to see per capita personal income by state, cross-sectioned as of 2023-01-01.

## When to prefer this

Use this endpoint when you need ground-truth regional economic data sourced directly from the Federal Reserve's FRED regional database — especially for state- or county-level cross-sectional snapshots of economic indicators like per capita income, unemployment, or housing metrics. Prefer this over scraping FRED's website or using a general search when you need structured, machine-readable regional series data with point-in-time querying. Ideal for economic research, regional comparisons, or enriching geographic datasets with official Fed statistics.

## Known failure modes

- Invalid or unknown seriesId returns an error or empty result
- Date outside the available range for the series may return no data
- Malformed date format (not YYYY-MM-DD) may cause a validation error
- Series ID that is not a regional series (e.g., a national FRED series) may fail to resolve a regional group
- Payment not fulfilled returns HTTP 402

## How this service works

Federal Reserve regional economic data: one snapshot of a FRED regional series across ALL its geographies (every U.S. state, county, or metro area) for a single period. Pass a regional series id (e.g. WIPCPI = per-capita personal income by state, or a state/county unemployment series) and get each region's name, FIPS region code, value, and per-region FRED series id, plus the group's units, frequency, and available date range. Add a date (YYYY-MM-DD) for a point-in-time cross-section; omit it for the latest. Authoritative St. Louis Fed (GeoFRED) data agents can't recite — per-state income, county unemployment, regional GDP — keyed by exact region codes. Free, public-domain. Companion to econ.fred (national series), econ.fred-categories (discover series ids), and census.demographics (ACS survey).

## Output

Returns a regional series group dataset from FRED corresponding to the given series ID, including values for all geographic units (e.g., states or counties) in the series at the specified date or the latest available period.

## 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": {
     "required": [
      "seriesId"
     ],
     "properties": {
      "date": {
       "type": "string",
       "description": "Optional YYYY-MM-DD period for a point-in-time cross-section (default: latest available)."
      },
      "seriesId": {
       "type": "string",
       "description": "A FRED regional series id (e.g. WIPCPI). Resolves to its regional series group."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fred-regional-economic-data-series-6604517d/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)