nansen-holder-analysis について
Nansen CLIで、トークン保有者がスマートマネー系ウォレットか個人投資家中心かを調べるスキルです。保有者ラベルと資金フローデータを組み合わせ、調査コマンドの前に認証を求めます。
主な機能
- 01トークン保有者とウォレットラベルの確認
- 0224時間・7日・30日の残高変化の確認
- 03ウォレットラベル別の資金フロー比較
- 04新規ウォレット流入とスマートマネー保有の少なさを検出
活用シーン
- 01トークン保有者の質を評価
- 02新規ウォレット流入が多くスマートマネー保有が少ない状況を把握
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ nansen-ai/ nansen-cli --skill nansen-holder-analysisインストール後、Claude Code で/nansen-holder-analysisを入力して読み込まれたか確認します。
詳細
認証
ブラウザーログインでは、アカウント 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 は、明示的なユーザーの意図と支払い設定を必要とする、独立した有料ワークフローとして引き続き利用できます。この調査ワークフローを匿名で実行したり、認証失敗後に匿名アクセスへ切り替えたりしないでください。
保有者の質
回答する質問:「このトークンを保有しているのは、質の高いウォレットですか。それともノイズの多い個人投資家ですか?」
TOKEN=<address> CHAIN=ethereum
nansen research token holders --token $TOKEN --chain $CHAIN --smart-money --limit 20
# → address, address_label, value_usd, ownership_percentage, balance_change_24h/7d/30d
nansen research token flow-intelligence --token $TOKEN --chain $CHAIN
# → net_flow_usd and wallet_count per label: smart_trader, whale, exchange, fresh_wallets
nansen research token who-bought-sold --token $TOKEN --chain $CHAIN --limit 20
# → address, address_label, bought/sold_volume_usd, bought/sold_token_volume, trade_volume_usd
危険信号:fresh_wallets の資金フローが多く、SM 保有者が少ない状態です。好材料:上位 20 件に Fund/Smart Trader のラベルがあることです。
注:保有者エンドポイントはネイティブトークン/ラップドトークンに対応していません。特定のトークンコントラクトアドレスを使用してください。