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

トークンの発見

回答する質問：「トレンドに乗っていて、さらに詳しく調べる価値のあるトークンはどれですか？」

CHAIN=solana

# Screen top tokens by volume
nansen research token screener --chain $CHAIN --timeframe 24h --limit 20
# → token_symbol, price_usd, price_change, volume, buy_volume, market_cap_usd, fdv, liquidity, token_age_days

# Smart money only
nansen research token screener --chain $CHAIN --timeframe 24h --smart-money --limit 20

# Search within screener results (client-side filter over the fetched candidates).
# Check _meta.search: complete=false means lower-ranked tokens were not searched —
# widen with --limit 1000 or --paginate, or narrow with --filters.
nansen research token screener --chain $CHAIN --search "bonk"

# Smart money holdings — what SM wallets are holding
nansen research smart-money holdings --chain $CHAIN --labels "Smart Trader" --limit 20
# → token_symbol, value_usd, holders_count, balance_24h_percent_change, share_of_holdings_percent

# Nansen indicators for a specific token
TOKEN=<address>
nansen research token indicators --token $TOKEN --chain $CHAIN
# → risk_indicators, reward_indicators (each with score, signal, signal_percentile)

# Flow intelligence — only use for promising tokens from screener/indicators above
nansen research token flow-intelligence --token $TOKEN --chain $CHAIN
# → net_flow_usd per label: smart_trader, whale, exchange, fresh_wallets, public_figure

# Nansen Score Top Tokens — "what should I buy?" (account API endpoint; normal entitlements apply)
# Use this FIRST for discovery, then drill into individual tokens with `indicators` above
nansen research token top-tokens --limit 25
nansen research token top-tokens --market-cap largecap --limit 10
# → chain, token_address, token_symbol, performance_score, risk_score,
#   per-indicator contributions, market_cap_group, latest_date, last_trigger_on

スクリーナーの期間：5m、10m、1h、6h、24h、7d、30d

インジケーター：スコアは「強気」「弱気」「中立」のいずれかです。signal_percentile > 70 は、過去のデータと比べて有意な値であることを示します。一部のトークンではインジケーターが空で返されますが、これはエラーではありません。

トップトークン — Nansen Score のフィールドリファレンス

結果はサーバー側で performance_score >= 15 に事前フィルタリングされ、次の順に並べ替えられて返されます。

1. performance_score の降順
2. market_cap_group の優先順位（largecap → midcap → lowcap）
3. risk_score の降順
4. 24時間の出来高の降順

そのため、行 0 は適用したフィルターに対して常に最有力候補となり、クライアント側での順位付けは不要です。

時価総額の区分（並べ替えの優先順位と --market-cap フィルターの両方で使用）：

• lowcap：時価総額 < $100M
• midcap：時価総額 $100M – $1B
• largecap：時価総額 > $1B

各寄与は三値です。各フィールドの値は {negative, 0, positive} のいずれか1つのみで、部分的な値はありません。ゼロは「インジケーターが中立だった」ではなく、「そのトークンにはインジケーターが適用されなかった」（対象外）ことを意味します。 パフォーマンススコア（アルファ版 —「7～30日でBTCを上回る可能性が高い」） 範囲：-60 to +75（算術上の範囲です。単一のトークンがすべてのプラス指標を同時に満たすことはないため、実際の最大値は +45 に近い値です）。購入のしきい値：>= 15。以下の5つの *_performance フィールドの合計です。

フィールド	寄与度	トリガー	基礎となる指標が測定する内容
price_momentum_performance	+30 / 0	上流スコアが bullish → +30	大型株トークンと中小型株トークンそれぞれのしきい値に照らして評価した価格モメンタムです。
chain_fees_performance	+30 / 0	bullish（30日間の手数料増加率 > +1%）→ +30	ネットワーク手数料の30日間の支出モメンタム（日次リターンの幾何平均）です。一部のL1ネイティブトークン（例：ETH、TRX、AVAX、RON）のみが追跡対象です。それ以外のすべてのトークンでは常に0です。
trading_range_performance	+15 / 0	bullish（上昇トレンド中に価格がレジスタンスを上抜け）→ +15	14日間の価格トレンドと、最も近いサポート／レジスタンスに対する価格の位置を組み合わせた指標です。実際には、明確な価格水準がある確立されたトークンで主に発動します。時価総額を問わず発動する可能性がありますが、新規トークンや流動性の低いトークンではまれです。
chain_tvl_performance	0 / -35	bearish（TVLの複合増加率 < 0）→ -35	TVLモメンタムの複合シグナルです。TVLが追跡されているチェーン／L2でのみ0以外になります。プラスとなる経路はなく、このフィールドは減点のみです。
protocol_fees_performance	0 / -25	bearish（14日間の手数料増加率 < -3%）→ -25	14日間のプロトコル手数料モメンタムです。測定可能な手数料収益があるプロトコルに裏付けられたトークンでのみ0以外になります。プラスとなる経路はなく、減点のみです。

リスクスコア（安全性 —「下落中のナイフや危険な状況を除外」） 範囲：-60 to +80（算術上の範囲です）。安全性のしきい値：> 0（プラスはより安全、マイナスはよりリスクが高いことを示します）。以下の4つの *_risk フィールドの合計です。各リスクフィールドでは、上流スコアが low の場合はプラス寄与、high の場合はマイナス寄与、medium／欠損の場合は0です。

フィールド	寄与度	基礎となる指標が測定する内容
btc_reflexivity_risk	+40 / -20	BTCが3%超下落した日の、トークン下落率とBTC下落率の比率について、直近5イベントの中央値を算出します。比率 ≤ 1 → low → +40（下落局面でトークンがBTCと同程度、またはそれ以上に持ちこたえます）。比率 > 1 → high → -20（トークンがBTCより大きく下落します）。ステーブルコインと24時間取引高が<$1Mのトークンは対象外です。
liquidity_risk	+20 / -20	オンチェーン流動性と時価総額の比率（total_liquidity_usd / market_cap_usd）です。比率が高い → low → +20（時価総額に対して板が厚い）。比率が非常に低い → high → -20。
concentration_risk	+10 / -10	上位10保有者が供給量に占める割合です。< 0.12 → low → +10（広く分散）。> 0.55 → high → -10（大口保有者に集中）。
inflation_risk	+10 / -10	トークン供給量のインフレ率の日次EMAです。マイナス／ほぼゼロ → low → +10（供給量が安定、またはデフレ傾向）。大幅なプラス → high → -10（希薄化が大きい）。時価総額が$100M以上のトークンのみ評価対象です。

その他のレスポンスフィールド：

• market_cap_group：lowcap / midcap / largecap — 上記のしきい値を参照してください。
• latest_date：このトークンの指標が最後に更新された日時を示すISO日時です。
• last_trigger_on：寄与する指標全体で最後にトリガーが発生した日時を示すISO日時です（集約値はMAXです。この日時が新しく見えても、個々の指標が数日から数か月更新されていない場合があります）。指標ごとの経過時間を確認するには、特定のトークンに対して indicators を使用してください。

ステーブルコインは高スコアになりますが、買い候補ではありません。 USDC、USDT、DAI、FDUSDなどはchain_feesとliquidityの指標で高評価になりますが、「何を買うべきか」という問いへの対象ではありません。indicators を詳しく確認する前に、標準のホワイトリスト nansen-dbt-ch-tokens/seeds/stablecoins_for_indicator.csv を使って候補リストから除外してください。

一般的なワークフロー：まず top-tokens で候補リストを作成 → ステーブルコインを除外 → 上位3～5件に対して indicators を実行し、個々のシグナルとそのsignal_percentileを確認 → 最終候補のみに flow-intelligence を実行して、SMの確信度を確認します。 上記のフィールドの意味とコントリビューションの対応関係は、nansen-dbt-ch-tokens/models/indicators/api_nansen_score_indicators_all_tokens_latest.sql と各インジケーターのモデル yml ファイルを参照しています。符号の向きと実際の値の範囲は、本番の ClickHouse データで検証しました。

フローインテリジェンスはクレジットを多く消費します。すべてのトークンを最初から調べるのではなく、スクリーナーとインジケーターですでに有望に見えるトークンについて、SM の確信度を確認するために使ってください。