Back to Details

zerion-analyze

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Zerion — Wallet Analysis

Zerion — 钱包分析

Read-only insights into any crypto wallet across 14 EVM chains and Solana. All commands accept 
0x...
addresses, ENS names (e.g. 
vitalik.eth
), local wallet names, or watched addresses.
可获取14条EVM链和Solana上任意加密钱包的只读洞察信息。所有命令均支持
0x...
格式地址、ENS名称（例如
vitalik.eth
）、本地钱包名称或关注地址。

Setup

设置

If a 
zerion
command fails with 
command not found
, install once:
bash
npm install -g zerion-cli
Requires Node.js ≥ 20. For auth (API key / x402 / MPP) see the 
zerion
umbrella skill.
如果执行
zerion
命令时提示
command not found
，请执行一次安装：
bash
npm install -g zerion-cli
要求Node.js ≥ 20版本。关于身份验证（API密钥 / x402 / MPP）请查看
zerion
umbrella skill。

When to use

使用场景

  • "What's in this wallet?" / portfolio value
  • Token holdings, DeFi positions (lending, staking, LP, borrowed)
  • Transaction history (parsed: trade, send, receive, mint, approve…)
  • Profit & loss (realized, unrealized, fees)
  • "What chains is this wallet active on?"
  • Track an address over time (watchlist)
For execution (swap/bridge/send) → 
zerion-trading
. For wallet creation → 
zerion-wallet
.
  • “这个钱包里有什么？” / 投资组合价值查询
  • 代币持有量、DeFi仓位（借贷、质押、流动性池、借入资产）
  • 交易历史（已解析：交易、发送、接收、铸造、授权…）
  • 盈亏情况（已实现盈亏、未实现盈亏、手续费）
  • “这个钱包活跃在哪些链上？”
  • 长期追踪某个地址（观察列表）
如需执行交易操作（兑换/跨链转账/发送）→ 使用
zerion-trading
。如需创建钱包→ 使用
zerion-wallet
。

Full analysis (recommended starting point)

全面分析（推荐起始操作）

bash
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
Fetches portfolio + positions + transactions + PnL in parallel. Returns a summary with portfolio total + chain breakdown + 1-day change, top 10 positions by value, 5 most recent transactions, and PnL totals.
bash
zerion analyze <address|name>
zerion analyze <address|name> --chain <chain>
zerion analyze <address|name> --positions all|simple|defi
zerion analyze <address|name> --limit <n>           # 要采样的交易数量（默认10条）
zerion analyze <address|name> --x402                # 按次付费调用
并行获取投资组合+仓位+交易记录+盈亏数据。返回包含投资组合总额+链上分布+1日变化、按价值排序的前10个仓位、最近5笔交易以及总盈亏的汇总信息。

Targeted reads

定向查询

bash
undefined
bash
undefined

Portfolio value + top positions + 1-day change

投资组合价值 + 顶级仓位 + 1日变化

zerion portfolio <address|name> zerion portfolio --wallet <name> zerion portfolio --watch <name> # use watched wallet by name
zerion portfolio <address|name> zerion portfolio --wallet <name> zerion portfolio --watch <name> # 使用已关注的钱包名称查询

Token + DeFi positions

代币 + DeFi仓位

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 zerion positions <address|name> --chain <chain>
zerion positions <address|name> zerion positions <address|name> --positions all # 默认：代币 + DeFi zerion positions <address|name> --positions simple # 仅代币 zerion positions <address|name> --positions defi # 仅DeFi协议 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>
zerion history <address|name> zerion history <address|name> --limit <n> # 默认10条 zerion history <address|name> --chain <chain>

Profit & loss

盈亏情况

zerion pnl <address|name>

All accept `--x402` (or `--mpp`) for pay-per-call without an API key.
zerion pnl <address|name>

所有命令均支持`--x402`（或`--mpp`）参数，无需API密钥即可按次付费调用。

Token search (find a contract address)

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

bash
zerion search <query>                               # by name, symbol, or address
zerion search <query> --chain <chain>
zerion search <query> --limit <n>                   # default 10
bash
zerion search <query>                               # 按名称、符号或地址搜索
zerion search <query> --chain <chain>
zerion search <query> --limit <n>                   # 默认10条结果

Watchlist (track addresses you don't own)

观察列表（追踪非本人持有地址）

Adds an address to a local watchlist so analysis commands can refer to it by name (
--watch <name>
).
bash
zerion watch <address|ens> --name <label>           # add (e.g. "vitalik.eth" --name vit)
zerion watch list                                   # list all watched
zerion watch remove <name>                          # remove
将地址添加到本地观察列表后，分析命令可通过名称（
--watch <name>
）引用该地址。
bash
zerion watch <address|ens> --name <label>           # 添加（例如 "vitalik.eth" --name vit）
zerion watch list                                   # 列出所有已关注地址
zerion watch remove <name>                          # 删除关注地址

Then use the watched name with any analysis command

之后可使用关注名称执行任意分析命令

zerion portfolio --watch vit zerion analyze --watch vit
undefined
zerion portfolio --watch vit zerion analyze --watch vit
undefined

Typical workflow

典型工作流程

  1. Run 
    zerion analyze <address>
    for the broad picture.
  2. Drill into specifics if needed:
    • DeFi-only: 
      zerion positions <address> --positions defi
    • Single chain: 
      zerion positions <address> --chain ethereum
    • More transactions: 
      zerion history <address> --limit 25
  3. For repeat monitoring, add to watchlist: 
    zerion watch <addr> --name <label>
    .
  1. 运行
    zerion analyze <address>
    获取整体概况。
  2. 如有需要深入查询细节：
    • 仅查看DeFi仓位：
      zerion positions <address> --positions defi
    • 单链查询：
      zerion positions <address> --chain ethereum
    • 查看更多交易记录：
      zerion history <address> --limit 25
  3. 如需重复监控，添加到观察列表：
    zerion watch <addr> --name <label>
    。

Output

输出

JSON on stdout, structured errors on stderr. See the 
zerion
umbrella skill for the error contract.
标准输出（stdout）返回JSON格式数据，标准错误输出（stderr）返回结构化错误信息。错误合约详情请查看
zerion
umbrella skill。

Pay-per-call

按次付费调用

--x402
(Base / Solana) and 
--mpp
(Tempo) work on every command in this skill. Trading commands do NOT support pay-per-call — always need an API key.
本技能中的所有命令均支持
--x402
（Base / Solana）和
--mpp
（Tempo）参数。交易类命令不支持按次付费调用——始终需要API密钥。

Common errors

常见错误

CodeCauseFix
missing_api_key
No 
ZERION_API_KEY
and no 
--x402
/
--mpp
Set the env var or pass the flag
unsupported_chain
Invalid 
--chain
zerion chains
for valid IDs
unsupported_positions_filter
Invalid 
--positions
Use 
all
, 
simple
, or 
defi
api_error
429		Rate limitedWait, reduce frequency, or switch to 
--x402
api_error
400		Invalid address or ENS resolution failureRetry with the resolved 0x address
Empty positions/history usually means the wallet is inactive or very new — not an error.
代码原因解决方法
missing_api_key
未设置
ZERION_API_KEY
且未传入
--x402
/
--mpp
参数		设置环境变量或传入对应参数
unsupported_chain
--chain
参数无效		执行
zerion chains
查看有效链ID
unsupported_positions_filter
--positions
参数无效		使用
all
、
simple
或
defi
api_error
429		请求频率受限等待一段时间、降低请求频率，或切换为
--x402
调用
api_error
400		地址无效或ENS解析失败使用解析后的0x格式地址重试
仓位/交易记录为空通常意味着钱包未活跃或刚创建——不属于错误。