Skip to content

acrenwelge/crypto-cli

Repository files navigation

⚡️ Crypto CLI ⚡️

Ever felt the pressing need to lookup crypto data right from your shell? Now you can!

Installation

Note: requires Java 11+

# download the .jar file to a location on your $PATH
curl -L https://github.com/acrenwelge/crypto-cli/releases/download/v1.3/crypto-v1.3.jar > /usr/local/bin/crypto.jar
# setup crypto command
echo "alias crypto='java -jar /usr/local/bin/crypto.jar'" >> ~/.bashrc
source ~/.bashrc

Usage

Please note: there is currently a rate limit of 50 calls / minute for the free API being used

👀 Search for a crypto

crypto search bit

ℹ️ Lookup info on a cryptocurrency

crypto --coin bitcoin

💰 Get price info only

crypto price --coin bitcoin

💶 Get price info for multiple coins in multiple currencies

crypto price -c bitcoin -c ethereum -c litecoin -cur USD -cur EUR

📈 Get price history by day, week, or month

crypto history -c bitcoin -d 10 # past 10 days of bitcoin price
crypto history -c bitcoin -d 10 --graph # add a graph
crypto history -c bitcoin -w 5 # past 5 weeks of bitcoin price
crypto history -c bitcoin -m 3 # past 3 months of bitcoin price

📖 Get USD price of bitcoin on May 1, 2015

crypto price -c bitcoin --date 2015-05-01

⏱ Watch the price (default: refresh every 15 seconds)

crypto price -c bitcoin --watch
crypto price -c bitcoin -w -i 10 -s 1 # interval of 10 seconds, stop after 1 minute

% See price gains over time

crypto gains -c bitcoin 2020-01-01 2021-01-01

Config

The default coin and currency to use will be stored in $HOME/.crypto/defaults.properties. If this file exists, these values will be used unless overridden with command line arguments. If no file exists and no command line arguments are provided, the program reverts to bitcoin and USD defaults, respectively.

⚙️ Set default crypto and currency

crypto config -c bitcoin
crypto config -cur USD
crypto config # displays current defaults if no args set

Crypto coin must be its id. Currency must follow ISO 4217.

📝 List possible coin and currency values

crypto list coins
crypto list currencies

Caching

A list of coins to search will be cached in $HOME/.crypto/coins.json for quick searching and lookup. By default, a TTL value of 7 days will be used.

Complex Queries & Examples 🧐

# find the number of cryptocurrencies with the word "chain" in their name
crypto list coins | grep chain | wc -l

# store the price of bitcoin for the last year
crypto history -c bitcoin -d 365 > btc-prices-last-year.txt

Built with...

About

A command line tool for pulling crypto data

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages