全部文档 Nebula 文档 所有端点 交互式文档 Markdown OpenAPI JSON
  1. REST API
  2. 社交与情绪

社交动能

GET /social-momentum
GetSocialMomentum

针对某项资产、某个主题或整个市场，并排展示每个作者聚类中的帖子、独立发帖者和情感：哪些群体在推动对话，以及他们的语气有何不同。聚类之间会重叠，因此不要将它们相加。发送 clusters 可仅返回你指定的聚类。

参数规则：

  • asset_id 必须与 asset_class 一起发送。
  • subject_id 不能与 asset_id 或 asset_class 组合使用。
  • 不使用 asset_id 时，asset_class 必须为 equity 或 crypto；commodity 和 index 需要 asset_id。

钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/social-momentum 使用。无需 Nebula 账户或 API key；签名前请先查看支付报价。x402 支付指南。

参数

asset_id string QUERY

来自 /assets 或 /search 的资产 ID，例如 NVDA、GLD、SPX 或 bitcoin。请与随其一同返回的 asset_class 一起发送。

Example:NVDA

asset_class string QUERY

与 asset_id 一起使用时，表示资产的类别。不使用时，表示要聚合的市场：equity（股票、大宗商品和指数；默认值）或 crypto。

允许的值
equitycommodityindexcrypto

Example:equity

subject_id string QUERY

由 /subjects 或 /search 返回的规范非资产标识符，例如 text:jensen huang 或 handle:elonmusk。不区分大小写。不能与 asset_id 或 asset_class 组合使用。

Example:text:jensen huang

hours integer QUERY

回溯窗口，以小时计。免费套餐可回溯 90 天；超出则返回 403。

Default:168

granularity string QUERY

请求的时间序列桶大小。省略时，服务会根据回溯窗口选择合适的桶大小。

允许的值
1h2h4h12h1d

Example:1h

clusters array<string> QUERY

仅返回这些聚类，每个聚类作为独立序列；省略则返回全部。使用 /sentiment 的 clusters 参数中的 id，但不包括发帖社区。

Example:smart_money

cURL 示例

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

响应

200 OK
400 错误请求
401 未授权
402 Credits 已用尽；响应中包含续期时间和已购买的 credit 余额
403 禁止访问
404 未找到
405 方法不被允许；Allow 响应头列出了支持的方法
429 请求过多
500 内部服务器错误
503 服务不可用

媒体类型 application/json

clusters
object 必填

按规范作者聚类标识符索引的社交动量序列。
clusters.{key}[].average_sentiment_score
number (double) 必填

帖子情感得分的算术平均值，采用 −100（极度看跌）到 +100（极度看涨）的刻度。

clusters.{key}[].bearish_posts
integer (int64) 必填

被归类为看跌的帖子。

clusters.{key}[].bullish_posts
integer (int64) 必填

被归类为看涨的帖子。

clusters.{key}[].neutral_posts
integer (int64) 必填

被归类为中性的帖子。

clusters.{key}[].timestamp
string (date-time) 必填

观测值或桶起始时间的 UTC RFC 3339 时间戳。

clusters.{key}[].total_posts
integer (int64) 必填

该指标活跃回溯窗口内的帖子数。

clusters.{key}[].unique_posters
integer (int64) 必填

该时间桶中的不同发帖账号数；在粗于每小时的粒度下，这是由每小时计数汇总得出的上限。

{
  "clusters": {
    "smart_money": [
      {
        "average_sentiment_score": 38.5,
        "bearish_posts": 41,
        "bullish_posts": 112,
        "neutral_posts": 31,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 184,
        "unique_posters": 73
      }
    ]
  }
}