全部文档 Nebula 文档所有端点交互式文档 Markdown OpenAPI JSON

REST API
聚类

作者聚类

GET /clusters

ListClusters

每个作者集群在某个市场中的活跃度与情绪：帖子数、独立作者数、相对上一窗口的变化，以及净情绪（看涨帖子减看跌帖子）及小时级序列。asset_class 为 equity（默认）或 crypto。

钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/clusters 使用。无需 Nebula 账户或 API key；签名前请先查看支付报价。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 Credits 已用尽；响应中包含续期时间和已购买的 credit 余额

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
}