Onchain CLI

核心功能

Onchain 是一款面向进阶用户和自动化代理的加密货币命令行工具，整合三大核心场景：

1. 市场数据与价格追踪

• 实时代币价格查询（BTC、ETH、SOL 等）
• 市场趋势概览与热度分析
• 支持 CoinGecko 免费/Pro tier 及 CoinMarketCap 备用源

2. 多链钱包与 DeFi 聚合

• EVM 全支持：Ethereum、Polygon、Arbitrum、Optimism、Base、Scroll 等 15+ 链，通过 DeBank API 获取余额、持仓及 DeFi 头寸
• Solana 原生：通过 Helius API 完整支持 SPL 代币及 NFT
• 智能地址识别：自动检测 EVM/Solana 地址，无需手动指定链

3. CEX 与预测市场

• 中心化交易所：Coinbase、Binance 余额与交易历史直连
• Polymarket 集成：
• 趋势市场浏览与标签过滤
• 智能搜索与话题情绪分析（Fed 利率、BTC 走势、AI、政治事件等）
• 可配置默认过滤规则（如排除体育类市场）

4. 交易解析

• 支持 EVM 全链 + Solana 交易哈希查询
• 兼容区块浏览器 URL 直接粘贴
• 返回完整链上数据：状态、Gas 使用、Method ID、双方地址

显著优势

• 代理优先设计：--json 输出、结构化退出码、清晰的错误提示
• 配置即代码：一次 onchain setup 配置持久化，支持钱包别名管理
• 数据源权威：直接对接 Etherscan、Solscan、DeBank、Helius 官方 API，非聚合商二次加工
• Polymarket 深度集成：预测市场情绪分析为差异化功能，适合宏观研究

局限性与风险

| 维度 | 说明 |

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

| **API 依赖** | 核心功能需用户自行申请 DeBank、Helius、交易所 API Key，门槛较高 |

| **免费限制** | CoinGecko 免费 tier 有速率限制，高频调用需 Pro 订阅 |

| **无私钥操作** | 纯只读工具，不支持签名交易，非完整钱包替代方案 |

| **数据时效** | 链上数据延迟取决于各 API 索引速度，非实时区块级 |

| **隐私暴露** | API 调用需向第三方服务商暴露地址信息 |

适合人群

• DeFi 研究员与链上分析师
• 需要自动化监控的量化交易者
• 关注预测市场/事件驱动策略的投资者
• 构建加密货币数据管道的开发者

安全风险

• API Key 管理：密钥存储于本地 ~/.config/onchain/config.json5，需确保文件权限安全
• 地址隐私：向 DeBank/Helius 等服务商提交地址存在关联分析风险
• 无交易签名：设计上规避私钥风险，但也限制了功能边界
• 第三方可靠性：依赖外部 API 可用性与数据准确性

核心用法

Onchain CLI 是一款面向加密资产管理的命令行工具，通过统一的接口整合链上与中心化交易所数据。用户首次使用需运行 onchain setup 完成交互式配置，支持 DeBank（EVM 多链）、Helius（Solana）、Coinbase、Binance 四大数据源。核心功能分为四大模块：

市场数据：onchain price <token> 获取实时价格，onchain markets 查看市场概览与趋势，默认使用免费 CoinGecko 层级，支持 Pro 版升级。

链上钱包：onchain balance 自动识别 EVM/Solana 地址查询代币余额，onchain portfolio 展示包含 DeFi 仓位的完整投资组合，onchain history 追溯交易记录，覆盖 Ethereum、Polygon、Base、Arbitrum、Solana 等 15+ 主流网络。

交易溯源：onchain tx <hash> 为核心亮点，直接对接 Etherscan/Solscan API 返回完整交易数据，包括状态、Gas 使用、方法 ID 等字段，支持原始哈希或区块浏览器 URL 智能解析。

预测市场：集成 Polymarket 数据，提供趋势市场列表、标签筛选、自定义搜索及智能情绪分析（如 Fed 利率预期、比特币市场情绪），输出可直接用于投研决策。

全局支持 --json 结构化输出，便于 Agent 程序化调用与数据管道集成。

显著优点

1. 数据源权威性：整合 DeBank（链上数据基础设施龙头）、Helius（Solana 生态核心服务商）、Coinbase/Binance（顶级 CEX）及 CoinGecko（行业标准行情站），数据可信度行业领先。

2. 多链覆盖度：单工具覆盖 EVM 全生态与 Solana，无需切换多个区块浏览器或钱包应用。

3. Agent 原生设计：JSON 输出、退出码规范、配置持久化、钱包别名系统，专为自动化场景优化。

4. 预测市场差异化：Polymarket 情绪分析功能填补市场空白，将去中心化预测数据转化为可交易的宏观洞察。

5. 零代码依赖：纯 CLI 封装复杂 API 调用，降低链上数据获取门槛。

潜在缺点与局限性

1. API 密钥门槛：除基础行情外，所有核心功能依赖用户自行申请并配置 4-6 组 API 密钥，对新手存在学习成本。

2. 功能边界：作为文档型 Skill，实际执行依赖底层 @cyberdrk/onchain NPM 包，版本兼容性、CLI 更新需独立跟踪。

3. Solana 生态局限：Helius 虽为知名服务商，但 .xyz 域名在部分企业环境可能触发安全策略误报。

4. 无交易执行：仅支持数据查询，不具备下单、签名、合约交互等操作能力。

5. 费率与限额：各 API 服务商均有调用频率限制，高频场景需购买付费层级。

适合的目标群体

• 量化交易员与 DeFi 分析师：需要程序化获取多链仓位与历史数据
• 加密货币基金运营：跨 CEX 与链上资产统一定期净值计算
• 宏观研究员：利用 Polymarket 预测市场数据进行事件驱动分析
• 个人投资者：希望以命令行方式快速自查资产，避免频繁切换钱包应用
• AI Agent 开发者：构建自动化投研、风控或报告生成工作流

常规使用风险

密钥安全：API 密钥存储于本地明文配置文件（~/.config/onchain/config.json5），权限管理完全依赖用户操作，存在误提交至 Git、多人共用服务器泄露等风险。建议设置 chmod 600 权限并启用只读型密钥。

API 可用性：依赖第三方服务可用性与政策稳定性，Coinbase/Binance API 可能因监管调整受限，DeBank/Helius 存在服务中断或费率变更可能。

数据延迟：链上数据存在索引延迟，极端行情下价格与仓位数据可能滞后于实际链上状态。

误操作风险：钱包别名系统若配置错误可能导致查询非目标地址，建议在关键操作前执行 onchain config 复核。

依赖维护：底层 CLI 工具更新与安全补丁需用户主动跟进，长期未更新版本可能存在已知漏洞。