🚀 CryptoInk

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

!CryptoInk Screenshot

!CryptoInk
!Bun
!License

✨ Features

$3

- 📊 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

$3

- 🕯️ 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

$3

- 💼 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

$3

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

📦 Installation

$3

``bash
npx cryptoink
`

$3

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

$3

Requires Bun runtime.

`bash


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

$3

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

$3

| 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 |

$3

| 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:
`bash


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
`

$3

`json
{
"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

$3


`
━━ 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