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
CODEBLOCK0
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 changes - INLINECODE1 — transfer history for any wallet
- INLINECODE2 — real-time wallet activity streaming
Market Discovery
- -
goldrush new_pairs <chain> [protocols...] — live stream of new DEX liquidity pairs - INLINECODE4 — live OHLCV candlestick charts in ASCII
Trading Intelligence
- -
goldrush traders <token> <chain> — top traders ranked by unrealized PnL - INLINECODE6 — real-time gas price estimates
- INLINECODE7 — find tokens by name, symbol, or address
Utilities
- -
goldrush chains — list supported chains - INLINECODE9 — set API key (stored in OS keychain)
- INLINECODE10 — configure Claude for MCP integration
- INLINECODE11 — view/update settings
- INLINECODE12 — check API key and connectivity
- INLINECODE13 — clear session data
Critical Rules
- 1. 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 install before Claude can use GoldRush tools - Streaming commands —
new_pairs, ohlcv_pairs, and watch use 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 |
GoldRush CLI
支持MCP的终端优先区块链数据工具，专为AI代理设计。查询钱包、流式获取DEX交易对、将实时链上数据直接导入Claude——全部在命令行中完成。
快速开始
bash
安装并认证
npx @covalenthq/goldrush-cli auth
查询钱包余额
goldrush balances eth-mainnet vitalik.eth
流式获取新DEX交易对
goldrush new_pairs solana-mainnet raydium
为Claude配置MCP
goldrush install
命令
命令涵盖投资组合管理、市场发现、交易情报和实用工具。如需包含所有参数和示例的完整参考，请参阅overview.md。
投资组合与钱包
- - goldrush balances — 完整代币投资组合，包含美元价值和24小时变化
- goldrush transfers — 任意钱包的转账历史
- goldrush watch — 实时钱包活动流式推送
市场发现
- - goldrush newpairs [protocols...] — 新DEX流动性交易对实时流
- goldrush ohlcvpairs [-i interval] — ASCII格式实时OHLCV蜡烛图
交易情报
- - goldrush traders — 按未实现盈亏排名的高频交易者
- goldrush gas [chain] — 实时Gas价格估算
- goldrush search — 按名称、符号或地址查找代币
实用工具
- - goldrush chains — 列出支持的链
- goldrush auth — 设置API密钥（存储在操作系统密钥链中）
- goldrush install — 为MCP集成配置Claude
- goldrush config — 查看/更新设置
- goldrush status — 检查API密钥和连接状态
- goldrush logout — 清除会话数据
关键规则
- 1. 链名称使用kebab-case格式 — eth-mainnet、solana-mainnet（与基础API一致）
- 认证方式 — API密钥通过goldrush auth存储在操作系统密钥链中，而非环境变量
- MCP需要配置 — 在Claude使用GoldRush工具前，需运行goldrush install
- 流式命令 — newpairs、ohlcvpairs和watch底层使用流式API
- 输出为格式化表格 — 设计为人类可读的终端输出；可导入Claude进行AI处理
MCP集成
该CLI是一个MCP服务器。运行goldrush install会将GoldRush注册为Claude的工具提供者。代理随后可直接调用GoldRush命令——无需封装器或手动配置。
参考文件
