onchain

核心用法

Onchain CLI 是一款面向加密货币用户的专业级命令行工具，通过整合多条主流数据链路实现资产追踪与市场分析。用户可通过 onchain <command>> 调用六大功能模块：市场数据（price//markets）、钱包数据（balance//history//portfolio）、中心化交易所数据（Coinbase/Binance 的 balance//history）、预测市场（Polymarket 的 trending//search//view）以及配置管理（setup//config）。工具支持 EVM 全生态（Ethereum、Polygon、Arbitrum、Base 等 15+ 链）与 Solana 主网，通过 --json` 输出模式专为 AI Agent 与自动化脚本优化。

显著优点

数据覆盖全面：聚合 DeBank（EVM）、Helius（Solana）、CoinGecko/CoinMarketCap（行情）、Polymarket（预测市场）及 Coinbase/Binance 官方 API，实现链上链下资产统一视图。Agent 原生设计：--json 结构化输出、、--plain 无干扰模式、明确的退出码规范（0/1），使其成为自动化工作流的理想组件。配置灵活持久：通过 ~/.config/onchain/config.json5 管理多钱包别名与 API 密钥，避免重复输入地址。多链兼容性强：覆盖主流 L1/L2 及新兴网络，DeFi 仓位解析能力超越基础余额查询。

潜在缺点与局限性

API 密钥门槛高：需用户自行申请 5-7 个不同平台的 API 密钥（DeBank、Helius、Coinbase、Binance 等），配置流程对新手不够友好。第三方依赖风险：核心功能完全依赖外部 API 可用性与费率政策，DeBank/Helius 的免费额度或稳定性变化将直接影响使用体验。无本地节点支持：纯 API 架构意味着无法离线使用，且存在数据延迟与服务商审查风险。功能深度有限：相比专业资管平台（如 Zapper、DeBank 网页版），缺乏收益计算、税务报表、风险分析等高级功能。

适合的目标群体

技术型加密投资者：熟悉 CLI 操作、追求效率的 DeFi 高级用户与量化交易者。自动化需求者：需要将资产监控集成到自建脚本、通知系统或交易机器人的开发者。多链多平台用户：同时在 EVM 生态、Solana 及 Coinbase/Binance 持有资产，希望统一查询入口的跨链用户。AI Agent 开发者：构建加密领域自动化代理，需要结构化数据接口的技术团队。

使用风险

API 密钥泄露风险：本地明文存储的 config.json5 若权限配置不当或被误提交至代码仓库，可能导致资金级权限的密钥泄露。服务商单点故障：任一上游 API（如 Helius 宕机、DeBank 限流）将导致对应功能不可用。数据准确性依赖：第三方聚合数据可能存在延迟或错误，不宜作为大额交易决策的唯一依据。合规与隐私：CEX API 调用可能触发平台风控，链上地址查询存在被追踪分析的风险。