NAME

getquote — Fetch commodity prices for ledger(1)

SYNOPSIS

getquote symbol [exchange_to]

DESCRIPTION

getquote is a getquote implementation for ledger(1) using the TwelveData API.

By default, getquote first treats symbol as a currency and attempts to fetch the exchange rate of it and exchange_to (or USD if not given). If that fails, it will then treat symbol as a ticker and retrieve a quote.

The default behavior can be altered using the configuration file described in getquote(5).

ENVIRONMENT

TWELVE_DATA_API_KEY: API key for Twelve Data.
XDG_CONFIG_HOME: Location of the getquote configuration directory. (Defaults to ~/.local/config)

FILES

$XDG_DATA_HOME/getquote/keys/api.twelvedata.com: API key to use if TWELVE_DATA_API_KEY isn't set.

$XDG_DATA_HOME/getquote/symbols: Symbols file to be processed by getquoteaction.

EXIT STATUS

The getquote utility exits 0 on success, and >0 if an error occurs.

EXAMPLES

Get the price of Vanguard's Total Stock Market ETF (VTI) in a format suitable for ledger:

$ getquote VTI

Get the XMR/EUR exchange rate:

$ getquote XMR EUR

AUTHORS

Jacob R. Edwards <jacob@jacobedwards.org>