glassnode-terminal
v0.1.2
Published
Interactive TUI for exploring Glassnode on-chain and market crypto data
Maintainers
Readme
glassnode-terminal
Interactive terminal UI for exploring Glassnode on-chain and market crypto data. Browse assets, metrics, and data in a three-pane explorer with charts, live price tickers, and keyboard navigation.
Install
npm install -g glassnode-terminalNote: Requires Node.js >= 24 and system dependencies for node-canvas. On macOS:
brew install pkg-config cairo pango.
Quick Start
Run directly without installing:
GLASSNODE_API_KEY=your-key npx glassnode-terminalOr install globally and run:
export GLASSNODE_API_KEY=your-key
glassnode-terminalGet your API key at studio.glassnode.com/settings/api.
On first launch, the app fetches and caches all asset and metric metadata (this may take a minute). Subsequent launches load instantly from cache (~/.glassnode-terminal/cache/, 1-day TTL).
Features
- Three-pane explorer — browse assets, metrics, and data side by side
- Two browse modes — Asset → Metric or Metric → Asset (toggle with
m) - Live price ticker — WebSocket-powered prices for top assets in the header
- Charts — truecolor terminal charts via ink-uplot with dual Y-axes (metric + price overlay)
- Table view — toggle between chart and table with
v - Search/filter — press
/to filter assets or metrics - Parameter controls — cycle interval, time range, and currency with keyboard shortcuts
- Log view — press
lto see HTTP/WS request logs for debugging
Navigation
| Key | Action |
|-----|--------|
| Tab / Shift+Tab | Switch panes |
| ↑ / ↓ | Navigate within current pane |
| Shift+↑ / Shift+↓ | Page up / page down |
| ← / → | Previous pane / select item |
| Enter | Select item |
| / | Search/filter in current pane |
| Esc | Cancel search |
| m | Toggle browse mode (Asset → Metric / Metric → Asset) |
| i | Cycle interval (10m, 1h, 24h, 1w, 1month) |
| s | Cycle time range (1d, 7d, 30d, 90d, 1y, all) |
| c | Cycle currency (usd, native) |
| v | Toggle table / chart view |
| p | Toggle price overlay |
| l | Toggle log view |
| q | Quit |
Browse Modes
- Asset → Metric (default): Pick an asset, then browse its available metrics.
- Metric → Asset: Pick a metric, then see which assets support it.
Press m to toggle between modes.
Development
git clone https://github.com/planadecu/glassnode-terminal.git
cd glassnode-terminal
pnpm install
pnpm run build
GLASSNODE_API_KEY=your-key pnpm startLicense
MIT
