Onchain CLI
CLI for crypto portfolio tracking, market data, and CEX history.
Invocation
CODEBLOCK0
Commands
Market Data
CODEBLOCK1
Wallet Data
CODEBLOCK2
CEX Data
CODEBLOCK3
Prediction Markets
CODEBLOCK4
Configuration
CODEBLOCK5
Global Options
- -
--json - Output as JSON (agent-friendly) - INLINECODE1 - Disable colors and emoji
- INLINECODE2 - Request timeout
Configuration
Config file: INLINECODE3
Required API Keys
| Feature | API Key | Get Key |
|---|
| EVM wallets | INLINECODE4 | DeBank |
| Solana wallets |
HELIUS_API_KEY |
Helius |
| Coinbase CEX |
COINBASE_API_KEY +
COINBASE_API_SECRET |
Coinbase |
| Binance CEX |
BINANCE_API_KEY +
BINANCE_API_SECRET |
Binance |
Optional API Keys
| Feature | API Key | Notes |
|---|
| Market data | INLINECODE10 | Free tier works, Pro for higher limits |
| Market fallback |
COINMARKETCAP_API_KEY | Alternative market data source |
Examples
Get Bitcoin price
CODEBLOCK6
Check wallet balance
CODEBLOCK7
View portfolio with DeFi positions
CODEBLOCK8
Get trending prediction markets
CODEBLOCK9
JSON output for scripts
CODEBLOCK10
Supported Chains
EVM (via DeBank)
Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Avalanche, Base, zkSync Era, Linea, Scroll, Blast, Mantle, Gnosis, Fantom, Celo, and more.
Solana (via Helius)
Full Solana mainnet support including SPL tokens and NFTs.
Agent Integration
This CLI is designed for agent use. Key patterns:
- 1. Always use
--json for programmatic access - Check exit codes - 0 for success, 1 for error
- Use saved wallets - Configure once with
onchain setup, reference by name - Rate limiting - APIs have rate limits, add delays between rapid calls
Example Agent Usage
CODEBLOCK11
Onchain CLI
用于加密货币投资组合追踪、市场数据和中心化交易所历史的命令行工具。
调用方式
onchain
命令
市场数据
bash
onchain price # 代币价格（btc、eth、sol等）
onchain markets # 市场概览及热门趋势
钱包数据
bash
onchain balance [address] # 代币余额（自动检测EVM/Solana）
onchain balance --chain polygon # 按链筛选
onchain history [address] # 交易历史
onchain portfolio [address] # 包含DeFi持仓的完整投资组合
中心化交易所数据
bash
onchain coinbase balance # Coinbase余额
onchain coinbase history # Coinbase交易历史
onchain binance balance # Binance余额
onchain binance history # Binance交易历史
预测市场
bash
onchain polymarket trending # 热门市场
onchain polymarket search # 搜索市场
onchain polymarket view # 查看市场详情
配置
bash
onchain setup # 交互式设置向导
onchain config # 查看当前配置
onchain config wallet add
onchain config wallet set-default
全局选项
- - --json - 输出为JSON格式（适用于代理）
- --plain - 禁用颜色和表情符号
- --timeout - 请求超时时间
配置
配置文件：~/.config/onchain/config.json5
必需的API密钥
| 功能 | API密钥 | 获取密钥 |
|---|
| EVM钱包 | DEBANKAPIKEY | DeBank |
| Solana钱包 |
HELIUSAPI
KEY | Helius |
| Coinbase交易所 | COINBASEAPIKEY + COINBASEAPISECRET | Coinbase |
| Binance交易所 | BINANCEAPIKEY + BINANCEAPISECRET | Binance |
可选的API密钥
| 功能 | API密钥 | 说明 |
|---|
| 市场数据 | COINGECKOAPIKEY | 免费版可用，专业版提供更高限制 |
| 市场备用 |
COINMARKETCAPAPIKEY | 替代市场数据源 |
示例
获取比特币价格
bash
onchain price btc
查看钱包余额
bash
onchain balance 0x1234...5678
查看包含DeFi持仓的投资组合
bash
onchain portfolio main # 使用名为main的已保存钱包
获取热门预测市场
bash
onchain polymarket trending -n 5
脚本使用的JSON输出
bash
onchain --json price eth | jq .priceUsd
支持的链
EVM（通过DeBank）
以太坊、BNB Chain、Polygon、Arbitrum、Optimism、Avalanche、Base、zkSync Era、Linea、Scroll、Blast、Mantle、Gnosis、Fantom、Celo等。
Solana（通过Helius）
完整的Solana主网支持，包括SPL代币和NFT。
代理集成
此CLI专为代理使用设计。关键模式：
- 1. 始终使用--json 进行程序化访问
- 检查退出码 - 0表示成功，1表示错误
- 使用已保存的钱包 - 通过onchain setup一次性配置，按名称引用
- 速率限制 - API有速率限制，快速调用之间添加延迟
代理使用示例
bash
获取投资组合价值
VALUE=$(onchain --json portfolio main | jq -r .totalValueUsd)
获取价格及变化
onchain --json price btc | jq {price: .priceUsd, change24h: .priceChange24h}
检查市场是否看涨
CHANGE=$(onchain --json markets | jq .marketCapChange24h)
