CLAWD / DARK RALPH

Solana market surveillance from your terminal.

Dark Ralph is a Bun + Ink terminal app for live Solana market views, wallet context, provider-backed research, and autonomous agent analysis.

Install Dark Ralph Read Docs
MAWD Market View 
┌──────────────────────────────────────────────────────────────────────────────┐
└─CLAWD │ MARKET VIEW────────────────────────────Uptime: 00:04:35 │ 8:36 AM──┘
┌──────────────────────────────────────────────────────────────────────────────┐
└─SOL $150.25 +2.34% │ BONK $0.00002345 +5.67% │ WIF $2.85 -1.20% │ JUP +3.80%┘

 ┌──────────────────────────────────────────────┐  ┌──────────────────────────┐
 │ SOL/USDC │ 1H              $132.97 (-11.36%)│  │ ORDER BOOK       SOL/USDC │
 │ 152.42  ██  ││││                           │  │ DEPTH    PRICE      SIZE  │
 │ VOL▁▃▄▄▃▂▂▃▃▃▁▃▃▄▃▂▃▂▄▂▃▃▃▂▂▃▂▂▄▃▁▂▂▃▁   │  │ SPREAD: 0.0405          │
 └──────────────────────────────────────────────┘  └──────────────────────────┘

 ┌──────────────────────┐ ┌──────────────────────┐ ┌──────────────────────────┐
 │ MARKET HEATMAP       │ │ TOP MOVERS           │ │ LIVE FEED          LIVE  │
 │ SOL BONK WIF JUP     │ │ BONK +15.3%          │ │ 5,000 SOL to exchange    │
 │ RAY ORCA MNGO SAMO   │ │ MNGO -12.5%          │ │ BONK divergence          │
 └──────────────────────┘ └──────────────────────┘ └──────────────────────────┘

Install And Start

curl -fsSL https://install.solanaclawd.com | bash
ralph

The installer detects macOS/Linux architecture, installs the Clawd command set into ~/.local/bin, and creates shared config at ~/.clawd/config.env.

export PATH="$HOME/.local/bin:$PATH"
ralph

Features

MAWD Market View

Live ticker tape, chart, order book, heatmap, top movers, live feed, network stats, and activity stream.

Agent Loop

RalphAgent supports autonomous and interactive modes with recursive market thoughts and command handling.

Provider Context

Connect Helius, Birdeye, xAI Grok, Perplexity, OpenRouter, News API, SERP API, and Financial Datasets.

Local Development

cd dark-ralph
bun install
cp .env.example .env
bun run run

TUI

bun run run
bun run src/cli.tsx run --interactive

Daemon

bun run src/cli.tsx run --headless

Wallet

bun run wallet -- --create
bun run wallet -- --balance

Configuration

Dark Ralph starts without every key configured. Missing providers appear disconnected and dependent commands fail closed.

HELIUS_API_KEY=
BIRDEYE_API_KEY=
XAI_API_KEY=
PERPLEXITY_API_KEY=
OPENROUTER_API_KEY=