nansen-wallet-profiler

認証

ブラウザログインでは、API キーと同等のアカウント API 権限を得るために nansen:api を要求します。既存の OAuth／MCP における nansen:read のセマンティクスと、個別のウォレット認証は変更されません。

調査コマンドやループを実行する前に、明示的に選択した API キーまたは保存済みブラウザーセッションが必要です。最初に nansen auth status を実行してください。キャッシュされた未検証のメタデータは、認証情報の有効性やストレージのロック解除を証明するものではありません。キャッシュされたアクセストークンの有効期限が切れていても、それだけでセッションが使用不能とは限りません。CLI は通常、すでに認証済みの調査タスク中に、追加の同意要求や別途のアカウント確認なしで、選択されたセッションを自動的に更新します。匿名アクセスが選択されている場合、認証状態が無効な場合、更新やクリーンアップがブロックされているか不確かな場合、または更新権限の拒否や期限切れを含む実際の認証失敗が発生した場合は、停止してください。CLI のエラーガイダンスに従ってください。トラブルシューティングで指示された場合は、無料の nansen account チェックを使用してください。失敗したキーを解除したり、セッションを消去したり、再試行のために匿名アクセスへ切り替えたりしないでください。

ドキュメントに記載されたプラットフォームの範囲内で新たにブラウザー承認を行うには nansen login を使用するか、一般的な API キーを設定してください。NANSEN_API_KEY は保存済みセッションより優先されます。OpenClaw のオプションの primaryEnv マッピングは、設定済みの API キー注入を維持するためのものであり、キーを必須にするゲートでも認証の証明でもありません。通常のクレジットと利用資格が適用されます。ログインしてもクレジットは購入されません。ブラウザログインは CLI 2.0.0 で、macOS arm64 のプレビュー範囲内で利用できます。

API キーとブラウザーセッションでは、同じ x402 自動支払い動作が適用されます。サポートされている HTTP 402 チャレンジでは、既存のウォレット認証、支払いポリシー、支出上限に従って、設定済みのウォレットから資金を支払うことがあります。ループ内の呼び出しを含め、各呼び出しで支払いが発生する可能性があります。認証、認可、セッション更新の失敗によって支払いが実行されることはありません。また、ログインの検証と nansen account によって自動的に支払いが行われることもありません。匿名 x402 は、ユーザーの明示的な意図と支払い設定が必要な、別個の有料ワークフローとして引き続き利用できます。この調査ワークフローを匿名で実行したり、認証に失敗した後で匿名アクセスに切り替えたりしないでください。

ウォレットプロファイラー

すべてのコマンド：nansen research profiler <sub> [options]

ほとんどのコマンドで --address と --chain が必須です。

残高とアイデンティティ

nansen research profiler balance --address <addr> --chain ethereum
nansen research profiler labels --address <addr> --chain ethereum
nansen research profiler search --query "Vitalik"

損益

nansen research profiler pnl --address <addr> --chain ethereum --days 30
nansen research profiler pnl-summary --address <addr> --chain ethereum

トランザクションと履歴

nansen research profiler transactions --address <addr> --chain ethereum --limit 20
nansen research profiler historical-balances --address <addr> --chain solana --days 30

関連性

nansen research profiler related-wallets --address <addr> --chain ethereum
nansen research profiler counterparties --address <addr> --chain ethereum --days 30

# Counterparties for up to 10 wallets in one call (max --days 90).
# Results are not aggregated — every row carries the wallet_address it belongs to.
# One ecosystem per request: EVM and Solana addresses cannot be mixed; `all` auto-detects it.
# --chain also takes any single chain the profiler serves, EVM or not: arbitrum, arc,
# avalanche, base, bitcoin, bnb (`bsc` is accepted too), ethereum, hyperevm, injective,
# iotaevm, linea, mantle, mantra, monad, near, optimism, plasma, polygon, robinhood, sei,
# solana, sonic, starknet, sui, ton, tron.
# Rows come back as contiguous per-wallet blocks ordered by wallet address, so a small page
# holds one wallet only — raise --limit and page with --page N to reach later wallets.
nansen research profiler counterparties-batch --addresses "0xabc,0xdef" --days 30 --limit 50

無期限先物（--chain なし）

nansen research profiler perp-positions --address <addr>
nansen research profiler perp-trades --address <addr> --days 7

一括処理、トレース、比較

# Batch — profile multiple wallets at once
nansen research profiler batch \
  --addresses "0xabc,0xdef" --chain ethereum \
  --include labels,balance,pnl

# Trace — BFS multi-hop counterparty trace (makes N*width API calls)
nansen research profiler trace --address <addr> --chain ethereum --depth 2 --width 5

# Compare — shared counterparties and tokens between two wallets
nansen research profiler compare --addresses "0xabc,0xdef" --chain ethereum

フラグ

フラグ	目的
--address	ウォレットアドレス（必須）
--chain	無期限先物と検索を除き必須
--days	遡る期間（デフォルトは 30）
--limit	結果数
--addresses	batch、compare、counterparties-batch 用の、カンマ区切りのウォレット
--include	一括処理のフィールド：labels,balance,pnl
--depth	トレースの深さ 1～5（デフォルトは 2）
--width	トレースの幅 — クレジット節約のため小さくしてください
--fields	特定のフィールドを選択
--table	人が読みやすい表形式の出力
--format csv	CSV エクスポート

注意事項

• pnl-summary はページネーションに対応していません（リストではなく集計統計を返します）。
• perp-positions はページネーションに対応していません。
• labels はページネーションに対応しています。--limit／--page が適用され、レスポンスは {pagination: {page, per_page, is_last_page}, data[]: {label, category, kind[]}} です。
• transactions の per_page は 100 が上限です（API の上限）。
• trace は多数の API 呼び出しを行うため、--width は控えめに設定してください。
• batch では、--addresses の代わりに、1 行につき 1 つのアドレスを記載した --file <path> を指定できます。