nansen-perp-trader-profile について
Nansen CLIで無期限先物トレーダーのラベル、ポジション、取引履歴を調べるスキルです。プロファイラー情報とポジション・取引データを組み合わせ、段階的な建て増しや縮小などを分析できます。
主な機能
- 01アドレスのラベルとカテゴリを確認
- 02無期限先物ポジションを確認
- 03口座価値と使用証拠金を確認
- 04ポジションと取引履歴を照合
- 05ランキングでの相対順位を比較
活用シーン
- 01トレーダーの現在の無期限先物ポジションを確認
- 02ポジションを段階的に増やしているか減らしているか判断
- 03ランキングでの相対的な位置を比較
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ nansen-ai/ nansen-cli --skill nansen-perp-trader-profileインストール後、Claude Code で/nansen-perp-trader-profileを入力して読み込まれたか確認します。
詳細
認証
ブラウザーログインでは、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 キー注入を維持しますが、キーを必須にするゲートでも認証の証明でもありません。通常のクレジットと利用権が適用されます。ログインしてもクレジットは購入されません。ブラウザーログインは、macOS arm64 のプレビュー対象範囲内で CLI 2.0.0 から利用できます。
API キーとブラウザーセッションでは、同じ x402 の自動支払い動作が適用されます。サポート対象の HTTP 402 チャレンジにより、既存のウォレット認証、支払いポリシー、支出上限に従って、設定済みのウォレットから資金が支払われる場合があります。ループ内の呼び出しを含め、各呼び出しで支払いが発生する可能性があります。認証、認可、セッション更新の失敗によって支払いが発生することはありません。ログイン確認と nansen account も自動では支払いません。匿名 x402 は、ユーザーの明示的な意思と支払い設定を必要とする、個別の有料ワークフローとして引き続き利用できます。この調査ワークフローを匿名で実行したり、認証に失敗した後に匿名アクセスへ切り替えたりしないでください。
パーペチュアルトレーダー
回答する質問:「このパーペチュアルトレーダーは何をしていますか?ポジションと取引実績はどうなっていますか?」
ADDR=<address>
nansen research profiler labels --address $ADDR --chain ethereum
# → label, category (identity, SM labels)
nansen research profiler perp-positions --address $ADDR
# → asset_positions, margin_summary_account_value_usd, margin_summary_total_margin_used_usd
nansen research profiler perp-trades --address $ADDR --days 7 --limit 20
# → timestamp, token_symbol, side, action (Open/Close/Reduce), price, size, value_usd, closed_pnl, fee_usd
nansen research perp leaderboard --days 7 --limit 50
# → trader_address, total_pnl, roi, account_value (check if ADDR appears)
パーペチュアル取引とパーペチュアルポジションを相互参照し、トレーダーがポジションを増減しているか確認します。リーダーボードでは相対的な順位を確認できます。