FRED series observations - US CPI inflation, GDP, unemployment rate, federal funds rate, Treasury yields, M2 money supply, ~800k more
Generic Federal Reserve Economic Data (FRED) series proxy. Pass any FRED series_id and receive observations plus metadata. Examples: CPIAUCSL (US CPI inflation), GDP (US GDP), UNRATE (US unemployment rate), DFF (federal funds effective rate), DGS10 (10-year Treasury yield), M2SL (M2 money supply). Covers the full FRED catalog (~800k macroeconomic time series from the St. Louis Fed).
Path parameters
FRED series identifier in upper-snake-case. Common examples: CPIAUCSL (US Consumer Price Index, all urban consumers, all items), GDP (US Gross Domestic Product), UNRATE (US unemployment rate), DFF (federal funds rate, effective, daily), DGS10 (10-year Treasury constant maturity rate), M2SL (M2 money supply, seasonally adjusted).
FRED series identifier in upper-snake-case. Common examples: CPIAUCSL (US Consumer Price Index, all urban consumers, all items), GDP (US Gross Domestic Product), UNRATE (US unemployment rate), DFF (federal funds rate, effective, daily), DGS10 (10-year Treasury constant maturity rate), M2SL (M2 money supply, seasonally adjusted).
Query parameters
ISO date YYYY-MM-DD lower bound (inclusive). Defaults to FRED earliest.
ISO date YYYY-MM-DD lower bound (inclusive). Defaults to FRED earliest.
ISO date YYYY-MM-DD upper bound (inclusive). Defaults to today.
ISO date YYYY-MM-DD upper bound (inclusive). Defaults to today.
Max observations to return. FRED's hard cap is 100000; we cap at 1000 here for RAM safety and predictable response sizes.
Max observations to return. FRED's hard cap is 100000; we cap at 1000 here for RAM safety and predictable response sizes.
'desc' returns the most recent observations first (default); 'asc' the oldest.
'desc' returns the most recent observations first (default); 'asc' the oldest.
FRED server-side frequency aggregation (DOWN-sample only, e.g. monthly->quarterly): d, w, bw, m, q, sa, a plus period-ending variants (wef/weth/wew/wetu/wem/wesu/wesa, bwew/bwem). Cannot up-sample. Pair with aggregation_method; defaults to the series' native frequency when omitted.
FRED server-side frequency aggregation (DOWN-sample only, e.g. monthly->quarterly): d, w, bw, m, q, sa, a plus period-ending variants (wef/weth/wew/wetu/wem/wesu/wesa, bwew/bwem). Cannot up-sample. Pair with aggregation_method; defaults to the series' native frequency when omitted.
How observations collapse when 'frequency' down-samples: avg (default), sum, eop (end of period). No effect unless 'frequency' is also supplied.
How observations collapse when 'frequency' down-samples: avg (default), sum, eop (end of period). No effect unless 'frequency' is also supplied.
FRED value transform applied UPSTREAM: lin (level, default), chg (change), ch1 (change from year ago), pch (percent change), pc1 (percent change from year ago), pca (compounded annual rate of change), cch (continuously compounded change), cca (continuously compounded annual rate), log (natural log). Percent transforms return percent NUMBERS (pch=3.2 means 3.2 percent, not 0.032); the 'units' metadata field keeps the series' original units, so the applied transform is echoed under 'transform'.
FRED value transform applied UPSTREAM: lin (level, default), chg (change), ch1 (change from year ago), pch (percent change), pc1 (percent change from year ago), pca (compounded annual rate of change), cch (continuously compounded change), cca (continuously compounded annual rate), log (natural log). Percent transforms return percent NUMBERS (pch=3.2 means 3.2 percent, not 0.032); the 'units' metadata field keeps the series' original units, so the applied transform is echoed under 'transform'.
Response
Single FRED economic series by series_id with observations and lightweight metadata (title, units, frequency, last_updated). operation_id auto-generated as fred_series_series_id by main._clean_operation_id (project convention).