Get Historical Financial Data

Get the historic of stock market data for financial ticker symbols, e.g., values at each closing day.

Usage

get_historic(symbols = c("SAAB-B.ST"), wait.time = 0, .verbose = T, ...)

Arguments

symbols

character - A character string representing the financial indices to search for, e.g., ticker symbol(s).

wait.time

double, default = 0 - A character string representing an additional waiting time between 2 calls to the Yahoo API.

.verbose

logical, default = TRUE - If TRUE, send messages to the console.

...

Arguments passed on to get_yahoo_data

symbol

character - A character string representing the symbol for the financial instrument (e.g., "AAPL" for Apple).

start_date

character - A character string representing the start date in R date format (UTC time). If NULL, data starts from 1970-01-01.

end_date

character - A character string representing the end date in a valid R date format (UTC time). If NULL, data is retrieved up to the current date.

range

character - A character string representing the range for the returned datas : default will return daily values.

Valid range values

"1d", "5d", "1mo", "3mo", "6mo", "1y", "2y", "5y", "10y", "ytd" and "max"

Value

A data.frame containing the historical financial data with the following columns:

open: numeric The opening price for the period (default is each day).
close: numeric The closing price for the period (default is each day).
low: numeric The lowest price for the period (default is each day).
high: numeric The highest price for the period (default is each day).
volume: integer The traded volume.
timestamp: integer Unix timestamps corresponding to each data point.
date: POSIXct The day of the financial data point.
currency: character The currency in which the data is reported, depending on the marketplace.
symbol: character The stock or financial instrument symbol (e.g., "AAPL").
shortname: character The abbreviated name of the company or financial instrument.
longname: character The full name of the company or financial instrument.
exchangename: character The name of the exchange marketplace where the financial instrument is listed.
fullexchangename: character The full name of the exchange marketplace.
timezone: character The timezone in which the data is reported.
gmtoffset: integer The UNIX timestamp of difference between the market local time and the GMT time.
regularMarketPrice: numeric The actual price if market is open, or last closing price if not.
fiftyTwoWeekLow: numeric Lowest price for the last 52 weeks.
fiftyTwoWeekHigh: numeric Highest price for the last 52 weeks.
regularMarketDayHigh: numeric The highest price of the day (local exchange place day).
regularMarketDayLow: numeric The lowest price of the day (local exchange place day).

Details

Return a data.frame with additional attributes:

n.currencies: integer - Number of unique currencies in the data.frame.
currencies: character - A vector of currency symbols in the data.frame (e.g., "BTC", "ETH", "USD").
exchange: character - A vector of exchange pairs (e.g., "BTC => USD"). If not applicable, NULL (no entry).
date.fetch: Date - The date when the data was retrieved, set using Sys.Date().
crypto: logical - TRUE if cryptocurrencies are present, otherwise FALSE.
date.begin: POSIXct - The oldest observation in the dataset.
date.end: POSIXct - The most recent observation in the dataset.
date.dif: numeric - The number of seconds between date.begin and date.end, equivalent of difftime value.

See vignette("Functions_summary", package = "financr")

References

Source : https://query1.finance.yahoo.com/v8/finance/chart/

Examples