全部文档 Nebula 文档 所有端点 交互式文档 Markdown OpenAPI JSON
  1. REST API
  2. 聚类

聚类对比

GET /clusters/comparison
CompareClusters

在窗口内并排比较每个作者集群：帖子数及其变化、相对市场的看涨程度（cluster_bullish_share 对 market_bullish_share）、过去 7 天最常转向的资产（trending_asset），以及每日帖子数。

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

参数

asset_class array<string> QUERY

要比较的市场：equity、commodity、index 和 crypto 中的任意组合，以逗号分隔。默认为全部四个。可发送多个，以逗号分隔。

Default:equity,commodity,index,crypto

days integer QUERY

从最近一个完整 UTC 日往前计算，要比较的完整 UTC 天数：7、30 或 90。activity_change_pct 会与此前相同天数的数据比较。免费套餐可回溯 90 天；更早的请求返回 403。

允许的值
73090

Default:30

cURL 示例

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

响应

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

媒体类型 application/json

asset_classes
array<string> 必填

所分析的市场，按 equity、commodity、index、crypto 的顺序：即所请求的 asset_class 值；若省略 asset_class，则为全部四个。

clusters
array<object> 必填

窗口内有帖子的每个集群，帖子数最多的在前。
clusters[].activity_change_pct
number (double) 必填

相对等长上一窗口的帖子数百分比变化（84 之后为 76 则记 -9.52）；无法比较时缺省。

clusters[].bearish_posts
integer (int64) 必填

该集群在窗口内的看跌帖子数。

clusters[].bullish_posts
integer (int64) 必填

该集群在窗口内的看涨帖子数。

clusters[].cluster_bullish_share
number (double) 必填

该集群在窗口内的看涨帖子数 ÷（看涨 + 看跌）帖子数，取值 0 到 1。无看涨或看跌帖子时为 null。

clusters[].cluster_id
string 必填

规范的作者集群标识符。

clusters[].market_bullish_share
number (double) 必填

该集群所解读市场在相同天数和资产类别下的同一占比（发帖社区对应 equity 市场）：即 cluster_bullish_share 所比较的基准。无看涨或看跌帖子时为 null。

clusters[].posts
integer (int64) 必填

该集群在窗口内的帖子数。

clusters[].series
array<object> 必填

窗口内每个完整的 UTC 日，从最早开始，包含没有帖子的日期。
clusters[].series[].bearish_posts
integer (int64) 必填

该集群当日的看跌帖子。

clusters[].series[].bullish_posts
integer (int64) 必填

该集群当日的看涨帖子。

clusters[].series[].posts
integer (int64) 必填

该集群当日的帖子。

clusters[].series[].timestamp
string (date-time) 必填

该日的 UTC 起始时间：00:00。

clusters[].trending_asset
object 必填

在过去 7 个完整日内，该集群关注度超出市场整体水平的资产；没有则为 null。
clusters[].trending_asset.asset_class
string 必填

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

允许的值
equitycommodityindexcrypto
clusters[].trending_asset.asset_id
string 必填

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

clusters[].trending_asset.name
string 必填

人类可读的名称。

clusters[].trending_asset.symbol
string 必填

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

days
integer 必填

窗口长度，以完整 UTC 日计，截止到最近一个完整日。

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "clusters": [
    {
      "activity_change_pct": 7.61,
      "bearish_posts": 13550,
      "bullish_posts": 61240,
      "cluster_bullish_share": 0.8188,
      "cluster_id": "media",
      "market_bullish_share": 0.7812,
      "posts": 173412,
      "series": [
        {
          "bearish_posts": 480,
          "bullish_posts": 2210,
          "posts": 6120,
          "timestamp": "2026-09-11T00:00:00Z"
        },
        {
          "bearish_posts": 512,
          "bullish_posts": 2102,
          "posts": 5874,
          "timestamp": "2026-09-12T00:00:00Z"
        }
      ],
      "trending_asset": {
        "asset_class": "equity",
        "asset_id": "NVDA",
        "name": "NVIDIA Corporation",
        "symbol": "NVDA"
      }
    },
    {
      "activity_change_pct": 171.42,
      "bearish_posts": 18860,
      "bullish_posts": 20480,
      "cluster_bullish_share": 0.5206,
      "cluster_id": "wallstreetbets",
      "market_bullish_share": 0.7035,
      "posts": 88034,
      "series": [
        {
          "bearish_posts": 702,
          "bullish_posts": 790,
          "posts": 3310,
          "timestamp": "2026-09-11T00:00:00Z"
        },
        {
          "bearish_posts": 681,
          "bullish_posts": 655,
          "posts": 2987,
          "timestamp": "2026-09-12T00:00:00Z"
        }
      ],
      "trending_asset": {
        "asset_class": "equity",
        "asset_id": "ORCL",
        "name": "Oracle Corporation",
        "symbol": "ORCL"
      }
    }
  ],
  "days": 30
}