goldrush-cli
GoldRush CLI
Terminal-first blockchain data tool with MCP support for AI agents. Query wallets, stream DEX pairs, and pipe live on-chain data directly into Claude — all from the command line.
Quick Start
# Install and authenticate
npx @covalenthq/goldrush-cli auth
# Query wallet balances
goldrush balances eth-mainnet vitalik.eth
# Stream new DEX pairs
goldrush new_pairs solana-mainnet raydium
# Set up MCP for Claude
goldrush install
Commands
Commands span portfolio management, market discovery, trading intelligence, and utilities. For the full reference with all parameters and examples, see overview.md.
Portfolio & Wallets
goldrush balances <chain> <address>— full token portfolio with USD values and 24h changesgoldrush transfers <address> <chain>— transfer history for any walletgoldrush watch <address> <chain>— real-time wallet activity streaming
Market Discovery
goldrush new_pairs <chain> [protocols...]— live stream of new DEX liquidity pairsgoldrush ohlcv_pairs <pair> <chain> [-i interval]— live OHLCV candlestick charts in ASCII
Trading Intelligence
goldrush traders <token> <chain>— top traders ranked by unrealized PnLgoldrush gas [chain]— real-time gas price estimatesgoldrush search <query>— find tokens by name, symbol, or address
Utilities
goldrush chains— list supported chainsgoldrush auth— set API key (stored in OS keychain)goldrush install— configure Claude for MCP integrationgoldrush config— view/update settingsgoldrush status— check API key and connectivitygoldrush logout— clear session data
Critical Rules
- Chain names use kebab-case —
eth-mainnet,solana-mainnet(same as Foundational API) - Authentication — API key stored in OS keychain via
goldrush auth, not environment variables - MCP requires setup — run
goldrush installbefore Claude can use GoldRush tools - Streaming commands —
new_pairs,ohlcv_pairs, andwatchuse the Streaming API under the hood - Output is formatted tables — designed for human-readable terminal output; pipe into Claude for AI processing
MCP Integration
The CLI is an MCP server. Running goldrush install registers GoldRush as a tool provider for Claude. Agents can then call GoldRush commands natively — no wrappers or manual configuration needed.
Reference Files
| File | When to read |
|---|---|
| overview.md | Need full command reference with parameters, usage examples, or MCP setup details |
More from covalenthq/goldrush-agent-skills
goldrush-foundational-api
GoldRush Foundational API — REST API for historical and near-real-time blockchain data across 100+ chains. Use this skill whenever the user needs wallet token balances, transaction history, NFT holdings, token prices, token approvals, cross-chain activity, block data, portfolio value tracking, or any on-chain data query via REST. This is the default skill for blockchain data lookups, portfolio dashboards, tax tools, compliance checks, block explorers, and any application that fetches historical or current chain data. If the user needs real-time streaming or WebSocket push data, use goldrush-streaming-api instead. If the user needs pay-per-request access without an API key, use goldrush-x402 instead.
52goldrush-streaming-api
GoldRush Streaming API — real-time blockchain data via GraphQL subscriptions over WebSocket. Use this skill whenever the user needs live price feeds (OHLCV candles), real-time DEX pair monitoring (new pairs, liquidity updates), wallet activity streaming, decoded swap/transfer events, token search, trader PnL analysis, or any sub-second latency blockchain event push. This is the right skill for trading bots, live dashboards, alerting systems, copy-trading, DEX sniping, and real-time analytics. Also covers one-time GraphQL queries for token discovery and profitability analysis. If the user needs historical data, batch queries, or paginated REST results, use goldrush-foundational-api instead. If the user needs pay-per-request access without an API key, use goldrush-x402 instead.
40goldrush-x402
GoldRush x402 — pay-per-request blockchain data access using the x402 protocol (HTTP 402 Payment Required). Use this skill whenever the user is building an AI agent that needs blockchain data without API keys, wants wallet-based micropayments for on-chain data, needs autonomous or no-account access to the GoldRush API, mentions the x402 protocol, or wants no-signup/no-onboarding blockchain data access. This is the right skill for autonomous agents, serverless applications, and prototyping without onboarding. Provides access to 60+ Foundational API endpoints through a transparent reverse proxy with stablecoin payments on Base. If the user needs a traditional API key with monthly billing, use goldrush-foundational-api instead. If the user needs real-time streaming data via WebSocket, use goldrush-streaming-api instead.
34