Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/netevert/hodl

Your friendly, no-nonsense tool to instantaneously check cryptocurrency prices, helping you HODL one day at a time :)
https://github.com/netevert/hodl

bitcoin bitcoin-api bitcoin-cash bitcoin-price coinbase command-line-tool conversion-rate cryptocoins cryptocurrencies dash ethereum exchange-rates hodl litecoin litecoin-price monero portfolio-holdings price-changes ripple zcash

Last synced: 4 months ago
JSON representation

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

Host: GitHub
URL: https://github.com/netevert/hodl
Owner: netevert
License: mit
Created: 2017-12-12T15:55:26.000Z (about 7 years ago)
Default Branch: master
Last Pushed: 2018-03-12T14:32:06.000Z (almost 7 years ago)
Last Synced: 2024-10-11T09:21:31.620Z (4 months ago)
Topics: bitcoin, bitcoin-api, bitcoin-cash, bitcoin-price, coinbase, command-line-tool, conversion-rate, cryptocoins, cryptocurrencies, dash, ethereum, exchange-rates, hodl, litecoin, litecoin-price, monero, portfolio-holdings, price-changes, ripple, zcash
Language: Python
Homepage: https://pypi.org/project/hodl/
Size: 442 KB
Stars: 10
Watchers: 3
Forks: 3
Open Issues: 16
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        ![Icon](https://github.com/netevert/hodl/blob/dev/docs/icon_2.png)

==================================================================

[![Maintenance](https://img.shields.io/maintenance/yes/2018.svg)]()

[![PyPI](https://img.shields.io/pypi/v/hodl.svg)](https://pypi.python.org/pypi/hodl)

[![PyPI](https://img.shields.io/pypi/status/hodl.svg)](https://pypi.python.org/pypi/hodl)

[![PyPI](https://img.shields.io/pypi/pyversions/hodl.svg)](https://pypi.python.org/pypi/hodl)

[![Build Status](https://travis-ci.org/netevert/hodl.svg?branch=master)](https://travis-ci.org/netevert/hodl)

[![Coverage Status](https://coveralls.io/repos/github/netevert/hodl/badge.svg?branch=master)](https://coveralls.io/github/netevert/hodl?branch=master)

[![Donations](https://img.shields.io/badge/donate-bitcoin-orange.svg?logo=bitcoin)](https://github.com/netevert/hodl/blob/master/README.md#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](https://github.com/netevert/hodl/blob/master/docs/demo.gif)

Installation

============

To install HODL run:

    pip install hodl

Features

========

Currencies supported:

- Bitcoin ([BTC](https://bitcoin.org/en/))

- Bitcoin Cash ([BCH](https://www.bitcoincash.org/))

- Ethereum ([ETH](https://www.ethereum.org/))

- Litecoin ([LTC](https://litecoin.com/))

- Monero ([XMR](https://getmonero.org/))

- Ripple ([XRP](https://ripple.com/))

- Dash ([DASH](https://www.dash.org/))

- Zcash ([ZEC](https://z.cash/))

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](https://github.com/errantbot/hodl/issues)

to check what\'s in the development pipeline.

Bugs/Requests/Contributing

==========================

Please use the [GitHub issue tracker](https://github.com/netevert/hodl/issues) to submit bugs or request

features.

To contribute please consult the [contribution guide](https://github.com/netevert/hodl/blob/master/CONTRIBUTING.md).

License

=======

Distributed under the terms of the [MIT](http://www.linfo.org/mitlicense.html) license, HODL is free and open

source software.

Versioning

==========

This project adheres to [Semantic Versioning](https://semver.org/).

Donations

=========

If you like HODL please consider donating



    

    Bitcoin:  13i3hFGN1RaQqdeWqmPTMuYEj9FiJWuMWf

    Litecoin: LZqLoRNHvJyuKz99mNAgVUj6M8iyEQuio9