fz0x1/pricehist
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
A command-line tool for fetching and formatting historical price data, with support for multiple data sources and output formats.
51 commits 1 branch 30 tags 503 KiB
Find a file
Chris Berkhout 45a1e1b0df Add ISO 4217 data.
2021-05-24 20:44:14 +02:00
src/pricehist Add ISO 4217 data. 2021-05-24 20:44:14 +02:00
tests After running Black. 2021-04-20 20:41:58 +02:00
.flake8 Add Black, isort and flake8. 2021-04-20 20:41:58 +02:00
.gitignore Don't track vim settings in git. 2021-04-23 07:52:25 +02:00
LICENSE Rename and switch to poetry. 2021-02-28 15:21:56 +01:00
Makefile Add Black, isort and flake8. 2021-04-20 20:41:58 +02:00
poetry.lock Switch from xml.etree to lxml and cssselect. 2021-05-04 16:39:47 +02:00
pyproject.toml Switch from xml.etree to lxml and cssselect. 2021-05-04 16:39:47 +02:00
README.md Basic README. 2021-04-24 23:02:23 +02:00

README.md

pricehist

A command-line tool for fetching and formatting historical price data, with support for multiple data sources and output formats.

Installation

Install via pip:

pip install pricehist

Sources

Output formats

Examples

Show usage information:

pricehist -h

usage: pricehist [-h] {sources,source,fetch} ...

Fetch historical price data

optional arguments:
  -h, --help            show this help message and exit

commands:
  {sources,source,fetch}
    sources             list sources
    source              show source details
    fetch               fetch prices

Fetch prices after 2021-01-04, ending 2020-01-15, as CSV:

pricehist fetch ecb -p EUR/AUD -sx 2021-01-04 -e 2021-01-15 -o csv

date,base,quote,amount
2021-01-05,EUR,AUD,1.5927
2021-01-06,EUR,AUD,1.5824
2021-01-07,EUR,AUD,1.5836
2021-01-08,EUR,AUD,1.5758
2021-01-11,EUR,AUD,1.5783
2021-01-12,EUR,AUD,1.5742
2021-01-13,EUR,AUD,1.5734
2021-01-14,EUR,AUD,1.5642
2021-01-15,EUR,AUD,1.568

In Ledger format:

pricehist fetch ecb -p EUR/AUD -s 2021-01-01 -o ledger | head

P 2021/01/04 00:00:00 EUR 1.5928 AUD
P 2021/01/05 00:00:00 EUR 1.5927 AUD
P 2021/01/06 00:00:00 EUR 1.5824 AUD
P 2021/01/07 00:00:00 EUR 1.5836 AUD
P 2021/01/08 00:00:00 EUR 1.5758 AUD
P 2021/01/11 00:00:00 EUR 1.5783 AUD
P 2021/01/12 00:00:00 EUR 1.5742 AUD
P 2021/01/13 00:00:00 EUR 1.5734 AUD
P 2021/01/14 00:00:00 EUR 1.5642 AUD
P 2021/01/15 00:00:00 EUR 1.568 AUD

Generate SQL for a GnuCash database and apply it immediately:

pricehist fetch ecb -p EUR/AUD -s 2021-01-01 -o gnucash-sql | sqlite3 Accounts.gnucash
pricehist fetch ecb -p EUR/AUD -s 2021-01-01 -o gnucash-sql | mysql -u username -p -D databasename
pricehist fetch ecb -p EUR/AUD -s 2021-01-01 -o gnucash-sql | psql -U username -d databasename -v ON_ERROR_STOP=1

Design choices

To keep things simple, pricehist provides only univariate time series of daily historical prices. It doesn't provide other types of market, financial or economic data, real-time prices, or other temporal resolutions. Multiple or multivariate series require multiple invocations.

Alternatives

Beancount's bean-price tool fetches historical prices and addresses other workflow concerns in a Beancount-specific manner.

The GnuCash wiki documents wrapper scripts for the Finance::QuoteHist Perl module.

Some other projects with related goals include:

  • hledger-stockquotes: Generate an HLedger journal containing daily stock quotes for your commodities.
  • ledger_get_prices: Uses Yahoo finance to intelligently generate a ledger price database based on your current ledger commodities and time period.
  • LedgerStockUpdate: Locates any stocks you have in your ledger-cli file, then generates a price database of those stocks.
  • market-prices: Downloads market values of commodities from a few different sources.
  • price-database: A Python library and a CLI for storage of prices.