筛选器

GET /screener
筛选器

按某一 24 小时指标对资产或主体排序,并用其他指标进行筛选:share、share change、posts、net bullish posts(bullish 减去 bearish;负值表示 bearish)或 24 小时价格变化。范围均为闭区间且可组合使用;价格筛选仅适用于资产。

占比是指同一市场(股票、加密货币,或人物与话题)在同一 24 小时内全部帖子中所占的比例,已排除机器人;使用 clusters 时,则指这些集群所发内容中的占比。

参数规则:

  • asset_class 仅适用于 kind=asset。
  • 诸如 wallstreetbets 这样的发帖社区仅在接受 kind=asset 为 asset_class equity、commodity 或 index 时可用。
  • 每个最小值都不得大于其最大值。
  • 价格排序和价格范围需要 kind=asset。

钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/screener 使用。无需 Nebula 账户或 API key;签名前请先查看支付报价。x402 支付指南。

参数

kind string QUERY

要排名的对象:asset(股票、大宗商品、指数或加密货币)或 subject(人物、账户和话题)。默认为 asset。

允许的值
assetsubject

Default:asset

asset_class string QUERY

当 kind=asset 时,指定要排名的市场:equity(默认)、commodity、index 或 crypto。

允许的值
equitycommodityindexcrypto

Default:equity

clusters array<string> QUERY

要读取的作者集群;重复传入可组合,例如 clusters=kols&clusters=media。所选集群会合并计算,一个作者可以属于多个集群。

  • Callers:smart_money(表现最好的 caller)、dumb_money(表现最差的)、top_degens(小市值加密货币上表现最好的)
  • Timing:early_movers(在关注度上升时最先谈论某资产)、late_movers(在峰值时或之后才入场)
  • Builders:developers、founders、team_leaders、project_accounts
  • Institutions:vcs、asset_managers、dao_guild_funds、incubators、exchanges
  • Influence:kols、celebrities、media、marketer、shiller
  • Analysts:ta_analyst、fa_analyst、macro_analyst、onchain_analyst、investigators
  • Traders:position_trader、swing_trader、day_trader
  • Bias:perma_bull、doomer、tribalist
  • Other:political、nft、bots、automated_ai
  • Communities,按发帖位置划分:wallstreetbets、reddit

Example:smart_money

sort string QUERY

用于排序的指标。默认为 share。

允许的值
shareshare_changeshare_change_pctpostsnet_bullish_postsprice_change_24h_pct

Default:share

order string QUERY

desc(默认值)将最高值排在最前;asc 将最低值排在最前。

允许的值
descasc

Default:desc

limit integer QUERY

返回的最大结果数。

Default:25

min_share number QUERY

保留 share 至少占对话这一比例的结果,取值范围为 0 到 1。

Example:1

max_share number QUERY

保留 share 至多占对话这一比例的结果,取值范围为 0 到 1。

Example:1

min_share_change number QUERY

保留 share 相比前 24 小时至少上升这么多的结果,以 -1 到 1 的分数表示:0.01 即一个百分点。

Example:1

max_share_change number QUERY

保留 share 变化幅度至多为这么多的结果,以 -1 到 1 的分数表示;负值会选出正在失去 share 的结果。

Example:1

min_posts integer QUERY

保留在这 24 小时内至少有这么多 posts 的结果。按 price_change_24h_pct 排序时默认为 5。

Example:1

min_net_bullish_posts integer QUERY

保留 bullish posts 比 bearish posts 至少多这么多的结果;负值允许出现 bearish 结果。

Example:1

max_net_bullish_posts integer QUERY

保留 bullish posts 比 bearish posts 至多多这么多的结果;负值会选出 bearish 结果。

Example:1

min_price_change_24h_pct number QUERY

保留 24 小时价格变化至少为这么多百分比的资产。

Example:1

max_price_change_24h_pct number QUERY

保留 24 小时价格变化至多为这么多百分比的资产。

Example:1

cURL 示例

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/screener' \
  --header 'X-API-Key: YOUR_API_KEY'

响应

200 OK
400 错误请求
401 未授权
402 Credits 已用尽;响应中包含续期时间和已购买的 credit 余额
403 禁止访问
404 未找到
405 方法不被允许;Allow 响应头列出了支持的方法
429 请求过多
500 内部服务器错误
503 服务不可用

媒体类型 application/json

asset_class
string 可选

资产排名所属的市场;对于 subject 则不存在。

clusters
array<string> 必填

被统计帖子的作者聚类,已规范化;当统计了除机器人以外的所有作者时为空。

from
string (date-time) 必填

所排名 24 小时的 UTC 起始时间。对比窗口为其之前的 24 小时。

kind
string 必填

排名对象:按请求指定的 asset 或 subject。

允许的值
assetsubject
previous_total_posts
integer (int64) 必填

排名总体在过去 24 小时内的所有帖子。

results
array<object> 必填

排名结果,最优者在前。

results[].asset_class
string 可选

资产的类别:equity(股票和 ETF)、commodity、index 或 crypto。在每个资产范围的请求中都要与 asset_id 一同发送。

允许的值
equitycommodityindexcrypto
results[].asset_id
string 可选

规范的公开资产标识符:股票、商品和指数的股票代码或市场符号,以及加密货币的 CoinGecko slug(若无 slug,则为数字 id)。

results[].bearish_posts
integer (int64) 必填

被归类为看跌的帖子。

results[].bullish_posts
integer (int64) 必填

被归类为看涨的帖子。

results[].kind
string 必填

结果类型:asset(使用 asset_id 和 asset_class 查询)或 subject(使用 subject_id 查询)。

允许的值
assetsubject
results[].name
string 必填

人类可读的名称。

results[].neutral_posts
integer (int64) 必填

被归类为中性的帖子。

results[].posts
integer (int64) 必填

此结果在所排名 24 小时内的帖子。

results[].previous_posts
integer (int64) 必填

此结果在紧邻的等长窗口内的帖子。

results[].price_change_24h_pct
number (double) 可选

24 小时内的原始市场价格变化,以百分点计。

results[].share
number (double) 必填

此结果的帖子在同一 24 小时内占排名总体所有帖子的比例,取值 0 到 1。

results[].share_change
number (double) 可选

份额相对上一窗口的变化,以小数表示:0.01 为一个百分点。仅当总体在上一窗口没有帖子时不存在。

results[].share_change_pct
number (double) 可选

份额相对上一窗口份额的变化,以百分比计。当此结果在上一窗口没有帖子时不存在。

results[].subject_id
string 可选

非资产的人物、账户或主题的规范标识符。

results[].symbol
string 可选

显示的股票代码或市场符号。

to
string (date-time) 必填

所排名 24 小时的 UTC 结束时间:排名计算的时间。

total_posts
integer (int64) 必填

排名总体在 24 小时内的所有帖子:share 的分母。

{
  "asset_class": "equity",
  "clusters": [],
  "from": "2026-08-06T15:00:00Z",
  "kind": "asset",
  "previous_total_posts": 17205,
  "results": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "bearish_posts": 61,
      "bullish_posts": 214,
      "kind": "asset",
      "name": "NVIDIA Corporation",
      "neutral_posts": 111,
      "posts": 386,
      "previous_posts": 273,
      "price_change_24h_pct": -2.48,
      "share": 0.025255,
      "share_change": 0.009388,
      "share_change_pct": 59.16,
      "symbol": "NVDA"
    },
    {
      "asset_class": "equity",
      "asset_id": "AMZN",
      "bearish_posts": 30,
      "bullish_posts": 92,
      "kind": "asset",
      "name": "Amazon.com, Inc.",
      "neutral_posts": 63,
      "posts": 185,
      "previous_posts": 165,
      "price_change_24h_pct": -0.32,
      "share": 0.012104,
      "share_change": 0.002516,
      "share_change_pct": 26.24,
      "symbol": "AMZN"
    }
  ],
  "to": "2026-08-07T15:00:00Z",
  "total_posts": 15284
}