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

分时段情绪

GET /sentiment/timeframes
GetSentimentTimeframes

按人们谈论的时间跨度拆分的情感：短期（最多一周）、中期（数周到数月）和长期（三个月及以上），均采用 /sentiment 的刻度。可区分本周看跌但全年看涨的人群与始终看跌的人群。

参数规则：

  • 发送 asset_id 或 subject_id。
  • asset_id 必须与 asset_class 一起发送。
  • subject_id 不能与 asset_id 或 asset_class 组合使用。

钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/sentiment/timeframes 使用。无需 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（股票和 ETF）、commodity、index 或 crypto。请发送 /assets 或 /search 随 asset_id 一同返回的 asset_class。

允许的值
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:720

granularity string QUERY

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

允许的值
1h2h4h12h1d

Example:1h

cURL 示例

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/sentiment/timeframes' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --header 'X-API-Key: YOUR_API_KEY'

响应

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

媒体类型 application/json

current
object 必填

每个可用时间跨度范围的最新情感读数。

允许的键
short_termmedium_termlong_term
metadata
object 可选

用于解读响应的方法论和请求窗口元数据。
metadata.as_of
string (date-time) 可选

计算该指标的 UTC 时间。

metadata.calculation
string 可选

计算方法的简称。

metadata.formula
string 可选

计算方法的可读公式。

metadata.half_life_hours
number (double) 可选

尽管名称如此，它表示线性衰减窗口的长度，单位为小时：帖子在刚发布时完全计入，在时间中点计一半，达到该时长后不再计入。

metadata.lookback_days
integer 可选

计算所使用的历史回溯天数。

metadata.scale
string 可选

该指标的已发布量表或解读。

series
object 必填

按 short_term、medium_term 和 long_term 时间跨度索引的情感序列。

允许的键
short_termmedium_termlong_term
series.{key}[].interval_posts
number (double) 可选

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

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

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

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

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

series.{key}[].total_posts
number (double) 可选

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

{
  "current": {
    "long_term": 52.1,
    "medium_term": 57.8,
    "short_term": 64.2
  },
  "series": {
    "short_term": [
      {
        "sentiment_signal": 64.2,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 318
      }
    ]
  }
}