所有文件 Nebula 文件 所有端點 互動式文件 Markdown OpenAPI JSON
  1. REST API
  2. 叢集

熱潮週期到來

GET /clusters/comparison/hype-cycles
CompareHypeCycles

視窗內最大的幾波熱潮，以及各叢集抵達的順序（相對於市場的尖峰時段），並附上尖峰前後市場的每小時貼文數。

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

參數

asset_class array<string> QUERY

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

Default:equity,commodity,index,crypto

days integer QUERY

要納入多少個完整 UTC 日的市場尖峰，從最近一個完整日往回計算：7、30 或 90。免費方案可回溯 90 天；超過則傳回 403。

允許的值
73090

Default:30

limit integer QUERY

傳回的熱潮數量上限：依尖峰日貼文數取最大者。

Default:40

cURL 範例

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/comparison/hype-cycles' \
  --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 則為全部四者。

cycles
array<object> 必填

視窗內最大的幾波熱潮，依尖峰時間由新到舊排序，最多至 limit。
cycles[].arrivals
array<object> 必填

在尖峰時段前後 48 小時內有 3 篇以上貼文的每個叢集，依時間由早到晚排序。
cycles[].arrivals[].cluster_id
string 必填

標準作者叢集識別碼。

cycles[].arrivals[].offset_hours
number (double) 必填

從市場尖峰時段到該叢集在尖峰前後 48 小時內貼文的加權平均時段，以小時為單位。負值表示早於尖峰。

cycles[].arrivals[].posts
integer (int64) 必填

該叢集在尖峰時段前後 48 小時內對該資產的貼文。

cycles[].asset_class
string 必填

資產的類別：equity（股票與 ETF）、commodity、index 或 crypto。請在每個以資產為範圍的要求中，與 asset_id 一併送出。

允許的值
equitycommodityindexcrypto
cycles[].asset_id
string 必填

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

cycles[].name
string 必填

人類可讀的名稱。

cycles[].peak_day_posts
integer (int64) 必填

市場在尖峰日對該資產的貼文，不含機器人。

cycles[].peak_timestamp
string (date-time) 必填

尖峰日市場最繁忙時段的 UTC 起始時間。

cycles[].series
array<object> 必填

市場對該資產的逐時貼文數，從尖峰時段前 24 小時到後 23 小時：共 48 筆觀測值。
cycles[].series[].posts
integer (int32) 必填

市場在該時段對該資產的貼文，不含機器人。

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

該時段的 UTC 起始時間。

cycles[].symbol
string 必填

顯示用的 ticker 或市場代號。

days
integer 必填

視窗長度，以完整 UTC 日為單位，結束於最近一個完整日。

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cycles": [
    {
      "arrivals": [
        {
          "cluster_id": "smart_money",
          "offset_hours": -3.2,
          "posts": 18
        },
        {
          "cluster_id": "team_leaders",
          "offset_hours": -2.1,
          "posts": 9
        },
        {
          "cluster_id": "media",
          "offset_hours": 1.4,
          "posts": 57
        }
      ],
      "asset_class": "equity",
      "asset_id": "ORCL",
      "name": "Oracle Corporation",
      "peak_day_posts": 930,
      "peak_timestamp": "2026-09-10T14:00:00Z",
      "series": [
        {
          "posts": 41,
          "timestamp": "2026-09-10T13:00:00Z"
        },
        {
          "posts": 112,
          "timestamp": "2026-09-10T14:00:00Z"
        },
        {
          "posts": 64,
          "timestamp": "2026-09-10T15:00:00Z"
        }
      ],
      "symbol": "ORCL"
    }
  ],
  "days": 30
}