GoldRush CLI
Quick Reference
| Item | Value |
|---|---|
| Install | npx @covalenthq/goldrush-cli |
| Authentication | goldrush auth (stores key in OS keychain) |
| MCP Setup | goldrush install (registers as tool for Claude) |
| Commands | 17 commands across portfolio, market, trading, and utilities |
| Chains | 100+ chains (same as Foundational API) |
| Streaming | Real-time data via Streaming API for new_pairs, ohlcv_pairs, watch |
GoldRush CLI is a terminal-first tool for blockchain data. 17 commands, 100+ chains, real-time streaming, and native MCP support for AI agents. One install, and you’ve got live onchain data in your terminal or piped directly into Claude.
Two Modes, Same Data
GoldRush CLI serves both humans and AI agents from a single tool:- Humans get a rich terminal experience with live charts, interactive tables, and formatted output.
- Agents get MCP tools with structured, streaming data via the Model Context Protocol.
What It Does
Seventeen commands across portfolio management, market discovery, trading intelligence, and agent integration. Portfolio & Wallets: Check token balances across 100+ chains, view transfer history, and stream real-time wallet activity. Commands:balances, transfers, watch
Market Discovery: Stream new DEX liquidity pairs as they launch and view live OHLCV candlestick charts in ASCII.
Commands: new_pairs, ohlcv_pairs
Trading Intelligence: Find top traders for any token, check real-time gas prices, and search tokens by name or address.
Commands: traders, gas, search
Agent Integration: Register GoldRush as an MCP tool provider for Claude in one command. Agents call GoldRush commands natively.
Commands: install, auth, config, status
MCP: Built for Agents
GoldRush CLI is an MCP server. When you rungoldrush install, it registers GoldRush as a tool provider for Claude. The agent can then call GoldRush commands the same way it calls any other tool - no wrappers, no glue code.
Three core loops define how agents use blockchain data:
- Continuous Market Monitoring - An agent subscribes to
new_pairsand receives every new liquidity pair in real time. It evaluates, filters, scores, and decides whether to act. - Wallet Surveillance - An agent watches specific wallets using
watch. Whale wallets, smart money, protocol treasuries. Every swap, transfer, and deposit surfaces in real time. - Portfolio Intelligence - An agent pulls
balanceson a schedule, analyzes composition across chains, evaluates concentration risk, and recommends rebalancing.
Get Started
CLI Quickstart
Three commands to go from zero to streaming blockchain data in your terminal.Prerequisites
Using GoldRush CLI requires an API key.Vibe Coders
$10/mo - Built for solo builders and AI-native workflows.Teams
$250/mo - Production-grade with 50 RPS and priority support.Install and Authenticate
Run the CLI withnpx - no global install needed:
goldrush directly without npx.
Query Wallet Balances
Get a full token portfolio for any address across 100+ chains:Stream New DEX Pairs
Watch new liquidity pairs launch in real time:Set Up MCP for AI Agents
Register GoldRush as a native tool provider for Claude:What’s Next
Command Reference
Full reference for all 17 CLI commands with usage examples.Streaming API
The real-time data layer that powersnew_pairs, ohlcv_pairs, and watch.
Command Reference
Portfolio & Wallets
goldrush balances
Full token portfolio across 100+ chains. ERC20s, native tokens, NFTs, USD values, and 24h changes.
goldrush transfers
Transfer history for any wallet - inbound, outbound, and token details.
goldrush watch
Real-time wallet activity streaming. Swaps, transfers, and deposits as they happen.
Market Discovery
goldrush new_pairs
Live stream of new DEX liquidity pairs as they’re created. Supports 35+ protocol integrations across 9 chains: Uniswap V2/V3, PancakeSwap, Raydium, Pump.fun, Moonshot, Meteora, Orca, Shadow, Clanker, Virtuals, nad.fun, and more.
goldrush ohlcv_pairs
Live OHLCV candlestick charts rendered in ASCII. Configurable intervals from 1 second to 1 day.
Trading Intelligence
goldrush traders
Top traders for any token, ranked by unrealized PnL. See who’s accumulating and who’s dumping.
goldrush gas
Real-time gas price estimates by transaction type.
goldrush search
Find any token by name, symbol, or contract address.
Utilities
| Command | Description |
|---|---|
goldrush chains | List every supported chain |
goldrush auth | Set your API key (stored in your OS keychain, not a config file) |
goldrush install | Configure Claude Desktop or Claude Code for MCP integration in one command |
goldrush config | View or update settings like proxy port, default chain, and quote currency |
goldrush status | Check API key validity and proxy connectivity |
goldrush logout | Clear API key and session data from your OS keychain |