mcpField
N
nansen-token-research

nansen-token-research

github.com/nansen-aiその他144436 回インストール今日更新
リポジトリ

nansen-token-research について

Nansen CLIで暗号資産トークンを調査するスキルです。現物・パーペチュアル市場の価格、保有者、資金フロー、パフォーマンスを追う分析担当者向けで、認証を伴う利用方法も説明します。

主な機能

  1. 01トークン情報とOHLCV
  2. 02保有者とスマートマネーの分析
  3. 03トークンのフローと取引の照会
  4. 04現物・パーペチュアルの損益データ
  5. 05CSVとテーブル形式の出力

活用シーン

  1. 01トークン価格の時間軸比較
  2. 02スマートマネーの保有とフローの確認
  3. 03DEX取引とトークン損益の調査

MCP 対応

READMEでは既存のOAuth/MCP `nansen:read` 権限は変更されないと説明されています。このスキル自体はNansen CLIの調査コマンドを扱います。

インストール

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

$npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-token-research

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

詳細

認証

ブラウザログインでは、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 token <sub> [options]

スポットエンドポイントでは --chain が必須です。トークン固有のエンドポイントでは --token <address> を使用してください。

情報と価格

nansen research token info --token <addr> --chain solana
nansen research token ohlcv --token <addr> --chain solana --timeframe 1h

時間足：1m、5m、15m、30m、1h、2h、4h、1d、1w、1M

保有者

nansen research token holders --token <addr> --chain solana
nansen research token holders --token <addr> --chain solana --smart-money

フロー

nansen research token flows --token <addr> --chain solana --days 7
nansen research token flow-intelligence --token <addr> --chain solana
nansen research token who-bought-sold --token <addr> --chain solana

flow-intelligence では、ラベル別に内訳を表示します：クジラ、スマートトレーダー、取引所、新規ウォレット、公人。

DEX 取引

nansen research token dex-trades --token <addr> --chain solana --limit 20

損益

nansen research token pnl --token <addr> --chain solana --sort total_pnl_usd:desc

パーペチュアル（--chain なし）

nansen research token perp-trades --symbol ETH --days 7
nansen research token perp-positions --symbol BTC
nansen research token perp-pnl-leaderboard --symbol SOL

フラグ

フラグ用途
--chainスポットエンドポイントで必須（ethereum、solana、base など）
--tokenトークンアドレス（別名：--token-address）
--symbolパーペチュアルエンドポイント用のトークンシンボル（例：BTC）
--timeframeOHLCV の間隔
--smart-moneySM ウォレットのみを対象に絞り込み（保有者）
--days遡る期間（デフォルト：30）
--sortソートフィールド：方向（例：total_pnl_usd:desc）
--fields特定のフィールドを選択
--table人が読みやすい表形式で出力
--format csvCSV にエクスポート

注記

  • パーペチュアルエンドポイントでは --token ではなく --symbol（例：BTC）を使用します。
  • holders --smart-money は、SM トラッキングに対応していないトークンに対して UNSUPPORTED_FILTER を返します。
  • flow-intelligence は、流動性の低いトークンについて、すべてゼロのフローを返す場合があります。

コメント

Markdown 対応