crypto-terminal

A free, Bloomberg-style crypto terminal that runs in your shell. Live spot prices stream straight from the Coinbase Exchange public websocket: no API key, no account, no polling. Candlestick charts with a live last bar, indicators, price alerts, and search across every Coinbase pair.

Install

Requires Python 3.10+.

pipx install crypto-terminal
crypto-terminal

Or pip install crypto-terminal into any virtualenv.

Features

• Live watchlist: last price, 24h change, and a sparkline of recent ticks. Prices flash green/red on every up/down tick.
• Candlestick chart for the highlighted pair, with volume underneath. Six timeframes (1m to 1d candles). The last candle follows the live price and a new one opens at each candle boundary.
• Indicators: SMA 20, EMA 50 and VWAP (resets at the UTC day) over the candles, RSI 14 in its own panel.
• Coin search: add solana lists every online Solana pair (USD, USDC, USDT, EUR, GBP and BTC quotes first). Exact pairs like add SOL-BTC add directly. Sub-cent and BTC-quoted prices keep 5 significant figures.
• Price alerts: on a level (> / <) or a percentage move. A firing alert rings the terminal bell, shows a toast, and sends a desktop notification (macOS, or Linux with notify-send). Pairs with an alert carry a 🔔.
• Status line: connection state, time since the last tick, UTC clock. Shows STALE after 10s without data and reconnects automatically with exponential backoff.

Default pairs: BTC-USD, ETH-USD, XRP-USD, SOL-USD, ADA-USD.

How live is it?

Measured on the five default pairs over 60s:

Coinbase pushes an update on every trade (bursts are batched); nothing is polled. A heartbeat arrives every second, so a dead connection is spotted and replaced within seconds. The chart redraws at most twice a second.

Keys

Commands

Alerts fire once and are then removed. The watchlist, indicators and alerts are saved in ~/.config/crypto-terminal/ (or $XDG_CONFIG_HOME/crypto-terminal/).

From source

git clone https://github.com/owen-alderson/crypto-terminal.git
cd crypto-terminal
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python -m crypto_terminal

Architecture

crypto_terminal/
  feed.py        websocket client: subscribes to ticker + heartbeat, validates each message,
                 reconnects with exponential backoff (1s → 30s); 30s of silence = dead socket
  history.py     REST: candles, the product list for search, the live-candle update
  indicators.py  SMA, EMA, RSI, VWAP as pure functions
  alerts.py      alert rules, trigger check, desktop notification
  widgets.py     PriceTable (watchlist), ChartPane (textual-plotext), PairPicker (search results)
  app.py         Textual app: layout, command parsing, saved config, status line
tests/           pytest: parsing, indicators against reference values, search, alerts, reconnect
                 against a local websocket server, headless UI tests with Textual's Pilot (no internet)

The feed, the chart fetch and the product list run as Textual async workers. Changing the watchlist restarts the feed worker, and a new chart request cancels the previous one so a slow response can't draw the wrong pair.

Tests

pytest

History

This repo started as a Streamlit + CoinGecko portfolio dashboard that polled every 60s. That version is preserved at the v1-streamlit tag (git checkout v1-streamlit).

License

MIT, see LICENSE. Provided as is, with no warranty: this is a market-data viewer, not financial advice.