Practical overview
When it fits
Use it when you want a command-line snapshot of configured holdings and market data rather than a graphical portfolio interface.
Who it is for
- People who want a terminal-based view of cryptocurrency holdings and estimated portfolio value.
- Users comfortable cloning a JavaScript repository and installing dependencies with npm.
Documented uses
- Record coin quantities in a local JSON portfolio file.
- Review portfolio value and each holding’s net worth.
- Compare allocation percentages in a horizontal bar graph.
- View coin rank, price, volume, market capitalization and recent percentage changes.
- Request data in a supported display currency.
Requirements & limits
- Holdings are configured locally in portfolio.json.
- Market data is fetched from CoinMarketCap.
- The README documents USD as the default and currency selection through -c or --currency.
- The repository identifies its license as MIT.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install the CLI and configure portfolio holdings
Set up the documented command-line app and enter asset quantities in its local portfolio file.
Before you start
- Git
- Node.js with npm
Steps
Clone the repository with the command below.
git clone https://github.com/christ0ph3r/cryptocurrency-cli/Enter the repository and install dependencies with
cd cryptocurrency-cli && npm install.Run the application with the command below.
npm startEdit
portfolio.jsonto specify cryptocurrency identifiers and quantities.
Expected outcome
A local portfolio configuration for the app to use when displaying holdings and market information.
Guide limitations
- The README does not describe validation rules for portfolio entries.
- Market data is fetched from the CoinMarketCap API; current API availability and behavior are not established.
Request portfolio values in another currency
Use a documented currency option when requesting market data and portfolio values.
Before you start
- The repository cloned and npm dependencies installed.
- A configured
portfolio.json.
Steps
From the repository, run the command below for EUR output or the command below for AUD output.
npm start -- -c eurnpm start -- -c audAlternatively, use the documented
--currencyoption in place of-c.
Expected outcome
The app requests crypto data and portfolio values in the selected supported currency.
Guide limitations
- The README lists supported currencies but does not establish the current availability or behavior of the external API.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 16 October 2026
- Original website title
- christ0ph3r/cryptocurrency-cli · Official homepage title · retained in its source language

