fred_series_observations
Retrieve data values for a FRED series with options for date ranges, transformations, and aggregation frequencies.
Instructions
Get observations (data values) for a FRED series.
Args: series_id: FRED series ID (e.g., "GNPCA", "UNRATE"). realtime_start: Start of real-time period (YYYY-MM-DD). realtime_end: End of real-time period (YYYY-MM-DD). limit: Max number of results. offset: Pagination offset. sort_order: "asc" or "desc" by observation date. observation_start: Start of observation range (YYYY-MM-DD). observation_end: End of observation range (YYYY-MM-DD). units: Data transformation — "lin" (levels), "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 rate of change), "cca" (continuously compounded annual rate of change), "log" (natural log). frequency: Aggregation frequency — "d" (daily), "w" (weekly), "bw" (biweekly), "m" (monthly), "q" (quarterly), "sa" (semiannual), "a" (annual). Weekly variants: "wef" (Fri), "weth" (Thu), "wew" (Wed), "wetu" (Tue), "wem" (Mon), "wesu" (Sun), "wesa" (Sat). aggregation_method: How to aggregate — "avg" (average), "sum", "eop" (end of period). output_type: 1=observations by real-time period, 2=all by vintage date, 3=new/revised by vintage date, 4=initial release only. vintage_dates: Comma-separated vintage dates (YYYY-MM-DD).
Returns: dict with key 'observations' containing data points with 'date' and 'value' fields.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| series_id | Yes | ||
| realtime_start | No | ||
| realtime_end | No | ||
| limit | No | ||
| offset | No | ||
| sort_order | No | ||
| observation_start | No | ||
| observation_end | No | ||
| units | No | ||
| frequency | No | ||
| aggregation_method | No | ||
| output_type | No | ||
| vintage_dates | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||