🚀 CryptoInk

A beautiful terminal-based cryptocurrency and stock tracker built with React Ink.

✨ Features

Market Data

• 📊 Live Crypto Prices - Top 50 cryptocurrencies from Binance
• 📈 Stock Tracking - DAT (MSTR, COIN, MARA), MAG7 (AAPL, MSFT, GOOGL), AI stocks (PLTR, AI, SNOW)
• 💹 Fear & Greed Index - Real-time market sentiment
• 📉 BTC Dominance - Bitcoin market share
• 💰 24h Volume - Trading volume for each asset
• 🏦 Market Cap - From CoinGecko API

Charts

• 🕯️ Candlestick Charts - OHLC price visualization
• 📈 Line Charts - Braille-based high-resolution rendering
• ⏱️ Multiple Timeframes - 1H, 4H, 1D, 1W, 1M
• 📐 Log Scale - Toggle logarithmic price scaling
• 🖥️ Fullscreen Mode - Expand chart to full terminal

Portfolio

• 💼 Portfolio Tracker - Track holdings with P&L
• 📊 Value History - Daily portfolio value chart
• 🔔 Price Alerts - Get notified when price crosses target
• ⭐ Watchlist - Mark favorite assets

UI/UX

• 🎨 4 Themes - Cyber, Matrix, Sunset, Ocean
• 🔍 Fuzzy Search - Quick jump to any asset
• 📱 Responsive - Adapts to terminal size
• ⌨️ Keyboard Driven - Full keyboard navigation

📦 Installation

NPX (Easiest)

npx cryptoink

Quick Install (macOS/Linux)

curl -fsSL https://raw.githubusercontent.com/faisalnazir/cryptoink/main/install.sh | bash

Manual Install

Requires Bun runtime.

# Install Bun (if not installed)
curl -fsSL https://bun.sh/install | bash

# Clone the repo
git clone https://github.com/faisalnazir/cryptoink.git
cd cryptoink

# Install dependencies
bun install

# Run
bun start

# Or compile to binary
bun build src/cli.jsx --compile --outfile cryptoink
./cryptoink

⌨️ Keyboard Controls

Navigation

| Key | Action | |-----|--------| | ↑ ↓ | Navigate list | | ← → | Change timeframe | | Tab | Switch Crypto/Stocks/Portfolio | | / | Search (fuzzy match) | | Enter / Esc | Exit search |

Actions

| Key | Action | |-----|--------| | P | Add to portfolio (enter amount) | | B | Set buy price | | A | Set price alert | | V | View active alerts | | W | Toggle watchlist ⭐ | | U | Update to latest version |

Display

| Key | Action | |-----|--------| | C | Toggle Candlestick/Line chart | | L | Toggle Log scale | | S | Cycle sort (rank/price/change/volume/cap) | | T | Change theme | | F | Fullscreen chart | | M | Cycle minimal mode | | Q | Quit |

🔄 Update

Update to the latest version:

# From within the app
Press U

# Or manually
curl -fsSL https://raw.githubusercontent.com/faisalnazir/cryptoink/main/update.sh | bash

📁 Configuration

Data is stored in ~/.cryptoink/:

~/.cryptoink/
├── portfolio.json      # Your holdings
├── portfolio_history.json  # Daily value snapshots
├── alerts.json         # Price alerts
└── watchlist.json      # Starred assets

Portfolio Format

{
  "holdings": [
    { "symbol": "BTC", "amount": 0.5, "buyPrice": 42000 },
    { "symbol": "MSTR", "amount": 10, "buyPrice": 450, "isStock": true }
  ]
}

📡 Data Sources

| Data | Source | Rate Limit | |------|--------|------------| | Crypto Prices | Binance API | No key required | | Stock Prices | Yahoo Finance | No key required | | Market Cap | CoinGecko | No key required | | Fear & Greed | Alternative.me | No key required |

🛠️ Tech Stack

• Bun - JavaScript runtime & bundler
• React Ink - React for CLI
• yahoo-finance2 - Stock data

📸 Screenshots

Main View

━━ CRYPTO (RANK) ━━          ━━ STOCKS ━━
▶ ★BTC   $97,234  ▲ 2.34%    ━ DAT ━
  ETH    $3,456   ▼ 1.23%    ● MSTR  $380.50  ▲ 5.2%
  SOL    $198.45  ▲ 5.67%    ● COIN  $265.30  ▲ 3.1%
  ...                         ...

📊 BTC/USDT $97,234 ▲ 2.34%   1H 4H [1D] 1W 1M
$100k│████████████████████████████████████
 $95k│██████████  ████████████████████████
 $90k│████████████████████████████████████
     └────────────────────────────────────
▸ Low: $89,500 │ High: $100,200 │ 167 candles

● Live │ F&G: 72 │ BTC.D: 54.2%    /Search SSort

📄 License

MIT

🤝 Contributing

Pull requests welcome! Please open an issue first to discuss changes.

Made with ☕ and React Ink