mcpField
N
nansen-wallet-deep-dive

nansen-wallet-deep-dive

github.com/nansen-aiデータ・データベース144384 回インストール今日更新
リポジトリ

nansen-wallet-deep-dive について

nansen-wallet-deep-diveは、Nansen CLIでウォレットの身元、保有資産、活動を調べるスキルです。profilerの照会に、明示的な認証と支払いの保護策を組み合わせています。

主な機能

  1. 01ウォレットのラベルと分類の照会
  2. 02トークン残高と価値の照会
  3. 03無期限先物ポジションの照会
  4. 04認証と支払いの保護策

活用シーン

  1. 01ウォレットのラベルと分類の特定
  2. 02トークン保有量と米ドル価値の確認
  3. 03Hyperliquidの未決済ポジションの確認

MCP 対応

READMEでは既存のOAuth/MCP `nansen:read` の仕様は変更されないと説明されています。このスキルは `nansen` CLIを使った調査を案内します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-wallet-deep-dive

インストール後、Claude Code で/nansen-wallet-deep-diveを入力して読み込まれたか確認します。

詳細

認証

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

ウォレット分析

回答する質問：「このウォレットの持ち主は誰で、どのような活動をしてきたのか？」

ADDR=<address> CHAIN=ethereum

nansen research profiler labels --address $ADDR --chain $CHAIN
# → label, category (e.g. "Smart Trader", "Fund", "Public Figure", ENS names)

nansen research profiler balance --address $ADDR --chain $CHAIN
# → token_symbol, token_name, token_amount, price_usd, value_usd per holding

nansen research profiler pnl-summary --address $ADDR --chain $CHAIN --days 30
# → realized_pnl_usd, realized_pnl_percent, win_rate, traded_token_count, traded_times, top5_tokens

nansen research profiler transactions --address $ADDR --chain $CHAIN --limit 20
# → block_timestamp, method, tokens_sent, tokens_received, volume_usd, source_type

nansen research profiler perp-positions --address $ADDR
# → asset_positions, margin_summary_account_value_usd, margin_summary_total_margin_used_usd

nansen research profiler counterparties --address $ADDR --chain $CHAIN --days 30
# → counterparty_address, counterparty_address_label, interaction_count, total_volume_usd, volume_in/out_usd

perp-positions は Hyperliquid のデータを返します。ウォレットに未決済の無期限先物ポジションがない場合は、空の結果を返します。

コメント

Markdown 対応