所有文件 Nebula 文件所有端點互動式文件 Markdown OpenAPI JSON

REST API
叢集

作者叢集

GET /clusters

ListClusters

每個作者叢集在某一市場的活動與情緒：貼文數、不重複作者數、相較前一視窗的變化，以及淨情緒（看漲貼文減去看跌貼文）與每小時序列。asset_class 為 equity（預設）或 crypto。

可使用錢包於 https://nebula-api.hiddensystems.ai/api/v1/x402/clusters 付款。不需要 Nebula 帳號或 API 金鑰；簽署前請先確認付款條件。x402 付款指南。

參數

asset_class string QUERY

要彙總的市場：equity（傳統市場，涵蓋股票、大宗商品與指數）或 crypto。

允許的值

equitycrypto

Default:equity

hours integer QUERY

回溯期間，以小時為單位。免費方案可回溯 90 天；更早的期間會回傳 403。

Default:24

cURL 範例

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

回應

200 OK

400 錯誤的要求

401 未經授權

402 額度已用完；回應會包含續約時間與已購買的額度餘額

403 禁止

404 找不到

405 不允許的方法；Allow 標頭會列出支援的方法

429 要求過多

500 內部伺服器錯誤

503 服務無法使用

媒體類型 application/json

clusters

array<object> 必填

所選資產類別的作者叢集摘要。

clusters[].activity_change_pct

number (double) 選填

貼文數相較於前一個等長視窗的百分比變化（84 之後為 76 即 -9.52）；無法比較時不會出現。

clusters[].bearish_posts

number (double) 必填

歸類為看跌的貼文。

clusters[].bullish_posts

number (double) 必填

歸類為看漲的貼文。

clusters[].cluster_id

string 必填

標準作者叢集識別碼。

clusters[].neutral_posts

number (double) 必填

歸類為中性的貼文。

clusters[].previous_total_posts

number (double) 必填

緊接在前之等長視窗中的貼文數。

clusters[].recent_sentiment_signal

number (double) 必填

每小時情緒序列的最新值：最近一個有貼文的小時。

clusters[].series

array<object> 必填

依時間順序排列的觀測值。

clusters[].series[].bearish_posts

number (double) 必填

歸類為看跌的貼文。

clusters[].series[].bullish_posts

number (double) 必填

歸類為看漲的貼文。

clusters[].series[].sentiment_signal

number (double) 必填

經衰減加權的淨看多貼文數：看多減去看空。正值代表看多，負值代表看空，且幅度會隨活動量成長。

clusters[].series[].timestamp

string (date-time) 必填

觀測值或分桶開始時間的 UTC RFC 3339 時間戳記。

clusters[].series[].total_posts

number (double) 必填

該指標作用中回溯視窗內的貼文數。

clusters[].total_posts

number (double) 必填

該指標作用中回溯視窗內的貼文數。

clusters[].window_sentiment_signal

number (double) 必填

完整要求視窗內的淨看漲情緒訊號。

hours

integer 必填

此回應所代表的回看區間，以小時為單位。

{
  "clusters": [
    {
      "activity_change_pct": 18.4,
      "bearish_posts": 438,
      "bullish_posts": 1120,
      "cluster_id": "smart_money",
      "neutral_posts": 284,
      "previous_total_posts": 1556,
      "recent_sentiment_signal": 84.2,
      "series": [
        {
          "bearish_posts": 438,
          "bullish_posts": 1120,
          "sentiment_signal": 128.6,
          "timestamp": "2026-08-07T15:00:00Z",
          "total_posts": 1842
        }
      ],
      "total_posts": 1842,
      "window_sentiment_signal": 63.7
    }
  ],
  "hours": 168
}