Zerion CLI 是用于获取加密钱包数据的命令行工具,主要覆盖安装、认证配置与连接故障排查。若需钱包分析,官方建议改用 wallet-analysis 技能。
安装:可直接运行 npx zerion-cli --help 免安装使用,或执行 npm install -g zerion-cli 全局安装,要求 Node.js 20 或更高版本。
认证提供两种方式。方式一为 API Key,生产环境推荐,设置 export ZERION_API_KEY="zk_dev_...",密钥可在 dashboard.zerion.io 获取,开发密钥以 zk_dev_ 开头,限速为每分钟 120 次、每天 5000 次请求,采用 HTTP Basic Auth(密钥作用户名、密码为空)。方式二为 x402 按次付费,无需注册,每次请求支付 0.01 USDC,支持 EVM(Base)与 Solana。单个私钥格式自动识别:设置 WALLET_PRIVATE_KEY,EVM 用 0x 前缀十六进制,Solana 用 base58 编码密钥对;同时使用两条链可分别设置 EVM_PRIVATE_KEY 与 SOLANA_PRIVATE_KEY,并可用 ZERION_X402_PREFER_SOLANA=true 优先 Solana。也可用每命令标志 zerion-cli wallet analyze <address> --x402,或全局设置 export ZERION_X402=true。
可用命令包括:wallet analyze、wallet portfolio、wallet positions、wallet transactions、wallet pnl 以及 chains list,所有命令均接受 --x402 参数。zerion-cli --help 会返回包含全部命令、环境变量与 x402 信息的 JSON。其他环境变量有 ZERION_API_BASE(默认 https://api.zerion.io/v1)。
故障排查覆盖:missing_api_key(未设置密钥,改用 --x402)、unsupported_chain(用 chains list 查询有效链 ID)、401(密钥无效)、429(限速,可等待或改用 x402)、400(地址无效或 ENS 解析失败,需 0x 十六进制地址)、x402 模式下缺少 WALLET_PRIVATE_KEY、Node.js 版本过低。相关资源包括 developers.zerion.io、dashboard.zerion.io、x402.org 及 github.com/zeriontech/zerion-ai。