import-fred: Import Market Data from the Federal Reserve Database

import-fredR Documentation

Import Market Data from the Federal Reserve Database


Imports financial time series data from


fredSeries(symbols, from = NULL, to = Sys.timeDate(), 
    nDaysBack = 366, ...)
fredImport(query, file = "tempfile", source = NULL, frequency = "daily", 
    from = NULL, to = Sys.timeDate(), nDaysBack = NULL,
    save = FALSE, sep = ";", try = TRUE)    



a character string with filename, usually having extension ".csv", where to save the downloaded data.


a character string, one of "auto", "quarterly", "monthly", or "daily", defining the frequency of the data records. Note, the import function tries autodetect the frequency of the time series to be dowwnloaded. This may fail, in such case specify the frequency explicitely.


the date from when to extract the time series.


the number of days back.


a character string, denoting the location of the data at the web site.


a logical value, if set to TRUE the downloaded data file will be stored under the path and file name specified by the string file. By default FALSE.


a charcter value specifying the column separator.


a character string setting the URL of the source. If NULL, then the URL will be set automatically to its default value.


a character string with the symbols to be downloaded.


the end date of the data download, by default the current date.


a logical value, if set to TRUE the Internet access will be checked.


optional arguments to be passed.


The function fredImport returns an S4 object of class fWEBDATA with the following slots:


the function call.


the data as downloaded formatted as a data.frame.


a character vector whose elements contain the values of selected parameters of the argument list.


a character string with the name of the download. This can be overwritten specifying a user defined input argument.


a character string with an optional user defined description. By default just the current date when the test was applied will be returned.

The function fredSeries returns an S4 object of class timeSeries or alternatively an object specified by the function argument returnClass.


Internet Download Functions:

IMPORTANT NOTE: If the service provider changes the data file format it may become necessary to modify and update the functions.

Feel free to inspect the code of the functions and to create your own download function from other Internet web sites and Portals.


Diethelm Wuertz for the Rmetrics R-port.


Diethelm Wuertz, Yohan Chalabi, and Andrew Ellis, (2010); Financial Market Data for R/Rmetrics, Rmetrics eBook, Rmetrics Association and Finance Online, Zurich,


a = fredImport("DEXSZUS")
head(a@data)  # a@data is a data frame

b = fredSeries("DEXSZUS")
head(b) # timeSeries object

fImport documentation built on March 31, 2023, 3:01 p.m.

Related to import-fred in fImport...