{"id":13587543,"url":"https://github.com/8go/coinbash","last_synced_at":"2025-10-06T13:45:07.389Z","repository":{"id":27247028,"uuid":"113042800","full_name":"8go/coinbash","owner":"8go","description":"💰 A bash script (CLI) for displaying crypto currencies market data in a terminal 🖥","archived":false,"fork":false,"pushed_at":"2022-05-17T17:15:47.000Z","size":540,"stargazers_count":132,"open_issues_count":2,"forks_count":24,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-11-06T06:41:07.406Z","etag":null,"topics":["bash","bash-script","bitcoin","btc","cli","command-line","command-line-tool","console-tool","crypto","crypto-currency","cryptocurrencies","cryptocurrency","ethereum","market-data","marketcap","price-ticker","price-tracker","terminal-based","ticker"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/8go.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-12-04T12:58:24.000Z","updated_at":"2024-10-23T12:10:50.000Z","dependencies_parsed_at":"2022-08-28T23:23:53.749Z","dependency_job_id":null,"html_url":"https://github.com/8go/coinbash","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8go%2Fcoinbash","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8go%2Fcoinbash/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8go%2Fcoinbash/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8go%2Fcoinbash/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/8go","download_url":"https://codeload.github.com/8go/coinbash/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230636274,"owners_count":18257150,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","bash-script","bitcoin","btc","cli","command-line","command-line-tool","console-tool","crypto","crypto-currency","cryptocurrencies","cryptocurrency","ethereum","market-data","marketcap","price-ticker","price-tracker","terminal-based","ticker"],"created_at":"2024-08-01T15:06:15.529Z","updated_at":"2025-10-06T13:45:02.332Z","avatar_url":"https://github.com/8go.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"![coinbash.sh logo](https://raw.githubusercontent.com/8go/coinbash/master/coinbash-logo.png)\n\n\n# 💰 A bash script (CLI) for displaying crypto currencies market data in a terminal 🖥\n\n## Alternative Scripts\n\n- If you are solely interested in Bitcoin, there is a Bitcoin specific script here: [btc.sh](https://github.com/8go/matrix-eno-bot/blob/master/eno/scripts/btc.sh) in directory [scripts](https://github.com/8go/matrix-eno-bot/tree/master/eno/scripts).\n- Same for Ethereum. If you are only interested in Ethereum, there is a simple Ethereum specific script here: [eth.sh](https://github.com/8go/matrix-eno-bot/blob/master/eno/scripts/eth.sh) in directory [scripts](https://github.com/8go/matrix-eno-bot/tree/master/eno/scripts).\n- If you need more than Bitcoin and Ethereum, then use `coinbash`. :+1:\n\n## Summary of `coinbash`\n\n* Check cryptocurrencies' prices, price changes, market cap, trading volume and more on your console.\n* Simple and easy CLI tool for those who are both **Crypto investors** and **Engineers**. \n  Ideal for anyone who likes the terminal.\n* A single-file bash script. There is only `coinbash.sh`. There are no config files or any other files.\n* CLI only. No fancy graphics, no windows.\n* Tested on Debian and Ubuntu\n* Dependencies: bash, curl, jq, coinmarketcap-API-key\n* Uses cloud API of https://pro-api.coinmarketcap.com/v1\n* **YOU MUST HAVE YOUR OWN coinmarketcap-API-key**\n  * Without your API key it will *not* work\n  * As of Oct 2020 you can get an API key for *free* at https://coinmarketcap.com\n  * Set the global environment variable `COINMARKETCAP_API_KEY` to your personal coinmarketcap-API-key,\n  * e.g by placing a line like this into your `.bashrc` file \n    * `export COINMARKETCAP_API_KEY=\"your-coinmarketcap-API-key-here\"`\n* Keywords: CLI, command-line, terminal, bash, market-data, ticker, price-tracker, marketcap, crypto, crypto currencies, cryptocurrency, bitcoin, btc, ethereum\n* License: [GPL v3](https://www.gnu.org/licenses/gpl-3.0.en.html)\n* Inspired by [https://github.com/bichenkk/coinmon](https://github.com/bichenkk/coinmon)\n\n\n## Install\n\nThere is no install. Download the release. Copy the single bash file `coinbash.sh` wherever you want, preferably some directory included in your `PATH`.\nIf not already installed and only on the first run, `coinbash.sh` will install the small packages `curl` and `ql`. Set the environment variable `COINMARKETCAP_API_KEY` to your personal coinmarketcap-API-key. Ready to go!\n\n## Build\n\nThere is nothing to build or compile. Just download the release. And run the `coinbash.sh` bash script.\n\n## Development\n\nYou are welcome to fork your own or contribute by providing a Pull Request.\n\n## Usage\n\nTo get the basic information on the top 10 cryptocurrencies ranked by their market cap, simply enter\n```\n$ coinbash.sh\n```\n\n## Options\n\nThere are many options. Please run `coinbash.sh --help` to see them all. \nYou can use the `-f` (or `--fiat`) followed by a currency symbol to get the prices in your local currency, crypto, or metal ounces.\n* The default currency is USD.\n* It supports crypto currencies: BTC, ETH, USDT, XRP, BCH, BNB, DOT, LINK, CRO, BSV, LTC. \n* It supports metals: XAU, XAG, XPT, XPD. \n* It supports local FIAT currencies: AUD, BRL, CAD, CHF, CLP, CNY, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, JPY,  KRW, MXN, MYR, NOK, NZD, PHP, PKR, PLN, RUB, SEK, SGD, THB, TRY, TWD, ZAR. \n\n```\n$ coinbash.sh -f BTC # get prices in BTC (Bitcoin)\n$ coinbash.sh -f AUD # get prices in Australian Dollars\n$ coinbash.sh -f XAU # get prices in Gold ounces\n```\n\n`-e` or `--eur` is a shortcut for Euros, a shortcut for `-f EUR`. \n\n```\n$ coinbash.sh -e # get prices in Euros\n```\n\nUse `-n` or `--top` followed by a number to get the top _n_ crypto currencies, ranked by their market cap. \n\n```\n$ coinbash.sh -n 12 # get information on the top 12 crypto currencies\n```\n\nYou can use the `-l` (or `--listbysymbols`) with coin symbol to search cryptocurrencies by their symbols. Add symbols seperated by commas. \n\n```\n$ coinbash.sh -l btc,eth,ltc # get information for Bitcoin (BTC), Ethereum (ETH) and Litecoin (LTC)\n```\n\nYou can use the `-i` (or `--listbynames`) with coin name to search cryptocurrencies by their names. Add names seperated by commas.\n\n```\n$ coinbash.sh -i bitcoin-cash,ethereum-classic # lists Bitcoin Cash (BCH) and Ethereum Classic (ETC)\n```\n\nYou can use the `-h` (or `--help`) to get help and to see all available options as well as examples.\n\n```\n$ coinbash.sh -h # get help\n```\n\nHelp returns the following\n```\ncoinbash.sh: Usage: coinbash.sh [--help] [--debug] [--version] [--verbose] [--torify]\ncoinbash.sh:                    [--top \u003cNUMBER\u003e]  [--depth \u003cNUMBER\u003e] \ncoinbash.sh:                    [--listbysymbols \u003cCRYPTO1SYMBOL,CRYPTO2SYMBOL,ETC\u003e]\ncoinbash.sh:                    [--listbynames \u003cCRYPTO1NAME,CRYPTO2NAME,ETC\u003e]\ncoinbash.sh:                    [--eur] [--fiat \u003cCURRENCY\u003e]\ncoinbash.sh:        coinbash.sh --cleanup \ncoinbash.sh: Version: 2020-OCT-03\ncoinbash.sh: License: GPL v3 https://www.gnu.org/licenses/gpl-3.0.en.html\ncoinbash.sh: Source: https://github.com/8go/coinbash\ncoinbash.sh: coinbash.sh requests data from www.coinmarketcap.com and lists market info on \ncoinbash.sh:          the most valuable crypto currencies.\ncoinbash.sh: If necessary it installs packages jq and curl.\ncoinbash.sh: Inspiration and basic idea from https://github.com/bichenkk/coinmon\ncoinbash.sh: Real-time market data from https://www.coinmarketcap.com\ncoinbash.sh: The default currency is USD and it supports BTC, ETH, USDT, XRP, BCH, BNB, DOT, \ncoinbash.sh:          LINK, CRO, BSV, LTC, XAU, XAG, XPT, XPD, AUD, BRL, CAD, CHF, CLP, CNY, CZK, \ncoinbash.sh:          DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, JPY, KRW, MXN, MYR, NOK, NZD, \ncoinbash.sh:          PHP, PKR, PLN, RUB, SEK, SGD, THB, TRY, TWD, ZAR.\ncoinbash.sh: coinbash.sh uses a temporary file /tmp/coinbash.sh.tmp.json which gets automatically removed.\ncoinbash.sh: Example: coinbash.sh       ...  prints top 10 crypto currencies, \ncoinbash.sh:                              uses default USD for prices\ncoinbash.sh: Example: coinbash.sh -n 3  ...  prints market info of top 3 crypto currencies, \ncoinbash.sh:                              uses USD for prices\ncoinbash.sh: Example: coinbash.sh -t -n 5  ...  uses Tor onion network, prints market info of \ncoinbash.sh:                              top 5 crypto currencies, uses USD for prices\ncoinbash.sh: Example: coinbash.sh -t -n 7 -e ...  uses Tor, prints market info of top 7 crypto currencies, \ncoinbash.sh:                              uses EUR for prices\ncoinbash.sh: Example: coinbash.sh -e  ...  shortcut for -f EUR, uses Euro for prices\ncoinbash.sh: Example: coinbash.sh -f BTC  ...  gives prices in Bitcoin (BTC)\ncoinbash.sh: Example: coinbash.sh -f XAU  ...  gives prices in Gold Troy ounces (XAU)\ncoinbash.sh: Example: coinbash.sh -f AUD  ...  gives prices in Australian Dollars (AUD)\ncoinbash.sh: Example: coinbash.sh -l btc  ...  lists only BTC\ncoinbash.sh: Example: coinbash.sh -l btc,eth,ltc  ...  lists BTC, ETH and LTC \ncoinbash.sh:                              (by default searches are limited to the top 100 crypto currencies)\ncoinbash.sh: Example: coinbash.sh -l btc,eth,rev -p 1000  ...  lists BTC, ETH and REV \ncoinbash.sh:                              (searches in the top 1000 crypto currencies)\ncoinbash.sh: Example: coinbash.sh -t -f EUR -l btc,sc,btcd -p 100  ...  lists BTC, SC and BTCD \ncoinbash.sh:                              by searching in the top 100 crypto currencies,\ncoinbash.sh:                              communicates via Tor and uses Euros for prices\ncoinbash.sh: Example: coinbash.sh -t -f EUR -i bitcoin-cash, ethereum-classic  ...  lists BCH and ETC \ncoinbash.sh:                              by searching all crypto currencies,\ncoinbash.sh:                              communicates via Tor and uses Euros for prices\ncoinbash.sh: Arguments are:\ncoinbash.sh: --help, -h\ncoinbash.sh:    HELP: Prints the help text and exits. [type: flag]\ncoinbash.sh: --version, -v\ncoinbash.sh:    VERSION: Same as --help [type: flag]\ncoinbash.sh: --debug, -d\ncoinbash.sh:    DEBUG: Turns debug output on, default is off [type: flag]\ncoinbash.sh: --cleanup, -c\ncoinbash.sh:    DO-ONLY-CLEANUP: Performs only cleanup, then exits [type: flag]\ncoinbash.sh: --torify, -t\ncoinbash.sh:    TORIFY: Request the data via Tor onion network [type: flag]\ncoinbash.sh:    This was disabled in latest version of Coinmarketcap.com API.\ncoinbash.sh: --top, -n\ncoinbash.sh:    TOP: How many crypto currencies should be displayed [type: integer] [default: 10]\ncoinbash.sh: --fiat, -f\ncoinbash.sh:    FIAT: Specify fiat currency for prices [type: string] [default: USD]\ncoinbash.sh: --eur, -e\ncoinbash.sh:    EUR: Use EUR as fiat currency instead of default USD, shortcut for -f EUR [type: flag]\ncoinbash.sh: --listbysymbols, -l\ncoinbash.sh:    LIST-BY-SYMBOLS: List of crypto currencies to display, \ncoinbash.sh:    comma-separated space-less string of symbols like \"btc,eth,ltc\" [type: string]\ncoinbash.sh:    If option -l is used then options -n and -i should not be used.\ncoinbash.sh: --listbynames, -i\ncoinbash.sh:    LIST-BY-NAMES: List of crypto currencies to display, comma-separated \ncoinbash.sh:    space-less string of names like \"bitcoin-cash,ethereum-classic\" [type: string]\ncoinbash.sh:    If option -i is used then options -n, -p and -l should not be used.\ncoinbash.sh: --depth, -p\ncoinbash.sh:    DEPTH: When listing by symbols (-l) search the top \"depth\" \ncoinbash.sh:    crypto currencies for the symbols [type: integer] [default: 100]\ncoinbash.sh:    The larger the value for -p the longer execution will take.\ncoinbash.sh: --verbose, -w\ncoinbash.sh:    VERBOSE: Verbose listing of information including supply data, etc. [type: flag]\n```\n\n## Screenshots\n\n![screenshot 1](https://raw.githubusercontent.com/8go/coinbash/master/coinbash-screenshot.png)\n\n![screenshot 2](https://raw.githubusercontent.com/8go/coinbash/master/coinbash-screenshot-top12.png)\n\n![screenshot 3](https://raw.githubusercontent.com/8go/coinbash/master/coinbash-screenshot-listbysymbols.png)\n\n![screenshot 4](https://raw.githubusercontent.com/8go/coinbash/master/coinbash-screenshot-listbynames.png)\n\n![screenshot 5](https://raw.githubusercontent.com/8go/coinbash/master/coinbash-screenshot-all.png)\n\n## Enjoy!\n\nBuilt with :heart: for your enjoyment!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F8go%2Fcoinbash","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F8go%2Fcoinbash","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F8go%2Fcoinbash/lists"}