Onchain Test 是一款专为加密资产投资者和开发者设计的命令行工具，通过简洁的终端界面提供实时的市场数据、钱包余额追踪、投资组合分析以及中心化交易所（CEX）持仓查询等功能。它支持主流区块链网络上的 EVM 兼容链与 Solana，能够自动识别用户地址所属链并聚合显示其持有的代币、NFT 及 DeFi 协议中的头寸。无论是个人用户还是自动化脚本，都可以借助 Onchain Test 快速获取关键链上信息，无需依赖复杂的网页端或第三方平台。
该工具的核心优势在于高度集成化的 API 调用体系，整合了 DeBank 的链上数据分析能力、Helius 的 Solana 全节点服务，以及 Coinbase 和 Binance 等主流交易所的账户接口。同时，它还兼容 Coingecko 和 CoinMarketCap 作为补充的市场数据来源，确保在部分服务不可用时仍能稳定运行。通过本地配置文件管理密钥与钱包别名，用户可安全地保存多组身份信息，并在后续命令中直接引用名称而非重复输入长地址。
Onchain Test 特别强调对自动化流程的支持，所有输出均可通过 `–json` 参数转为结构化数据，便于集成到交易机器人、监控脚本或数据分析管道中。此外，其清晰的错误码机制（0 表示成功，1 表示失败）和灵活的格式化选项（如禁用颜色与表情符号）进一步提升了在 CI/CD 环境或日志系统中的可用性。
核心功能特点
- 实时查询主流加密货币价格及24小时涨跌幅
- 自动检测 EVM 与 Solana 钱包地址，展示代币余额与 NFT 资产
- 聚合 DeFi 头寸，生成包含借贷、流动性挖矿等复杂持仓的投资组合视图
- 支持 Coinbase 和 Binance 等中心化交易所的余额与交易历史查询
- 接入 Polymarket 预测市场接口，检索热门赛事与特定主题的市场详情
- 配置化钱包管理，可通过命名别名简化高频操作并保障密钥安全
适用场景
对于频繁关注加密市场行情的交易员而言，Onchain Test 提供了一种轻量级但高效的监控方式。例如，在开盘前使用 `onchain price btc` 快速确认比特币当前价格与波动趋势；或在盘中结合 `–json` 输出解析 ETH 的 24 小时变化率，辅助判断入场时机。这种即时性远超手动刷新网页，尤其适合需要快速响应市场变化的量化策略执行者。
开发者和运维人员则可利用其 JSON 输出接口构建自动化工作流。比如编写定时任务脚本，每日凌晨调用 `onchain portfolio main –json` 获取投资组合总价值，并通过邮件或消息推送通知异常波动；或将 CEX 余额查询嵌入风控系统，实时监控资金流动情况。由于工具严格遵循标准退出码规范，因此能无缝集成到现有 DevOps 工具链中，实现可靠的状态检测与告警触发。
此外，DeFi 用户和 NFT 收藏家也能从中受益——通过 `onchain history` 查看链上交易流水，验证资产转移路径；利用 `onchain balance –chain polygon` 筛选特定链上的资产，避免跨链混淆带来的误判。而对于参与预测市场的参与者来说，`onchain polymarket trending` 可帮助他们发现高关注度事件，而 `search ` 功能则允许深入挖掘小众议题背后的舆论热度，为投机决策提供数据支撑。