getSymbols.tiingo {quantmod}

Download OHLC Data from Tiingo

Description

Downloads historical or realtime equity price data from https://www.tiingo.com/. Registration is required.

Usage

  getSymbols.tiingo(Symbols, env, api.key,
                    return.class="xts",
                    periodicity="daily",
                    adjust=FALSE,
                    from='2007-01-01',
                    to=Sys.Date(),
                    ...)

Arguments

Symbols

a character vector specifying the names of the symbols to be loaded

env

where to create objects (environment)

api.key

the API key issued by Tiingo when you registered (character)

return.class

class of returned object, see Value (character)

periodicity

one of "daily", "weekly", "monthly", or "Annually"

adjust

adjust for dividends and splits? (FALSE)

from

Retrieve data no earlier than this date. (2007-01-01)

to

Retrieve data through this date (Sys.Date())

...

additional parameters as per getSymbols

Details

Meant to be called internally by getSymbols only. This method is not meant to be called directly, instead a call to getSymbols("x", src="tiingo") will in turn call this method. It is documented for the sole purpose of highlighting the arguments accepted.

You must register with Tiingo in order to download their data. Register at their web site, https://www.tiingo.com, and you will receive an API key: a short string of alphanumeric characters (e.g., "FU4U"). Provide the API key every time you call getSymbols; or set it globally using setDefaults(getSymbols.tiingo, api.key="yourKey").

Tiingo provides daily, weekly, monthly, and annual data. Use periodicity to select one. This API accessor will return adjusted or unadjusted OHLC as well as split and dividend information.

For daily, weekly, and monthly data, Tiingo says the available data is up to 30 years;

Value

A call to getSymbols(Symbols, src="tiingo") will create objects in the specified environment, one object for each Symbol specified. The object class of the object(s) is determined by return.class. Presently this may be "ts", "zoo", "xts", or "timeSeries".

Author(s)

Steve Bronder

References

Tiingo documentation available at https://www.tiingo.com

See Also

getSymbols, getSymbols.yahoo, getSymbols.av

Examples

## Not run: 
# You'll need the API key given when you registered
getSymbols("IBM", src="tiingo", api.key="yourKey")

# Repeating your API key every time is tedious.
# Fortunately, you can set a global default.
setDefaults(getSymbols.tiingo, api.key="yourKey")
getSymbols("IBM", src="tiingo")

## End(Not run)