# Citiview FRED Economic Time Series

> Citiview FRED Economic Time Series is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-14).

Fetches observations for any FRED economic time series by ID with optional transformations, frequency aggregation, and date range filtering

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/fred/series?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-fred-economic-time-series-4619a260
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sKqnldS8lZJJhdMt7TI5Z

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 citiview-fred-economic-time-series-4619a260
```

Example prompt: Pull the US unemployment rate (FRED series UNRATE) from January 2015 to December 2023 as monthly frequency, showing the percent change from a year ago.

## When to prefer this

Use this endpoint when you need historical economic time series data from the Federal Reserve's FRED database — including macroeconomic indicators like unemployment, inflation, GDP, interest rates, and thousands of other series. Prefer it over general web search when you need structured, dated observations suitable for charting or computation, and when built-in transforms like percent change or year-over-year comparisons are needed.

## Known failure modes

- Invalid or unknown FRED series ID returns an error or empty result
- Date range with no available data returns empty observations array
- Unsupported units/frequency enum value may return an error
- Network or upstream FRED API unavailability causes request failure
- Very large date ranges without a limit parameter may return excessive data or be truncated

## How this service works

Any public-domain FRED economic time series by id (UNRATE, CPIAUCSL, GDP, DGS10, thousands more): observations with optional transforms (change, % change, % change from a year ago), frequency aggregation and date range, plus title, units and notes.

## Output

Returns an array of dated observations for the requested FRED series, each with a date and value, along with series metadata including title, units description, and notes. If a transform (e.g. percent change, year-over-year change) or frequency aggregation is applied, values reflect the transformed/aggregated figures.

## 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": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "FRED series id"
      },
      "end": {
       "type": "string",
       "description": "YYYY-MM-DD"
      },
      "limit": {
       "type": "integer"
      },
      "start": {
       "type": "string",
       "description": "YYYY-MM-DD"
      },
      "units": {
       "type": "string",
       "description": "lin, chg, ch1, pch, pc1, pca, log"
      },
      "frequency": {
       "type": "string",
       "description": "d, w, m, q, a"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/citiview-fred-economic-time-series-4619a260/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)