Download and Merge FRED Series — getFRED • tidyusmacro

A flexible wrapper that downloads one or more data series from the St. Louis Fed (FRED) API, optionally computes one-period percentage changes, and merges them into a tidy tibble keyed by date.

Usage

getFRED(..., keep_all = TRUE, rename_variables = NULL, lagged = NULL)

Arguments

...

One or more FRED series IDs. Each element may be either

Unnamed character string: The raw FRED ticker; column keeps the lowercase ticker name, e.g.\ "UNRATE".
Named character string: The value is the FRED ticker and the name becomes the column label, e.g.\ payroll = "PAYEMS".

You may also pass a single character vector (named or unnamed) for compatibility with older code.

keep_all

Logical. TRUE (default) performs a full join that keeps all dates across series; FALSE performs an inner join.

rename_variables

Optional character vector of new column names (one per series), retained for backward compatibility. Supply either this argument or names in ..., not both.

lagged

Logical scalar or logical vector. If TRUE (or the corresponding element is TRUE), the series is replaced by its one-period percentage change \((x_t / x_{t-1}) - 1\). Recycled to match the number of series if length 1.

Value

A tibble with a date column and one column per requested series.

Details

You may supply the series in two ways:

Natural “...” style: getFRED(unrate = "UNRATE", payroll = "PAYEMS"). Named arguments give friendly column names; unnamed arguments keep the (lower-case) ticker as the column name.
Legacy style: pass a single (optionally named) character vector—e.g.\ c(unrate = "UNRATE", payroll = "PAYEMS")—and/or use the rename_variables= argument. This remains supported for backward compatibility.

If you provide names in ... and a non-NULL rename_variables vector, the function stops and prompts you to choose a single naming method.

Examples

# \donttest{
# New interface
getFRED(unrate = "UNRATE", payroll = "PAYEMS")
#> Downloading UNRATE
#> Downloading PAYEMS
#> # A tibble: 1,044 × 3
#>    date       unrate payroll
#>    <date>      <dbl>   <dbl>
#>  1 1948-01-01    3.4   44679
#>  2 1948-02-01    3.8   44533
#>  3 1948-03-01    4     44683
#>  4 1948-04-01    3.9   44379
#>  5 1948-05-01    3.5   44796
#>  6 1948-06-01    3.6   45034
#>  7 1948-07-01    3.6   45160
#>  8 1948-08-01    3.9   45178
#>  9 1948-09-01    3.8   45294
#> 10 1948-10-01    3.7   45245
#> # ℹ 1,034 more rows

# Multiple unnamed series (columns become 'unrate' and 'payems')
getFRED("UNRATE", "PAYEMS")
#> Downloading UNRATE
#> Downloading PAYEMS
#> # A tibble: 1,044 × 3
#>    date       unrate payems
#>    <date>      <dbl>  <dbl>
#>  1 1948-01-01    3.4  44679
#>  2 1948-02-01    3.8  44533
#>  3 1948-03-01    4    44683
#>  4 1948-04-01    3.9  44379
#>  5 1948-05-01    3.5  44796
#>  6 1948-06-01    3.6  45034
#>  7 1948-07-01    3.6  45160
#>  8 1948-08-01    3.9  45178
#>  9 1948-09-01    3.8  45294
#> 10 1948-10-01    3.7  45245
#> # ℹ 1,034 more rows

# }