https://github.com/pierridotite/stonks-dashboard

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.
https://github.com/pierridotite/stonks-dashboard

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

Last synced: 7 months ago
JSON representation

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.

• Host: GitHub
• URL: https://github.com/pierridotite/stonks-dashboard
• Owner: pierridotite
• License: mit
• Created: 2025-12-23T01:25:16.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-12-24T10:37:22.000Z (7 months ago)
• Last Synced: 2025-12-25T19:43:25.485Z (7 months ago)
• Topics: cli, dashboard, data, finance, market, market-data, real-time, stocks, terminal, trading, tui
• Language: JavaScript
• Homepage:
• Size: 268 KB
• Stars: 121
• Watchers: 2
• Forks: 11
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


 Stonks Dashboard 


[![GitHub stars](https://img.shields.io/github/stars/pierridotite/stonks-dashboard?style=social)](https://github.com/praffall/stonks-dashboard/stargazers)

[![npm version](https://img.shields.io/npm/v/stonks-dashboard.svg)](https://www.npmjs.com/package/stonks-dashboard)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)



**Minimal real-time market dashboard for your terminal**

![Dashboard](assets/dashboard.png)



---

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

```bash

npx stonks-dashboard

```

Or install globally:

```bash

npm install -g stonks-dashboard

stonks-dashboard

```

## Local Development

```bash

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:

```json

{

  "tickers": ["BTC", "ETH", "AAPL", "TSLA"],

  "cryptoIds": { "BTC": "bitcoin", "ETH": "ethereum" },

  "updateInterval": 120000

}

```

## Data Sources

- **Crypto:** CoinGecko API

- **Stocks/ETFs:** Yahoo Finance API

Requests are rate-limited and cached (`cache.json`). Crypto details cache ~30 min; price series cache ~1 min.

## Requirements

- Node.js (LTS recommended)

## License

MIT - See [LICENSE](LICENSE)

## Star History