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

聚类轮动

GET /clusters/rotation
GetClusterRotation

某个聚类的关注点正在如何转移：与上一窗口相比，在其帖子中占比上升和下降的资产（以基点计），以及其帖子在市场、人物和事件之间的分布。

参数规则：

  • 发送 cluster_id。
  • cluster_id 只指定一个集群；若要比较多个集群，请对每个集群分别调用，或使用 /clusters 一次性获取所有集群。
  • 发帖社区（wallstreetbets、reddit）仅覆盖股票：使用其中之一时，asset_class 必须包含 equity。

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

参数

cluster_id string QUERY 必填

要分析的集群，格式与 /clusters 返回的一致，例如 smart_money 或 wallstreetbets。可以是 /sentiment 的 clusters 参数中的任意 id。

Example:smart_money

asset_class array<string> QUERY

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

Default:equity,commodity,index,crypto

hours integer QUERY

用于与之比较的窗口，即此前等长的窗口：24（最近 24 小时）、168（最近 7 个完整日）或 720（最近 30 个完整日）。免费方案可回溯 90 天；更早的请求返回 403。

允许的值
24168720

Default:168

limit integer QUERY

返回的涨幅最大者数量上限，以及单独的跌幅最大者数量上限。

Default:6

cURL 示例

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/rotation' \
  --data-urlencode 'cluster_id=smart_money' \
  --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，则为全部四个。

cluster_id
string 必填

所分析的集群，以其规范 cluster_id 表示。

gainers
array<object> 必填

在该聚类帖子中占比上升最多的资产，涨幅最大者在前。仅列出占比上升的资产。
gainers[].asset_class
string 必填

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

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

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

gainers[].current_share
number (double) 必填

当前窗口内，该资产帖子占该聚类关于所选资产类别全部帖子的比例，从 0 到 1。

gainers[].name
string 必填

人类可读的名称。

gainers[].previous_share
number (double) 必填

对比窗口内，该资产帖子占该聚类全部帖子的比例，从 0 到 1。

gainers[].share_change_bps
integer 必填

current_share 减去对比窗口中的占比，以基点计：100 表示一个百分点。负值表示占比下降。

gainers[].symbol
string 必填

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

hours
integer 必填

响应所代表的回溯窗口，以小时为单位。

losers
array<object> 必填

在该聚类帖子中占比下降最多的资产，跌幅最大者在前。仅列出占比下降的资产。
losers[].asset_class
string 必填

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

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

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

losers[].current_share
number (double) 必填

当前窗口内，该资产帖子占该聚类关于所选资产类别全部帖子的比例，从 0 到 1。

losers[].name
string 必填

人类可读的名称。

losers[].previous_share
number (double) 必填

对比窗口内，该资产帖子占该聚类全部帖子的比例，从 0 到 1。

losers[].share_change_bps
integer 必填

current_share 减去对比窗口中的占比，以基点计：100 表示一个百分点。负值表示占比下降。

losers[].symbol
string 必填

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

topic_changes
array<object> 必填

每个主题在当前窗口中的占比及其相对上一窗口的变化，顺序为 equity、commodity、index、crypto、people、events。
topic_changes[].current_share
number (double) 必填

当前窗口内，该主题帖子占该聚类帖子的比例，从 0 到 1。

topic_changes[].share_change_bps
integer 必填

相对上一窗口的占比变化，以基点计（100 表示一个百分点）。

topic_changes[].topic
string 必填

equity、commodity、index、crypto、people（人物及其账号）或 events（地点、主题和事件）。

允许的值
equitycommodityindexcryptopeopleevents
topic_series
array<object> 必填

每个完整 UTC 日内，各主题占该聚类帖子的比例，最早者在前。
topic_series[].timestamp
string (date-time) 必填

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

topic_series[].topics
array<object> 必填

当天各主题占该聚类帖子的比例，顺序与 topic_changes 相同。当该聚类当天有发帖时，各占比之和为 1。
topic_series[].topics[].topic
string 必填

equity、commodity、index、crypto、people（人物及其账号）或 events（地点、主题和事件）。

允许的值
equitycommodityindexcryptopeopleevents
topic_series[].topics[].topic_share
number (double) 必填

当天该主题占该聚类帖子的比例，从 0 到 1。

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "gainers": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "current_share": 0.0687,
      "name": "NVIDIA Corporation",
      "previous_share": 0.0412,
      "share_change_bps": 275,
      "symbol": "NVDA"
    }
  ],
  "hours": 168,
  "losers": [
    {
      "asset_class": "equity",
      "asset_id": "TSLA",
      "current_share": 0.0318,
      "name": "Tesla, Inc.",
      "previous_share": 0.0521,
      "share_change_bps": -203,
      "symbol": "TSLA"
    }
  ],
  "topic_changes": [
    {
      "current_share": 0.52,
      "share_change_bps": 120,
      "topic": "equity"
    },
    {
      "current_share": 0.03,
      "share_change_bps": -15,
      "topic": "commodity"
    },
    {
      "current_share": 0.04,
      "share_change_bps": 10,
      "topic": "index"
    },
    {
      "current_share": 0.14,
      "share_change_bps": -115,
      "topic": "crypto"
    },
    {
      "current_share": 0.11,
      "share_change_bps": 35,
      "topic": "people"
    },
    {
      "current_share": 0.16,
      "share_change_bps": -35,
      "topic": "events"
    }
  ],
  "topic_series": [
    {
      "timestamp": "2026-09-10T00:00:00Z",
      "topics": [
        {
          "topic": "equity",
          "topic_share": 0.5
        },
        {
          "topic": "commodity",
          "topic_share": 0.03
        },
        {
          "topic": "index",
          "topic_share": 0.04
        },
        {
          "topic": "crypto",
          "topic_share": 0.15
        },
        {
          "topic": "people",
          "topic_share": 0.11
        },
        {
          "topic": "events",
          "topic_share": 0.17
        }
      ]
    },
    {
      "timestamp": "2026-09-11T00:00:00Z",
      "topics": [
        {
          "topic": "equity",
          "topic_share": 0.53
        },
        {
          "topic": "commodity",
          "topic_share": 0.03
        },
        {
          "topic": "index",
          "topic_share": 0.04
        },
        {
          "topic": "crypto",
          "topic_share": 0.13
        },
        {
          "topic": "people",
          "topic_share": 0.11
        },
        {
          "topic": "events",
          "topic_share": 0.16
        }
      ]
    }
  ]
}