Pulls dividends for a list of securities. Data includes dividend, adjusted dividend, payment date, record date, and declaration date

fmpc_security_dividends(
  symbols = "AAPL",
  startDate = Sys.Date() - 360,
  endDate = Sys.Date()
)

Arguments

symbols

one or more symbols from the FMP available list that can be found using fmpc_symbols_by_market. A valid API token must be set in order to enable functionality. See documentation for setting a token under fmpc_set_token.

startDate

filter start date in yyyy-mm-dd format.

endDate

filter end date in yyyy-mm-dd format.

Value

a data frame of dividend history that includes payment date, record date, and declaration date

Warning

Each symbol is a separate API call. If the API token has monthly limits, this should be considered before making a bulk request

Examples

if (FALSE) { # Setting API key to DEMO allows for AAPL only fmpc_set_token() fmpc_security_dividends('AAPL') # For multiple symbols, set a valid API Token fmpc_set_token('FMPAPIKEY') fmpc_security_dividends(c('AAPL','MSFT','SPY'), startDate = '2010-01-01') }