全部文档 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 key；签名前请先查看支付报价。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 Credits 已用尽；响应中包含续期时间和已购买的 credit 余额
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 必填

规范的公开资产标识符：股票、商品和指数的股票代码或市场符号，以及加密货币的 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 必填

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

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
}