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)
