Compare series
compare_seriesRead-only
Align up to five FRED economic time series on a common date axis to compare trends and values. Handles different frequencies when a frequency parameter is provided.
Instructions
Align 2-5 series on one date axis for comparison.
`series_ids`: 2-5 FRED series IDs. Same `start`/`end`/`transform` as
`get_observations`. If the series have DIFFERENT native frequencies you
must pass `frequency` (a frequency at least as coarse as the coarsest
series) — mixing frequencies without it returns misaligned dates. Units
differ per series unless a relative transform (e.g. pct_change_yoy) is
used — check each entry's `units` before comparing levels.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| series_ids | Yes | ||
| start | No | ||
| end | No | ||
| transform | No | level | |
| frequency | No | ||
| max_points | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| series | Yes | The series compared | |
| transform | Yes | The transform applied to every series | |
| rows | Yes | Aligned values, oldest first | |
| truncated | Yes | True if more rows exist than were returned |