Onchain CLI

核心用法

Onchain CLI 是一款面向加密货币投资者与开发者的命令行工具，提供四大核心功能模块：

1. 市场数据：实时查询代币价格（支持BTC、ETH、SOL等）及市场概览与趋势分析
2. 钱包追踪：自动识别EVM/Solana地址，查询余额、交易历史及完整DeFi持仓组合
3. CEX整合：直连Coinbase、Binance API，获取中心化交易所资产与交易记录
4. 预测市场：接入Polymarket，浏览趋势市场、搜索及查看详细行情

配置流程通过交互式向导完成，支持钱包别名管理。输出支持--json模式便于脚本集成，--plain模式禁用格式化字符。

显著优点

• 多链覆盖全面：EVM生态涵盖Ethereum、Polygon、Arbitrum、Base等15+主流链，Solana主网完整支持SPL代币与NFT
• 数据源权威：采用DeBank（EVM）、Helius（Solana）、CoinGecko/CoinMarketCap（行情）等行业标准API
• 架构设计友好：明确区分链上数据与CEX数据，API密钥分层管理（必需/可选），降低配置门槛
• Agent原生设计：JSON输出、退出码规范、命名钱包引用，专为自动化代理场景优化

潜在局限

• API依赖性强：核心功能需外部API密钥（DeBank、Helius等），免费额度有限，高频调用易触发限流
• 无本地私钥管理：仅支持地址查询，不涉及签名功能，无法直接执行交易
• 预测市场地域限制：Polymarket服务受监管政策影响，部分地区无法访问
• 无实时推送：纯拉取模式，无WebSocket价格订阅或告警机制

适合人群

• 多链DeFi用户需统一 portfolio 管理视图
• 量化交易者构建自动化监控脚本
• 开发者集成链上数据至内部系统
• 预测市场参与者追踪Polymarket动态

常规风险

| 风险类型 | 说明 |

|---------|------|

| API密钥泄露 | 密钥存储于本地配置文件，需遵循最小权限原则，避免提交至版本控制 |

| 数据准确性 | 依赖第三方索引服务，极端行情或链重组时可能存在延迟 |

| 隐私暴露 | 查询特定地址可能关联用户身份，建议配合隐私网络使用 |

| 合规风险 | CEX API使用需遵守平台条款，预测市场数据受当地法规约束 |

核心用法

Onchain CLI 是一款面向加密货币用户的命令行工具，提供四大核心功能模块：

市场数据：实时查询代币价格（onchain price btc/eth/sol）及市场概览趋势，支持 CoinGecko 和 CoinMarketCap 双数据源。

钱包追踪：自动识别 EVM 链（以太坊、Polygon、Arbitrum 等）和 Solana 地址，查询代币余额、交易历史及 DeFi 持仓组合。集成 DeBank 和 Helius 两大主流索引服务。

CEX 数据：直连 Coinbase、Binance API 获取账户余额和交易记录，需用户自行配置 API 密钥。

预测市场：集成 Polymarket 平台，支持查看热门市场、搜索及详情浏览。

配置采用交互式向导（onchain setup），支持命名钱包管理。全局选项 --json 专为自动化脚本和 AI Agent 设计，输出结构化数据便于后续处理。

显著优点

• 多链覆盖全面：支持 15+ EVM 链及 Solana 主网，涵盖主流公链生态
• Agent 原生设计：JSON 输出、退出码规范、可配置超时，专为程序化调用优化
• 安全架构合规：API 密钥通过环境变量/本地配置读取，无硬编码；TLS 1.2+ 加密传输；零遥测收集
• 代码质量可靠：TypeScript 项目，通过 biome/oxlint 规范检查，CLS 认证评分 82/A
• 依赖生态可信：核心依赖 commander、json5 等成熟库，开发工具链完整

潜在局限

• 外部 API 依赖：DeBank、Helius 等服务商的稳定性直接影响功能可用性，需自行管理 API 配额和限流
• CEX 接入门槛：需用户手动申请交易所 API 密钥，对新手存在一定配置复杂度
• 无交易功能：纯数据查询工具，不支持签名转账等链上操作
• 地址格式校验待加强：当前输入验证主要依赖 commander，建议增强地址格式校验

适合人群

• 需要批量监控多链钱包的 DeFi 投资者
• 构建加密货币数据分析工作流的开发者/量化交易者
• 习惯命令行效率的高级用户
• 需集成市场数据到自动化系统的 AI Agent

常规风险

• API 密钥泄露风险：用户自行保管密钥，建议使用只读权限并定期轮换
• 第三方服务中断：API 服务商故障或政策变更可能影响功能
• 数据延迟：链上数据索引存在分钟级延迟，非实时区块状态
• 监管不确定性：CEX API 访问可能受地域合规限制

安全认证结论

CLS-Certify 综合评分 82/A，静态分析 95 分、动态行为 90 分，网络调用均为知名服务商，2 项依赖警告经核实为误报。适合生产环境部署，建议用户关注 API 密钥管理最佳实践。