Onchain Test

核心功能

Onchain CLI 是一款面向加密货币投资者与开发者的命令行工具，集市场数据、钱包资产、交易所持仓及预测市场于一体。核心能力包括：

• 市场数据：实时查询代币价格（BTC、ETH、SOL 等）及市场热度概览，支持 CoinGecko/CoinMarketCap 双源
• 多链钱包追踪：自动识别 EVM/Solana 地址，通过 DeBank 与 Helius API 获取余额、交易历史及完整 DeFi 头寸（含 LP、质押等）
• CEX 集成：原生支持 Coinbase、Binance API，一键查询中心化交易所持仓与交易记录
• 预测市场：Polymarket 热门市场浏览、搜索及详情查看

显著优点

1. Agent 优先设计：--json 输出模式与明确的退出码（0/1）专为程序化调用优化，适合量化脚本与 AI agent 集成
2. 多链覆盖：支持 Ethereum、Polygon、Arbitrum、Base、Solana 等 15+ 主流网络
3. 配置持久化：通过 ~/.config/onchain/config.json5 管理钱包别名与 API 密钥，避免重复输入
4. 数据源权威：DeBank、Helius、CoinGecko 均为行业头部服务商

潜在局限

• API 密钥门槛：DeBank、Helius、CEX 均需手动申请密钥，新手配置成本较高
• 无硬件钱包直连：需手动输入地址或使用 API，不支持 Ledger/Trezor 直接交互
• 无交易执行：仅数据查询，无法直接发起转账或交易

适用人群

• DeFi 活跃用户：需跨链追踪复杂头寸
• 量化开发者：需要标准化 JSON 输出的程序化数据接口
• 预测市场参与者：快速获取 Polymarket 市场信息

风险提示

• API 密钥需妥善保管，避免写入版本控制
• CEX API 可能因 IP 限制或权限设置导致读取失败
• 区块链数据存在索引延迟，大额交易建议二次核对

核心用法

onchain 是一款面向加密货币用户的 CLI 工具文档型 Skill，提供四大功能模块：

1. 市场数据查询：onchain price <token> 获取代币实时价格，onchain markets 查看市场概览与趋势
2. 链上钱包追踪：支持 balance、history、portfolio 命令，自动识别 EVM 链（via DeBank）和 Solana（via Helius），涵盖 15+ 主流公链
3. 中心化交易所集成：原生支持 Coinbase、Binance 的余额与交易历史查询
4. 预测市场接入：polymarket 子命令可浏览趋势市场、搜索并查看详情

关键配置：需在 ~/.config/onchain/config.json5 配置 6 组 API 密钥（DeBank、Helius、Coinbase、Binance、CoinGecko、CoinMarketCap），Skill 本身不存储任何凭证。

显著优点

• 多链覆盖全面：EVM 生态（Ethereum、Polygon、Arbitrum、Base 等）与 Solana 双轨并行
• Agent 友好设计：全局 --json 标志支持程序化调用，setup 向导降低配置门槛
• 纯文档零执行：无可执行代码，所有 API 调用由用户本地 CLI 工具发起，降低供应链攻击面
• 知名服务商背书：集成的 DeBank、Helius、Coinbase 等均为行业头部基础设施

潜在局限

• T3 来源可信度：个人开发者社区项目，维护持续性待观察
• API 密钥门槛高：需自行注册 6 个平台账户并管理密钥，新用户上手成本较高
• 第三方依赖风险：数据准确性、服务可用性完全依赖外部 API 提供商
• 无实时交易功能：仅支持只读查询，无法执行链上交易（亦为安全特性）

适合人群

• 已有加密货币持仓、需跨链/跨平台资产聚合查看的进阶用户
• 量化研究员、DeFi 分析师等需程序化获取市场与持仓数据的从业者
• 对 API 密钥管理有基础认知、能接受隐私-便利权衡的技术用户

常规风险

| 风险类型 | 具体说明 | 缓释建议 |

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

| 密钥泄露 | API 密钥若被窃取可能导致账户数据暴露 | 使用只读密钥、设置 IP 白名单、定期轮换 |

| 数据延迟 | 链上/交易所数据非实时，可能存在分钟级延迟 | 关键决策前交叉验证多个数据源 |

| 监管不确定性 | Polymarket 等预测市场在某些司法辖区受限 | 了解本地法规合规要求 |

| 第三方服务中断 | DeBank/Helius 等故障将导致功能不可用 | 准备备用数据源，关注服务状态页 |