zerion-analyze

Zerion — ウォレット分析

14 の EVM チェーンと Solana にわたる、あらゆる暗号資産ウォレットの読み取り専用インサイトです。すべてのコマンドで、0x... アドレス、ENS 名（例：vitalik.eth）、ローカルのウォレット名、またはウォッチ中のアドレスを指定できます。

セットアップ

zerion コマンドで command not found エラーが発生した場合は、一度だけインストールしてください。

npm install -g zerion-cli

Node.js ≥ 20 が必要です。認証（API キー / 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>

すべてのコマンドで、API キーなしの従量課金に --x402（または --mpp）を指定できます。

--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 に反映されます（そのため、Aave で USDC を 4,000 ドル供給し、DAI を 300 ドル借り入れているウォレットでは、net_value: 3700 と報告されます）。総エクスポージャーには gross_value を使用してください。
• 同じ group_id を持つ LP トークンは、1 つの groups[] エントリーにまとめられます（Uniswap の USDC/WETH プールは、無関係な 2 行ではなく、2 つのトークンを含む 1 つのグループとして返されます）。
• 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、標準エラー出力には構造化されたエラーが出力されます。エラーの仕様については、zerion のアンブレラ・スキルを参照してください。

従量課金

このスキルのすべてのコマンドで、--x402（Base / Solana）および --mpp（Tempo）を使用できます。トレーディングコマンドは従量課金に対応していないため、常に API キーが必要です。

よくあるエラー

コード	原因	解決方法
missing_api_key	ZERION_API_KEY が設定されておらず、--x402 / --mpp も指定されていない	環境変数を設定するか、フラグを指定してください
unsupported_chain	--chain が無効	有効な ID は zerion chains で確認してください
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 アドレスで再試行してください

ポジションや履歴が空の場合、通常はウォレットが未使用か、作成されたばかりであることを意味し、エラーではありません。