Onchain 是一个用于加密货币投资组合追踪、市场数据查询、CEX 历史记录和交易查找的命令行工具（CLI）。
用途
Onchain 面向需要快速获取加密资产信息的用户和智能体，提供统一的命令行入口来查询代币价格、钱包余额、交易详情、中心化交易所（CEX）余额与交易历史，以及预测市场数据。
主要能力
- 市场数据：查询代币价格（如 btc、eth、sol）、市场概览与趋势、代币搜索、EVM 链 Gas 价格。
- 钱包数据：查询代币余额（自动识别 EVM/Solana）、按链筛选、交易历史、包含 DeFi 头寸的完整投资组合。
- 交易查找：通过交易哈希或区块浏览器 URL 查询交易详情，自动识别链，支持 EVM 链（Ethereum、Polygon、Base、Arbitrum、Optimism、BSC、Avalanche、Fantom）和 Solana。
- CEX 数据：查询 Coinbase 和 Binance 的余额与交易历史。
- 预测市场：列出 Polymarket 标签、查看趋势市场、搜索市场、查看市场详情、分析市场情绪（看涨/看跌预期）。
使用方式
首次使用需运行 onchain setup 配置 API 密钥，该交互式向导可配置 Coinbase/Binance（CEX 余额与交易历史）、DeBank（EVM 钱包数据）、Helius（Solana 钱包数据）。未配置时仅 onchain price 和 onchain markets 可用（使用免费 CoinGecko 层级）。运行 onchain test 可验证配置。
常用命令示例：
onchain price btc获取比特币价格onchain balance 0x1234...5678查询钱包余额onchain portfolio main查看包含 DeFi 头寸的投资组合onchain tx <hash>或onchain tx <explorer-url>查询交易onchain polymarket trending获取趋势预测市场
全局选项包括 --json（JSON 输出，便于智能体使用）、--plain（禁用颜色和 emoji）、--timeout <ms>（请求超时）。
配置文件位于 ~/.config/onchain/config.json5，可配置默认排除标签等。
适用场景
- 智能体集成：该 CLI 专为智能体设计，建议始终使用
--json进行程序化访问，检查退出码（0 成功，1 错误），使用已保存的钱包名称，注意 API 速率限制。 - 个人用户快速查询加密资产价格、余额、交易详情和预测市场情绪。
限制
- 部分功能需要配置相应的 API 密钥：EVM 钱包需要 DEBANK_API_KEY，Solana 钱包需要 HELIUS_API_KEY，Coinbase 需要 COINBASE_API_KEY 和 COINBASE_API_SECRET，Binance 需要 BINANCE_API_KEY 和 BINANCE_API_SECRET。
- 可选 API 密钥：COINGECKO_API_KEY（免费层级可用，Pro 提供更高限额）、COINMARKETCAP_API_KEY（备用市场数据源）、ETHERSCAN_API_KEY（EVM 交易查找）、SOLSCAN_API_KEY（Solana 交易查找）。
- 交易查找命令直接查询 Etherscan/Solscan API，返回所有可用数据，不应使用 curl、cast 或 WebFetch 作为替代。
- 支持的链：EVM 通过 DeBank 支持 Ethereum、BNB Chain、Polygon、Arbitrum、Optimism、Avalanche、Base、zkSync Era、Linea、Scroll、Blast、Mantle、Gnosis、Fantom、Celo 等；Solana 通过 Helius 支持完整主网，包括 SPL 代币和 NFT。
- 具体收费、价格、平台可用性等信息暂未提供。