analyze

Run statistical analysis on FRED® time series data via pipeline input.

The analyze command consumes JSONL from stdin and produces summary statistics or trend estimates. It is a terminal operator — it does not emit JSONL for further piping.

Examples:

  • Summary — descriptive statistics (mean, median, std, etc.)
  • Trend — direction and slope of a time series

USAGE

reserve analyze [subcommand]

Available Subcommands:

summaryCompute descriptive statistics for a series
trendFit a trend model (linear or Theil-Sen)

reserve analyze [subcommand] –help (for more details about a specific subcommand)

SUMMARY

Compute descriptive statistics for a time series.

Outputs include count, missing values, mean, standard deviation, percentiles, and change over time.

# Basic usage
reserve obs get UNRATE –format jsonl | reserve analyze summary

# Handle missing values
reserve obs get UNRATE –format jsonl | reserve transform filter –drop-missing | reserve analyze summary

TREND

Estimate the direction and slope of a time series.

Supports linear regression and Theil-Sen (robust to outliers and structural breaks).

Usage: reserve analyze trend [–method linear|theil-sen]

# Linear trend (default)
reserve obs get CPIAUCSL –start 2020-01-01 –format jsonl | reserve analyze trend

# Robust trend
 reserve obs get CPIAUCSL –start 2020-01-01 –format jsonl | reserve analyze trend –method theil-sen
 
 # Smoothe transformations
 reserve obs get CPIAUCSL –start 2020-01-01 –format jsonl | reserve transform pct-change –period 12 | reserve window roll –stat mean –window 3 | reserve analyze trend

WORKFLOW

# Fetch and summarize unemployment data
reserve obs get UNRATE –start 2020-01-01 –format jsonl | reserve analyze summary

# Compute year over year inflation
 reserve obs get CPIAUCSL –start 2020-01-01 –format jsonl | reserve transform pct-change –period 12
 
 # Trend estimation
 reserve obs get CPIAUCSL –start 2020-01-01 –format jsonl | reserve transform pct-change –period 12 | reserve window roll –stat mean –window 3 | reserve analyze trend
 
 

See Global Flags for additional global options available for this command.

No affiliation with the Federal Reserve Bank of St. Louis

Not endorsed nor supported by the FRED® API technical team

© 2026 Derick Schaefer