Onchain CLI

用于加密资产组合追踪、市场数据查询及中心化交易所（CEX）历史记录的命令行工具。

调用方式

onchain 

命令列表

市场数据

onchain price          # 查询代币价格（如 btc、eth、sol 等）
onchain markets               # 查看市场概览（含热门趋势）

钱包数据

onchain balance [address]           # 查询代币余额（自动识别 EVM / Solana 钱包）
onchain balance --chain polygon     # 按链筛选（例如指定 Polygon 链）
onchain history [address]           # 查询交易历史
onchain portfolio [address]         # 查询完整资产组合（含 DeFi 头寸）

CEX 数据

onchain coinbase balance      # 查询 Coinbase 账户余额
onchain coinbase history      # 查询 Coinbase 交易历史
onchain binance balance       # 查询 Binance 账户余额
onchain binance history       # 查询 Binance 交易历史

预测市场

onchain polymarket trending          # 查看热门预测市场
onchain polymarket search     # 搜索预测市场
onchain polymarket view        # 查看指定市场的详细信息

配置管理

onchain setup                 # 启动交互式配置向导
onchain config                # 查看当前配置
onchain config wallet add  

onchain config wallet set-default 

全局选项

• --json —— 以 JSON 格式输出（适配 Agent 调用）
• --plain —— 禁用颜色与 emoji 显示
• --timeout —— 设置请求超时时间（毫秒）

配置文件

配置文件路径：~/.config/onchain/config.json5

必需的 API 密钥

可选的 API 密钥

使用示例

查询比特币价格

onchain price btc

查询钱包余额

onchain balance 0x1234...5678

查看含 DeFi 头寸的完整资产组合

onchain portfolio main  # 使用已保存的钱包名称 “main”

获取热门预测市场（前 5 名）

onchain polymarket trending -n 5

脚本中使用 JSON 输出

onchain --json price eth | jq '.priceUsd'

支持的区块链

EVM（通过 DeBank）

Ethereum、BNB Chain、Polygon、Arbitrum、Optimism、Avalanche、Base、zkSync Era、Linea、Scroll、Blast、Mantle、Gnosis、Fantom、Celo 等。

Solana（通过 Helius）

完整支持 Solana 主网，包括 SPL 代币与 NFT。

Agent 集成

本 CLI 专为 Agent 场景设计。关键实践建议如下：

1. 始终使用 --json 以支持程序化调用
2. 检查退出码 —— 成功返回 0，错误返回 1
3. 使用已保存的钱包 —— 通过 onchain setup 一次性配置，后续直接按名称引用
4. 注意速率限制 —— 各 API 均有调用频率限制，请在高频调用间添加适当延迟

Agent 使用示例

# 获取资产组合总价值（USD）
VALUE=$(onchain --json portfolio main | jq -r '.totalValueUsd')

# 获取价格及 24 小时涨跌幅
onchain --json price btc | jq '{price: .priceUsd, change24h: .priceChange24h}'

# 判断市场是否呈牛市（基于市值 24 小时变化）
CHANGE=$(onchain --json markets | jq '.marketCapChange24h')