zerion-analyze

Zerion — 钱包分析

查看任意加密钱包在 14 条 EVM 链和 Solana 上的只读信息。所有命令均接受 0x... 地址、ENS 名称（例如 vitalik.eth）、本地钱包名称或已监控地址。

设置

如果 zerion 命令因 command not found 失败，请安装一次：

npm install -g zerion-cli

需要 Node.js ≥ 20。有关身份验证（API key / x402 / MPP），请参阅 zerion 总技能。

适用场景

• “这个钱包里有什么？”/ 投资组合价值
• 代币持仓、DeFi 头寸（借贷、质押、LP、借入）
• 交易历史（已解析：交易、发送、接收、铸造、授权……）
• 盈亏（已实现、未实现、手续费）
• “这个钱包在哪些链上活跃？”
• 随时间追踪地址（监控列表）

如需执行操作（兑换/跨链桥/发送）→ zerion-trading。如需创建钱包 → zerion-wallet。

完整分析（建议从这里开始）

zerion analyze <address|name>
zerion analyze <address|name> --chain <chain>
zerion analyze <address|name> --positions all|simple|defi
zerion analyze <address|name> --limit <n>           # txs to sample (default 10)
zerion analyze <address|name> --x402                # pay-per-call

并行获取投资组合、头寸、交易和盈亏数据。返回的摘要包括投资组合总额、各链明细、1 日变化、按价值排序的前 10 项头寸、最近 5 笔交易和盈亏总额。

定向读取

# Portfolio value + top positions + 1-day change
zerion portfolio <address|name>
zerion portfolio --wallet <name>
zerion portfolio --watch <name>                     # use watched wallet by name

# Token + DeFi positions
zerion positions <address|name>
zerion positions <address|name> --positions all     # default: tokens + DeFi
zerion positions <address|name> --positions simple  # tokens only
zerion positions <address|name> --positions defi    # DeFi protocols only (flat list)
zerion positions <address|name> --defi              # DeFi grouped by protocol (recommended for DeFi analysis)
zerion positions <address|name> --chain <chain>

# Transaction history
zerion history <address|name>
zerion history <address|name> --limit <n>           # default 10
zerion history <address|name> --chain <chain>

# Profit & loss
zerion pnl <address|name>

所有命令均可使用 --x402（或 --mpp），无需 API key 即可按次付费。

--defi 输出结构

zerion positions <addr> --defi 按协议对头寸分组，并将贷款净额计入：

{
  "wallet": {...},
  "filter": "defi",
  "summary": { "total_value": 4200, "gross_value": 4500, "protocols": 2, "positions": 4 },
  "protocols": [
    {
      "dapp": "Aave V3",
      "module": "lending",
      "net_value": 3700,
      "gross_value": 4000,
      "groups": [
        { "position_type": "deposit", "value": 4000, "tokens": [...] },
        { "position_type": "loan",    "value": 300,  "tokens": [...] }
      ]
    }
  ]
}

主要行为：

• 贷款会从存款中扣除，计入 net_value（因此，存入 4k 美元 USDC、借入 300 美元 DAI 的 Aave 钱包会显示 net_value: 3700）。使用 gross_value 查看总敞口。
• 具有相同 group_id 的 LP 代币会合并为一个 groups[] 条目（Uniswap USDC/WETH 池会返回一个包含两种代币的组，而不是两行无关记录）。
• position_type ∈ deposit | loan | staked | locked | reward | wallet | investment — 为每行添加标签，供下游筛选。
• 将 --defi 与 --positions all|simple 一起使用会报错，错误为 conflicting_flags。

代币搜索（查找合约地址）

zerion search <query>                               # by name, symbol, or address
zerion search <query> --chain <chain>
zerion search <query> --limit <n>                   # default 10

监控列表（追踪你不拥有的地址）

将地址添加到本地监控列表，这样分析命令就可以通过名称引用它（--watch <name>）。

zerion watch <address|ens> --name <label>           # add (e.g. "vitalik.eth" --name vit)
zerion watch list                                   # list all watched
zerion watch remove <name>                          # remove

# Then use the watched name with any analysis command
zerion portfolio --watch vit
zerion analyze --watch vit

典型工作流

1. 运行 zerion analyze <address> 了解整体情况。
2. 如有需要，进一步查看详情：
   • 按协议分组的 DeFi：zerion positions <address> --defi（贷款净额计入，LP 代币按 group_id 合并）
   • DeFi 平铺列表：zerion positions <address> --positions defi
   • 单条链：zerion positions <address> --chain ethereum（或 --chain monad）
   • 查看更多交易：zerion history <address> --limit 25
3. 如需持续监控，将地址添加到监控列表：zerion watch <addr> --name <label>。

输出

JSON 输出到 stdout，结构化错误输出到 stderr。有关错误约定，请参阅 zerion 总技能。

按次付费

此技能中的每条命令均支持 --x402（Base / Solana）和 --mpp（Tempo）。交易命令不支持按次付费，始终需要 API key。

常见错误

代码	原因	解决方法
missing_api_key	未设置 ZERION_API_KEY，也未使用 --x402/--mpp	设置环境变量或传入标记
unsupported_chain	--chain 无效	运行 zerion chains 查看有效 ID
unsupported_positions_filter	--positions 无效	使用 all、simple 或 defi
conflicting_flags	--defi 与 --positions all|simple 一起使用	二选一；--defi 已隐含 --positions defi
api_error 429	请求频率受限	等待、降低请求频率，或切换到 --x402
api_error 400	地址无效或 ENS 解析失败	使用解析后的 0x 地址重试

持仓/历史记录为空通常意味着钱包处于非活跃状态或创建时间很短，并非错误。