Learn R Programming

fred (version 0.3.1)

Access 'Federal Reserve Economic Data'

Description

Provides clean, tidy access to economic data from the 'Federal Reserve Economic Data' ('FRED') API . 'FRED' is maintained by the 'Federal Reserve Bank of St. Louis' and contains over 800,000 time series from 118 sources covering GDP, employment, inflation, interest rates, trade, and more. Dedicated functions fetch series observations, search for series, browse categories, releases, and tags, and retrieve series metadata. Multiple series can be fetched in a single call, in long or wide format. Server-side unit transformations (percent change, log, etc.) and frequency aggregation are supported, with readable transform aliases such as 'yoy_pct' and 'log_diff'. Real-time and vintage helpers (built on 'ALFRED') return a series as it appeared on a given date, the first-release version, every revision, or a panel of selected vintages. An offline curated catalogue of around fifty popular series, NBER recession reference dates, and FOMC meeting dates support discoverability and event-study workflows. Default 'plot' method shades NBER recession periods. Reproducibility helpers produce BibTeX or plain-text citations and YAML manifests with per-object hashes. Data is cached locally for subsequent calls. This product uses the 'FRED' API but is not endorsed or certified by the 'Federal Reserve Bank of St. Louis'.

Copy Link

Version

Install

install.packages('fred')

Monthly Downloads

486

Version

0.3.1

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Charles Coverdale

Last Published

September 9th, 2026

Functions in fred (0.3.1)

fred_updates

List recently updated FRED series
print.fred_tbl

Print method for fred_tbl
print.fred_manifest

Print method for fred_manifest
fred_vintage_revisions

Summarise revision behaviour for a FRED series
fred_sources

List all FRED data sources
fred_tags

List or search FRED tags
fred_request

Make a raw request to the FRED API
fred_source_releases

List releases from a source
plot.fred_tbl

Plot a fred_tbl
fred_vintages

Get vintage dates for a FRED series
summary.fred_tbl

Summary method for fred_tbl
[.fred_tbl

Subset method for fred_tbl
fred_cache_info

Inspect the local fred cache
fred_as_of

Fetch a series as it appeared on a given vintage date
fred_all_vintages

Fetch every vintage of a series
fred-package

fred: Access 'Federal Reserve Economic Data'
clear_cache

Clear the fred cache
fred_category_children

List child categories
fred_catalogue

Browse a curated catalogue of popular FRED series
fred_category

Get a FRED category
fred_aggregate

Aggregate FRED observations to a coarser frequency
fred_browse

Browse the FRED category tree
fred_first_release

Fetch the first-release ("real-time") version of a series
fred_category_series

List series in a category
fred_manifest

Snapshot a session's FRED downloads as a YAML manifest
fred_interpolate

Fill missing values in a FRED series
fred_event_window

Extract data windows around event dates
fred_real_time_panel

Fetch a real-time panel of a series across selected vintages
fred_info

Get metadata for a FRED series
fred_get_key

Get the current FRED API key
fred_cite_series

Generate a citation for a FRED series
fred_fomc_dates

FOMC scheduled meeting dates and decisions
fred_recession_dates

NBER US business-cycle reference dates
fred_search

Search for FRED series
fred_release_series

List series in a release
fred_release_dates

Get release dates
fred_series

Fetch observations for one or more FRED series
fred_related_tags

Find tags related to a given tag
fred_set_key

Set the FRED API key
fred_releases

List all FRED releases