トークン検出

答える質問： 「どのトークンがトレンド中で、より深く調べる価値があるのか？」

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)
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?" (public endpoint, any authenticated API key)
# 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

インジケーター：スコアは「bullish」「bearish」「neutral」のいずれか。signal_percentile > 70 = 歴史的に有意。空のインジケーターを返すトークンもあり（エラーではありません）。

トップトークン — Nansenスコアフィールド参照

結果はサーバー側で 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} のいずれか）。部分値はありません。ゼロは「このトークンにインジケーターが適用されなかった」（スコープ外）を意味し、「インジケーターが中立だった」ではありません。

パフォーマンススコア（アルファ — 「7～30日でBTCをアウトパフォームする可能性が高い」） 範囲：-60 から +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のみ非ゼロ。正のパスは存在しないため、このフィールドは減算のみ。
protocol_fees_performance	0 / -25	bearish（14日間のフィー成長 < -3%）→ -25	14日間のプロトコル手数料モメンタム。測定可能なフィー収益を持つプロトコルが支持するトークンのみ非ゼロ。正のパスなし（減算のみ）。

リスクスコア（安全性 — 「落ちるナイフをフィルタリング/危険な設定」） 範囲：-60 から +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+流動性インジケーターで高スコアですが、「何を買うべき？」の意味ではありません。ドリルダウンする前に、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データに対して検証されました。

Flow intelligenceはクレジット多消費です。すべてのトークンの最初のパスではなく、スクリーナー+インジケーターからすでに有望に見えるトークンのSM確信を確認するためにのみ使用します。