Display value of crypto-currency hodlings. Prices fetched from coinmarketcap API.
git. You can skip to the next section if you already have these.
node.js spectacular platform. LTS (Long-term support) is the right choice for most.
git incredible version control (needed in the background to install some dependencies on first install).
Optional: if you want easy switching between different
node.js versions in the future and you are using unix based systems (macOS, Linux), you can install
node.js via fantastic n (don't download it from nodejs.org in this case).
npm (Node Package Manager) is installed automatically with
node.js install (just FYI).
In Terminal (Linux, macOS) or Command Prompt (Windows) type:
npm install -g hodlings
hodl -h for complete list and here are a few examples:
hodl -x eur
hodl -x cny
--eth to focus on Ethereum or
--btc to focus on Bitcoin and save space for two unneeded columns.
Create or edit the file
~/.hodlings (Linux/MacOS: /home/[user], Windows: c:\Users\[user]) containing your portfolio. Use
# to put in comments.
Specifying the entire portfolio is simple:
# Hodlings BTC: 0.3123 ETH: 14.99858897 GNT: 148 REP: 623
Just use token ticker symbols or (even better) the token ids because multiple tokens can have the same ticker :/
Same file but using token ids:
# Hodlings bitcoin: 0.3123 ethereum: 14.99858897 golem-network-tokens: 148 augur: 623
Read token ids from CoinMarketCap API.
Tip: it is much easier to read the json output in Chrome if you install the JSONView Chrome extension first. There are equivalent extensions for other browsers.
If you run
hodl without this file present, it will create an example file for your convenience.
To use a different hodlings file for portfolio check the
-f option (basically just use
hodl -f ~/path_to/hodlings2).
Usage: hodl [options] Options: -w, --watch refresh data periodically every 10 min -f, --file <f> file to use for hodlings [~/.hodlings] -x, --convert <currency> currency to display (usd, eur, cny...) --columns <columns> columns to display --eth focus on eth, hide the bitcoin-specific columns (value-btc, 7-day-change-vs-btc) --btc focus on btc, hide the ethereum-specific columns (value-eth, 7-day-change-vs-eth) --locale <locale> locale to use for formatting [en] --supported-currencies shows list of supported currencies --supported-locales shows list of supported locales --available-columns shows list of columns --no-color don't display colors -h, --help output usage information
hodlings is based on crytrac.
Improvements over original project (I wrote this list in the beginning, there were more improvements later):
I changed the project's repo/name because:
Thanx again to Joe Wasson for a great project which persuaded with simplicity and nice look.