get_fred_series

kr.gronox/finbridge · Verify this server

Fetch observations (time series data points) for a FRED series, with optional date range, frequency aggregation, and unit transformation. One series at a time, by ID. Use search_fred_series when you do not know the ID, and get_fred_snapshot for a fixed basket of headline indicators in one call. Args: - series_id: FRED series ID, e.g. 'CPIAUCSL', 'UNRATE', 'DGS10', 'DEXKOUS' (case-insensitive) - from / to: YYYY-MM-DD observation range (optional) - frequency: aggregate to d/w/m/q/a (optional; FRED averages within the period; cannot be finer than the native frequency) - units: lin (levels, default) | chg (change) | pch (% change) | pc1 (% change from year ago) | log (natural log) - limit: 1-1000 (default 120). Without from/to this returns the LATEST N observations; with a range, the latest N within the range. - response_format: 'markdown' (default) or 'json' Returns: {series:{id,title,units,frequency,last_updated}, observations:[{date, value}], source}. Observations are ascending by date; value is null where FRED reports '.'. Examples: - "US 10Y treasury yield, last 30 points" -> {series_id:'DGS10', limit:30} - "CPI YoY inflation since 2020" -> {series_id:'CPIAUCSL', units:'pc1', from:'2020-01-01'} - "annual average USD/KRW 2023-2025" -> {series_id:'DEXKOUS', from:'2023-01-01', to:'2025-12-31', frequency:'a'} - Don't use for series discovery — use search_fred_series first. Errors: unknown series_id suggests search_fred_series; invalid frequency/range combinations explain the constraint; missing FRED_API_KEY returns a hint to obtain a free key.