nansen-token-screener

身份验证

浏览器登录会请求 nansen:api，以获取相当于 API 密钥的账户 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

指标：score 为 “bullish”（看涨）、“bearish”（看跌）或 “neutral”（中性）。signal_percentile > 70 表示具有历史显著性。部分代币返回的指标为空，这不代表出错。

热门代币 — Nansen Score 字段参考

结果已在服务端预先筛选为 performance_score >= 15，并按以下顺序排序：

1. performance_score 降序
2. market_cap_group 优先级（largecap → midcap → lowcap）
3. risk_score 降序
4. 24h 成交量降序

因此，对于你应用的筛选条件，第 0 行始终是最强候选项，无需在客户端重新排序。

市值区间（用于排序优先级和 --market-cap 筛选器）：

• lowcap：市值 < $100M
• midcap：市值 $100M – $1B
• largecap：市值 > $1B

每项贡献都是三值的——每个字段恰好取 {negative, 0, positive} 中的一个值，不存在部分值。0 表示“该指标不适用于此代币”（超出适用范围），而不是“指标为中性”。 表现评分（Alpha——“预计在未来 7–30 天跑赢 BTC”） 范围：-60 to +75（算术边界；实时最高值更接近 +45，因为没有单个代币能同时满足所有正向指标）。买入阈值：>= 15。以下五个 *_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 to +80（算术边界）。安全阈值：> 0（正值 = 更安全，负值 = 风险更高）。以下四个 *_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 等稳定币在链上费用 + 流动性指标上的得分不错，但这并不是“我应该买什么”所指的对象。在深入查看 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 的确信，而不要将其作为筛查每个代币的第一步。