Skip to content
/ hodl Public

Your friendly, no-nonsense tool to instantaneously check cryptocurrency prices, helping you HODL one day at a time :)

License

Notifications You must be signed in to change notification settings

netevert/hodl

Repository files navigation

Icon

Maintenance PyPI PyPI PyPI Build Status Coverage Status Donations

HODL is your friendly, no-nonsense tool to instantaneously check cryptocurrency prices on the command line, helping you HODL one day at a time :)

Running HODL is easy:

Demo

Installation

To install HODL run:

pip install hodl

Features

Currencies supported:

View price percentage variations between lookups

C:\>hodl -r
[*] generating price change report
1 BTC = 11092.47 USD  -0.07%
1 BCH = 1243.01 USD   -0.12%
1 ETH = 849.53 USD    -0.06%
1 LTC = 208.18 USD     0.00%
1 XMR = 347.17 USD     0.03%
1 XRP = 0.92 USD       0.00%
1 DASH = 599.18 USD   -0.07%
1 ZEC = 389.29 USD    -0.03%

Set preferred conversion currency

C:\>hodl -sf USD
[*] updating standard fiat to USD ...
[*] success: USD configured as standard fiat

View price for a single cryptocurrency

C:\>hodl -c btc
1 BTC = 13500.01 USD

Convert the price for a single cryptocurrency against selected fiat currencies

C:\>hodl -c ltc -f CHF
1 LTC = 223.93 CHF

Convert the price for a single cryptocurrency against another cryptocurrency

C:\>hodl -cc btc ltc
1 BTC = 61.36111727 LTC

View total value of portfolio holdings

C:\>hodl -vp
[*] BTC portfolio value: 123475.20 USD
[*] BCH portfolio value: 234.15 USD
[*] ETH portfolio value: 672.00 USD
[*] LTC portfolio value: 120.05 USD
[*] XMR portfolio value: 1122.43 USD
[*] XRP portfolio value: 0.00 USD
[*] DASH portfolio value: 0.00 USD
[*] ZEC portfolio value: 0.00 USD

Configure portfolio holdings

C:\hodl -cp btc 15
[*] BTC portfolio value set at 15 coins

HODL is under active development, consult the GitHub issue tracker to check what's in the development pipeline.

Bugs/Requests/Contributing

Please use the GitHub issue tracker to submit bugs or request features.

To contribute please consult the contribution guide.

License

Distributed under the terms of the MIT license, HODL is free and open source software.

Versioning

This project adheres to Semantic Versioning.

Donations

If you like HODL please consider donating

Bitcoin:  13i3hFGN1RaQqdeWqmPTMuYEj9FiJWuMWf
Litecoin: LZqLoRNHvJyuKz99mNAgVUj6M8iyEQuio9