情绪

GET /sentiment
GetSentiment

关于某项资产、某个主题或整个市场的讨论随时间变化的看涨或看跌程度。sentiment_signal 是过去 24 小时内看涨帖子减去看跌帖子,近期帖子权重更高:正值表示净看涨。它会随发帖量增长,因此请将资产与其自身历史进行比较。

cohorts 为机器人和(针对单项资产或主题的)顶级喊单者提供相同的度量。发送 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/sentiment 使用。无需 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

要读取的作者集群;重复传入可组合,例如 clusters=kols&clusters=media。所选集群会合并计算,一个作者可以属于多个集群。

  • Callers:smart_money(表现最好的 caller)、dumb_money(表现最差的)、top_degens(小市值加密货币上表现最好的)
  • Timing:early_movers(在关注度上升时最先谈论某资产)、late_movers(在峰值时或之后才入场)
  • Builders:developers、founders、team_leaders、project_accounts
  • Institutions:vcs、asset_managers、dao_guild_funds、incubators、exchanges
  • Influence:kols、celebrities、media、marketer、shiller
  • Analysts:ta_analyst、fa_analyst、macro_analyst、onchain_analyst、investigators
  • Traders:position_trader、swing_trader、day_trader
  • Bias:perma_bull、doomer、tribalist
  • Other:political、nft、bots、automated_ai
  • Communities,按发帖位置划分:wallstreetbets、reddit

Example:smart_money

cURL 示例

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

响应

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

媒体类型 application/json

cohorts
object 必填

其他作者群体的相同度量:bots,以及在该群体可用时的 top_callers。非机器人群体即 series 本身。

允许的键
botstop_callers
cohorts.{key}[].bearish_posts
number (double) 必填

截至该时间点的过去 24 小时内的看跌帖子数;interval_bearish_posts 为该桶内的数量。

cohorts.{key}[].bullish_posts
number (double) 必填

截至该时间点的过去 24 小时内的看涨帖子数;interval_bullish_posts 为该桶内的数量。

cohorts.{key}[].interval_bearish_posts
number (double) 可选

该输出时间桶内的看跌帖子数。

cohorts.{key}[].interval_bullish_posts
number (double) 可选

该输出时间桶内的看涨帖子数。

cohorts.{key}[].interval_neutral_posts
number (double) 可选

该输出时间桶内的中性帖子数。

cohorts.{key}[].interval_posts
number (double) 可选

该输出时间桶内的帖子数,尚未进行回溯累积。

cohorts.{key}[].neutral_posts
number (double) 必填

截至该时间点的过去 24 小时内的中性帖子数;interval_neutral_posts 为该桶内的数量。

cohorts.{key}[].sentiment_signal
number (double) 必填

衰减加权的净看涨帖子数:看涨减去看跌。正值表示看涨,负值表示看跌,且幅度随活跃度增长。

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

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

cohorts.{key}[].total_posts
number (double) 必填

截至该时间点的过去 24 小时内的帖子数,而非仅该桶;interval_posts 为该桶内的数量。

series
array<object> 必填

按时间顺序排列的观测值。

series[].bearish_posts
number (double) 必填

截至该时间点的过去 24 小时内的看跌帖子数;interval_bearish_posts 为该桶内的数量。

series[].bullish_posts
number (double) 必填

截至该时间点的过去 24 小时内的看涨帖子数;interval_bullish_posts 为该桶内的数量。

series[].interval_bearish_posts
number (double) 可选

该输出时间桶内的看跌帖子数。

series[].interval_bullish_posts
number (double) 可选

该输出时间桶内的看涨帖子数。

series[].interval_neutral_posts
number (double) 可选

该输出时间桶内的中性帖子数。

series[].interval_posts
number (double) 可选

该输出时间桶内的帖子数,尚未进行回溯累积。

series[].neutral_posts
number (double) 必填

截至该时间点的过去 24 小时内的中性帖子数;interval_neutral_posts 为该桶内的数量。

series[].sentiment_signal
number (double) 必填

衰减加权的净看涨帖子数:看涨减去看跌。正值表示看涨,负值表示看跌,且幅度随活跃度增长。

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

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

series[].total_posts
number (double) 必填

截至该时间点的过去 24 小时内的帖子数,而非仅该桶;interval_posts 为该桶内的数量。

{
  "cohorts": {
    "bots": [
      {
        "bearish_posts": 438,
        "bullish_posts": 1120,
        "neutral_posts": 284,
        "sentiment_signal": 128.6,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 1842
      }
    ]
  },
  "series": [
    {
      "bearish_posts": 438,
      "bullish_posts": 1120,
      "interval_bearish_posts": 18,
      "interval_bullish_posts": 46,
      "interval_neutral_posts": 10,
      "interval_posts": 74,
      "neutral_posts": 284,
      "sentiment_signal": 128.6,
      "timestamp": "2026-08-07T15:00:00Z",
      "total_posts": 1842
    }
  ]
}