stonks-dashboard

JavaScript

A cyberpunk-style, real-time financial monitor that runs directly in the terminal. It visualizes cryptocurrency and stock market data using ASCII charts and dynamic coloring.

Last updated Jul 4, 2026

215

Stars

Forks

Issues

Stars/day

Attention Score

View on GitHub ↗ Open in github.dev

Topics

#cli #dashboard #data #finance #market #market-data #real-time #stocks #terminal #trading #tui

Language breakdown

No language data available.

▸ Files click to expand

README

Stonks Dashboard

Minimal real-time market dashboard for your terminal

Dashboard

Features

Watchlist: Crypto, stocks, ETFs in one view
Trend chart: Periods 1D, 7D, 30D, 90D
Details panel: Key metrics (price, change, highs/lows)
Caching & rate limits: Smooth updates with fewer API errors

Quick Start

npx stonks-dashboard

Or install globally:

npm install -g stonks-dashboard
stonks-dashboard

Local Development

git clone https://github.com/pierridotite/stonks-dashboard.git
cd stonks-dashboard
npm install
npm start

Controls

↑/↓: Navigate watchlist
1–4: Switch period (1D/7D/30D/90D)
q or Ctrl+C: Quit

Configuration

Edit config.json to customize:

{
  "tickers": ["BTC", "ETH", "AAPL", "TSLA"],
  "cryptoIds": { "BTC": "bitcoin", "ETH": "ethereum" },
  "updateInterval": 120000
}

NOTE: Stocks on the London Stock Exchange can be added by appending .L (e.g. BARC.L), they will be displayed in pounds or pence depending on whether they are above £1