nansen-wallet-clustering

認証

ブラウザログインでは、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 は、明示的なユーザーの意思と支払い設定を必要とする、独立した有料ワークフローとして引き続き利用できます。この調査ワークフローを匿名で実行したり、認証失敗後に匿名アクセスへ切り替えたりしないでください。

ウォレットの帰属関係

回答する質問：「このウォレットを管理しているのは誰ですか？ これらのウォレットに関連性はありますか？」

チェーン：0x → --chain ethereum（base、arbitrum、optimism、polygon も指定できます）。Base58 → --chain solana。

ADDR=<address> CHAIN=<ethereum|solana|base|...>  # detect from address format above
# 1. Identity
nansen research profiler labels --address $ADDR --chain $CHAIN
# 2. Related wallets (paginate with --page N)
nansen research profiler related-wallets --address $ADDR --chain $CHAIN
# 3. Counterparties (paginate with --page N; widen with --days 365 if empty)
nansen research profiler counterparties --address $ADDR --chain $CHAIN --days 90
# 3b. Once a cluster is confirmed: counterparties for up to 10 of its wallets in one call
#     (max --days 90; one ecosystem per request — EVM and Solana cannot be mixed). Rows are
#     contiguous per-wallet blocks ordered by wallet address: raise --limit and page with
#     --page N to reach later wallets.
nansen research profiler counterparties-batch --addresses "addr1,addr2" --chain $CHAIN --days 90 --limit 50
# 4. Batch profile cluster
nansen research profiler batch --addresses "addr1,addr2" --chain $CHAIN --include labels,balance,pnl
# 5. Compare pairs → shared_counterparties, shared_tokens, balances
nansen research profiler compare --addresses "addr1,addr2" --chain $CHAIN
# 6. Historical balances (fingerprint drained wallets)
nansen research profiler historical-balances --address $ADDR --chain $CHAIN --days 90
# 7. Multi-hop trace (credit-heavy — keep --width ≤3)
nansen research profiler trace --address $ADDR --chain $CHAIN --depth 2 --width 3

**調査範囲の拡大：**シードアドレスでステップ 1～2 を実行します。新たなアドレスが見つかった場合は、問い合わせる前に人間に確認してください。ステップ 3 はシードアドレスのみに限定します。 **停止条件：**既知のプロトコル／CEX · 信頼度が低い · すでに確認済み · クラスターが 10 ウォレットを超える。 **信頼度：**高＝最初の資金提供者／Safe 署名者の共有／同じ CEX への入金。中＝協調的な資金移動／関連ウォレットとラベルの一致。除外＝ENS のみ、CEX からの出金が 1 回のみ、デプロイヤーが 1 つのみ。 帰属関係の詳細なルールは REFERENCE.md を参照してください。