zerion-analyze
Read-only crypto wallet insights via the Zerion CLI: portfolio value, token holdings, DeFi positions, transaction history, PnL, and watchlist management. Use whenever the user asks 'what's in this wallet', 'how is X doing', portfolio/PnL/positions/transactions for any address, ENS name, local wallet, or watched address. Supports x402 / MPP pay-per-call. Pair with `zerion-trading` for execution after analysis.
How do I install this agent skill?
npx skills add https://github.com/zeriontech/zerion-ai --skill zerion-analyzeIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides tools for analyzing cryptocurrency wallet data using the Zerion CLI. It allows for checking portfolios, DeFi positions, and transaction history across multiple blockchain networks.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
Zerion — Wallet Analysis
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.
Setup
If a zerion command fails with command not found, install once:
npm install -g zerion-cli
Requires Node.js ≥ 20. For auth (API key / x402 / MPP) see the 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.
Full analysis (recommended starting point)
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.
Targeted reads
# 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>
All accept --x402 (or --mpp) for pay-per-call without an API key.
--defi output shape
zerion positions <addr> --defi returns positions grouped by protocol with loans netted:
{
"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": [...] }
]
}
]
}
Key behaviors:
- Loans net against deposits in
net_value(so an Aave wallet with $4k USDC supplied and $300 DAI borrowed reportsnet_value: 3700). Usegross_valuefor total exposure. - LP tokens with the same
group_idcollapse into onegroups[]entry (a Uniswap USDC/WETH pool returns one group with two tokens, not two unrelated rows). position_type∈deposit | loan | staked | locked | reward | wallet | investment— tag each row for downstream filtering.- Combining
--defiwith--positions all|simpleerrors withconflicting_flags.
Token search (find a contract address)
zerion search <query> # by name, symbol, or address
zerion search <query> --chain <chain>
zerion search <query> --limit <n> # default 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>).
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
Typical workflow
- Run
zerion analyze <address>for the broad picture. - Drill into specifics if needed:
- DeFi grouped by protocol:
zerion positions <address> --defi(loans netted, LP tokens pooled bygroup_id) - DeFi flat list:
zerion positions <address> --positions defi - Single chain:
zerion positions <address> --chain ethereum(or--chain monad) - More transactions:
zerion history <address> --limit 25
- DeFi grouped by protocol:
- For repeat monitoring, add to watchlist:
zerion watch <addr> --name <label>.
Output
JSON on stdout, structured errors on stderr. See the zerion umbrella skill for the error contract.
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.
Common errors
| Code | Cause | Fix |
|---|---|---|
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 |
conflicting_flags | --defi combined with --positions all|simple | Pick one — --defi already implies --positions defi |
api_error 429 | Rate limited | Wait, reduce frequency, or switch to --x402 |
api_error 400 | Invalid address or ENS resolution failure | Retry with the resolved 0x address |
Empty positions/history usually means the wallet is inactive or very new — not an error.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/zeriontech/zerion-ai/zerion-analyze">View zerion-analyze on skillZs</a>