所有文件 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 金鑰；簽署前請先確認付款條件。x402 付款指南。

參數

asset_class array<string> QUERY

要互相比較的市場：equity、commodity、index 與 crypto 的任意組合，以逗號分隔。預設為全部四者。可傳送多個並以逗號分隔。

Default:equity,commodity,index,crypto

days integer QUERY

要比較的完整 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 額度已用完；回應會包含續約時間與已購買的額度餘額
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 市場）：baseline 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 必填

標準的公開資產識別碼：股票、商品與指數為 ticker 或市場代號，crypto 則為 CoinGecko slug（若無 slug，則為數字 id）。

clusters[].trending_asset.name
string 必填

人類可讀的名稱。

clusters[].trending_asset.symbol
string 必填

顯示用的 ticker 或市場代號。

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
}