edgar (version 2.0.8)

getMasterIndex: Retrieves quarterly master index

Description

getMasterIndex retrieves the quarterly master indexes from the U.S. SEC EDGAR server.

Usage

getMasterIndex(filing.year, useragent)

Value

Function downloads quarterly master index files and stores them into the mentioned directory.

Arguments

filing.year

vector of integer containing filing years.

useragent

Should be in the form of "YourName [e-mail]"

Details

getMasterIndex function takes filing year as an input parameter from a user, downloads quarterly master indexes from the US SEC server. www.sec.gov/Archives/edgar/full-index/. It then strips headers from the master index files, converts them into dataframe, and merges such quarterly dataframes into yearly dataframe, and stores them in Rda format. It has ability to download master indexes for multiple years based on the user input. This function creates a new directory 'edgar_MasterIndex' into current working directory to save these Rda Master Index. Please note, for all other functions in this package need to locate the same working directory to access these Rda master index files. User must follow the US SEC's fair access policy, i.e. download only what you need and limit your request rates, see www.sec.gov/os/accessing-edgar-data.

Examples

if (FALSE) {

useragent <- "YourName [e-mail]"

getMasterIndex(2006, useragent) 
## Downloads quarterly master index files for 2006 and 
## stores into yearly 2006master.Rda file.

getMasterIndex(c(2006, 2008), useragent) 
## Downloads quarterly master index files for 2006 and 2008, and 
## stores into 2006master.Rda and 2008master.Rda files.
}