crypto-terminal 2.0.0__tar.gz

crypto_terminal-2.0.0/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.pyc
+.DS_Store
+venv/
+.venv/
+watchlist.json
+dist/

crypto_terminal-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Owen Alderson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

crypto_terminal-2.0.0/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.5
+Name: crypto-terminal
+Version: 2.0.0
+Summary: A free, Bloomberg-style crypto terminal for your shell: live Coinbase prices, candles, indicators and alerts.
+Project-URL: Homepage, https://github.com/owen-alderson/crypto-terminal
+Author: Owen Alderson
+License-Expression: MIT
+License-File: LICENSE
+Keywords: bitcoin,coinbase,crypto,terminal,textual,tui
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.10
+Requires-Dist: certifi
+Requires-Dist: httpx>=0.27
+Requires-Dist: textual-plotext>=1.0
+Requires-Dist: textual>=8.0
+Requires-Dist: websockets>=14.0
+Description-Content-Type: text/markdown
+
+# 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.
+
+![Crypto terminal demo: live candles, indicators, coin search and a price alert](https://raw.githubusercontent.com/owen-alderson/crypto-terminal/main/docs/demo.gif)
+
+![Textual](https://img.shields.io/badge/built%20with-Textual-ffb000) ![Coinbase](https://img.shields.io/badge/data-Coinbase%20Exchange-0052FF)
+
+## Install
+
+Requires Python 3.10+.
+
+```bash
+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:
+
+| | Quiet (Sunday) | Busy |
+|---|---|---|
+| Price updates | ~5.5 / s | ~12 / s |
+| Bandwidth | ~0.02 Mbps | ~0.04 Mbps |
+
+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
+
+| Key | Action |
+|---|---|
+| `↑` `↓` | Select pair (chart follows) |
+| `1` – `6` | Candles: 1m, 5m, 15m, 1h, 6h, 1d |
+| `/` or `:` | Open command bar (`esc` closes it) |
+| `ctrl+q` | Quit |
+
+## Commands
+
+| Command | Effect |
+|---|---|
+| `add SOL-USD` | Add a pair |
+| `add sol` / `add solana` | Search by symbol or name: pick with `↑` `↓`, `enter` adds, `esc` cancels |
+| `rm ADA-USD` | Remove a pair |
+| `ind sma20 ema50 vwap rsi` | Toggle indicators (any subset) |
+| `ind off` | Clear all indicators |
+| `alert BTC-USD > 90000` | Alert when the price reaches 90,000 or more (`<` for at or below) |
+| `alert BTC-USD move 5%` | Alert on a ±5% move from the current price |
+| `alerts` | List alerts with their numbers |
+| `unalert 2` | Remove alert 2 |
+| `quit` | Exit |
+
+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
+
+```bash
+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
+
+```bash
+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](LICENSE). Provided as is, with no warranty: this is a market-data viewer, not financial advice.

crypto_terminal-2.0.0/README.md

@@ -0,0 +1,108 @@
+# 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.
+
+![Crypto terminal demo: live candles, indicators, coin search and a price alert](https://raw.githubusercontent.com/owen-alderson/crypto-terminal/main/docs/demo.gif)
+
+![Textual](https://img.shields.io/badge/built%20with-Textual-ffb000) ![Coinbase](https://img.shields.io/badge/data-Coinbase%20Exchange-0052FF)
+
+## Install
+
+Requires Python 3.10+.
+
+```bash
+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:
+
+| | Quiet (Sunday) | Busy |
+|---|---|---|
+| Price updates | ~5.5 / s | ~12 / s |
+| Bandwidth | ~0.02 Mbps | ~0.04 Mbps |
+
+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
+
+| Key | Action |
+|---|---|
+| `↑` `↓` | Select pair (chart follows) |
+| `1` – `6` | Candles: 1m, 5m, 15m, 1h, 6h, 1d |
+| `/` or `:` | Open command bar (`esc` closes it) |
+| `ctrl+q` | Quit |
+
+## Commands
+
+| Command | Effect |
+|---|---|
+| `add SOL-USD` | Add a pair |
+| `add sol` / `add solana` | Search by symbol or name: pick with `↑` `↓`, `enter` adds, `esc` cancels |
+| `rm ADA-USD` | Remove a pair |
+| `ind sma20 ema50 vwap rsi` | Toggle indicators (any subset) |
+| `ind off` | Clear all indicators |
+| `alert BTC-USD > 90000` | Alert when the price reaches 90,000 or more (`<` for at or below) |
+| `alert BTC-USD move 5%` | Alert on a ±5% move from the current price |
+| `alerts` | List alerts with their numbers |
+| `unalert 2` | Remove alert 2 |
+| `quit` | Exit |
+
+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
+
+```bash
+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
+
+```bash
+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](LICENSE). Provided as is, with no warranty: this is a market-data viewer, not financial advice.

crypto_terminal-2.0.0/crypto_terminal/__main__.py

@@ -0,0 +1,9 @@
+from .app import TerminalApp
+
+
+def main():
+    TerminalApp().run()
+
+
+if __name__ == "__main__":
+    main()

crypto_terminal-2.0.0/crypto_terminal/alerts.py

@@ -0,0 +1,68 @@
+"""Price alerts: fire once when a pair reaches a level or moves a percentage from where the alert was set."""
+
+import math
+import shutil
+import subprocess
+import sys
+from dataclasses import dataclass
+
+from .history import SYMBOL_RE
+from .widgets import fmt_price
+
+KINDS = (">", "<", "move")
+
+
+@dataclass(frozen=True)
+class Alert:
+    symbol: str
+    kind: str  # one of KINDS
+    level: float  # price for > and <, percent for move
+    ref: float | None = None  # move only: the price when the alert was set
+
+    def __str__(self):
+        if self.kind == "move":
+            return f"{self.symbol} moves ±{self.level:g}% from {fmt_price(self.ref)}"
+        return f"{self.symbol} {self.kind} {fmt_price(self.level)}"
+
+
+def valid_level(kind: str, level: float) -> bool:
+    # chained comparisons reject NaN, inf, zero and negatives
+    return 0 < level < (100 if kind == "move" else math.inf)
+
+
+def valid_alert(alert: Alert) -> bool:
+    """Full check for alerts read back from disk (the file is user-editable)."""
+    return (isinstance(alert.symbol, str) and bool(SYMBOL_RE.fullmatch(alert.symbol)) and alert.kind in KINDS
+            and valid_level(alert.kind, alert.level)
+            and (alert.kind != "move" or (alert.ref is not None and 0 < alert.ref < math.inf)))
+
+
+def triggered(alert: Alert, price: float) -> bool:
+    if alert.kind == ">":
+        return price >= alert.level
+    if alert.kind == "<":
+        return price <= alert.level
+    return abs(price - alert.ref) / alert.ref * 100 >= alert.level
+
+
+def check(alerts: list[Alert], symbol: str, price: float) -> tuple[list[Alert], list[Alert]]:
+    """Split alerts into (fired, remaining) for one tick."""
+    fired = [a for a in alerts if a.symbol == symbol and triggered(a, price)]
+    return fired, [a for a in alerts if a not in fired]
+
+
+def desktop_notify(title: str, message: str):
+    """Best effort: osascript on macOS, notify-send on Linux, silently skipped if neither exists."""
+    if sys.platform == "darwin" and shutil.which("osascript"):
+        # text goes in as argv, never spliced into the script, so it can't inject AppleScript
+        args = ["osascript", "-e", "on run argv", "-e",
+                "display notification (item 2 of argv) with title (item 1 of argv)",
+                "-e", "end run", title, message]
+    elif shutil.which("notify-send"):
+        args = ["notify-send", "--", title, message]
+    else:
+        return
+    try:
+        subprocess.Popen(args, stdin=subprocess.DEVNULL, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+    except OSError:
+        pass