coinkiko
v1.0.0
Published
Cryptocurrency tracker TUI — top 100 coins by market cap with sparklines, watchlist, and search
Maintainers
Readme
CoinKiko - Cryptocurrency Terminal Tracker
A terminal UI for tracking the top 100 cryptocurrencies by market cap, with sparklines, watchlist, and search.
Install
npm install -g coinkikoUsage
ckOr run locally without installing:
npx coinkikoAPI Key (Optional)
CoinKiko works without an API key using CoinGecko's free tier. For higher rate limits, save your own CoinGecko API key:
ck --api-key=YOUR_COINGECKO_KEYThe key is stored in ~/.coinkiko/config.json and used for all future runs.
Keyboard Controls
| Key | Action | |-----|--------| | Up/k, Down/j | Navigate the list | | Enter | Open detail view | | S | Star/unstar a coin | | W | Toggle watchlist mode | | / or F | Search | | R | Refresh data | | Q / Ctrl-C | Quit | | Esc | Close search/detail view |
Features
- Top 100 coins by market cap from CoinGecko
- 7-day sparkline trend per coin (color-coded green/red)
- Star coins and toggle watchlist mode
- Search/filter by name, symbol, or ID
- Detail view with price info, supply stats, ATH/ATL, and a 7-day chart
- Auto-refresh every 60 seconds
- Favorites and config persisted in
~/.coinkiko/
Main Table Columns
Rank, Star, Name, Symbol, Price, Market Cap, Volume, 24h Change, 7-Day Trend
Detail View
- Price, market cap, 24h volume and change
- 24h high/low
- ATH and ATL with dates and % change
- Circulating and total supply
- Interactive 7-day price chart
Tech Stack
- blessed + blessed-contrib - terminal UI framework
- axios - HTTP client for CoinGecko API
- sparkline - Unicode sparkline rendering
License
MIT
