nansen-perp-screener

認証

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

Perp Market Scan

回答: 「現在の Hyperliquid の無期限先物市場の状況は？」

nansen research perp screener --sort volume:desc --limit 20
# → token_symbol, volume, buy/sell_volume, buy_sell_pressure, open_interest, funding, mark_price

nansen research perp leaderboard --days 7 --limit 20
# → trader_address, trader_address_label, total_pnl, roi, account_value

nansen research smart-money perp-trades --limit 20
# → token_symbol, side, action (Open/Close), value_usd, price_usd, trader_address_label

新しいフィルター（ECINT-6680）

--trader-type

トレーダーの種類でフィルターします。指定できる値：all（デフォルト）、sm、whale、public_figure、high_winrate_hl_perps_trader。

# Show only whale traders
nansen research perp screener --trader-type whale --limit 10

# Show only smart money traders
nansen research perp screener --trader-type sm --limit 20

# Show high win-rate HL perps traders
nansen research perp screener --trader-type high_winrate_hl_perps_trader --limit 20

--sm-label-filter

フィルターに使用する Nansen SM ラベルをカンマ区切りで指定します。--trader-type が all または sm の場合にのみ適用されます。

# Filter to a specific SM label
nansen research perp screener --trader-type sm --sm-label-filter "30D Smart Trader"

# Multiple labels
nansen research perp screener --sm-label-filter "30D Smart Trader,Smart LP"

--trader-label-filter

フィルターに使用する HL 無期限先物トレーダーのラベルをカンマ区切りで指定します。--trader-type が all または sm の場合にのみ適用されます。

# Filter to HL Perps Whale label
nansen research perp screener --trader-label-filter "HL Perps Whale"

--sectors-filter

セクターでコインをフィルターするための category:subcategory ペアをカンマ区切りで指定します。

# Filter to AI and DeFi crypto sectors
nansen research perp screener --sectors-filter "Crypto:AI,Crypto:DeFi" --trader-type whale

# Combine with trader type and limit
nansen research perp screener --sectors-filter "Crypto:AI,Crypto:DeFi" --trader-type whale --limit 10 --sort volume:desc

組み合わせた例

# Whale traders in AI crypto, sorted by volume
nansen research perp screener --trader-type whale --sectors-filter "Crypto:AI" --sort volume:desc --limit 10

# Smart money with specific label, last 7 days
nansen research perp screener --trader-type sm --sm-label-filter "30D Smart Trader" --days 7 --limit 20

# All traders in TradFi stocks sector
nansen research perp screener --sectors-filter "TradFi:Stocks" --sort open_interest:desc --limit 20