Get the current Bitcoin value in command line
npm install --global btc-value-cli
$ btc-value --help
Usage
$ btc-value
Options
--key -k Set the API key (Obtain key at: https://coinmarketcap.com/api/)
--decimal -d Print value as decimal
--save -s [code] Set the currency that will be used by default
--currency -c [code] Print the value in another currency
--list -l Print a list of all supported currencies
--quantity -q [number] Print the value of the given quantity
--autorefresh -a [seconds] Automatic refresh printing every x seconds
--percentage -p [h|d|w] Print the percentage change (h = hour, d = day, w = week)
--reset -r Reset the configuration to the default
--provider [cmc|coingecko] Set the currency provider to retrieve Bitcoin values from
Examples
$ btc-value
$ btc-value -k <example-API-key>
$ btc-value -d
$ btc-value -s NOK
$ btc-value -c NOK
$ btc-value -q 2.2
$ btc-value -p h
$ btc-value --provider coingecko
Print the value as a decimal number.
Set the currency that will be used by default. It will save the new default currency code and symbol in the config.json file. Next time btc-value
is run in command line it will print the value of the new default currency.
Print the value in another currency. It will print out the value of the currency code. A list of all currency codes can be shown with the use of the -l
flag.
Print a list of all supported currencies for the selected currency provider.
Print the value of the given quantity. Input quantity can be either decimal
or integer
.
If the input quantity is set to a number, the given quantity is saved locally in the config.json file.
The -q
flag can be used with and without a number input.
Set a timeout that print the value every seconds
seconds. The timeout restarts after every use. If seconds
is not set, the default timeout is used (15 seconds). This is stored in the config.json file. The reason a timeout is used instead of a interval, is that it might not finish before the next starts (if bad network connection) and this can use more memory than needed.
Print the percentage change the last hour, day and week. If the flag is set to h
then percentage change last hour is printed. It is the same for d
and days, and w
and week.
If the percentage is negative it is printed in bright red otherwise it is printed in green.
Reset the configuration to the default:
{
default: 'USD',
quantity: 1,
autorefresh: 15,
apiKey: '',
provider: 'coingecko'
}
Set the currency provider to retrieve Bitcoin values from. By default it uses the data from CoinGecko.
Set the API key. This key is optional and only required if using data from the CoinMarketCap API. To obtain an API key go to the Cryptocurrency Market Capitalizations API.
- btc-value - API for this module