getDividends {quantmod}R Documentation

Load Financial Dividend Data

Description

Download, or download and append stock dividend data from Yahoo! Finance.

Usage

getDividends(Symbol, 
             from = "1970-01-01",
             to = Sys.Date(), 
             env = .GlobalEnv, 
             src = "yahoo", 
             auto.assign = TRUE, 
             auto.update = TRUE, 
             verbose = FALSE, ...)

Arguments

Symbol The Yahoo! stock symbol
from date from in CCYY-MM-DD format
to date to in CCYY-MM-DD format
env where to create object
src data source (only yahoo is valid at present)
auto.assign should results be loaded to env
auto.update automatically add dividend to data object
verbose display status of retrieval
... currently unused

Details

Eventually destined to be a wrapper function along the lines of getSymbols to different sources - this currently only support Yahoo data.

Value

If auto.assign is TRUE, the symbol will be written to the environment specified in env with a .div appended to the name.
If auto.update is TRUE and the object is of class xts, the dividends will be included as an attribute of the original object and be reassigned to the environment specified by env.
All other cases will return the dividend data as an xts object.

Note

This function is very preliminary - and will most likely change significantly in the future.

Author(s)

Jeffrey A. Ryan

References

Yahoo! Finance: http://finance.yahoo.com

See Also

getSymbols

Examples

## Not run: 
getSymbols("MSFT")
getDividends("MSFT")

getDividends(MSFT)
## End(Not run)
[Package quantmod version 0.3-6 Index]