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

REST API
预测

情绪预测

GET /forecasts/sentiment

GetSentimentForecast

资产情绪在未来 72 小时内可能的走向，以结果区间及其概率表示。series 给出每 4 小时该步预期的看涨、看跌、中性及总帖子数，以及该步结束时的 sentiment_signal，均基于 /sentiment 量表。chance_higher_24h 和 chance_higher_72h 给出信号最终高于 current_sentiment_signal 的概率；它们的 _confident 标志表示该概率明显偏向某一方向。

预测会在有关该资产的新帖子发布后一分钟内更新，且至少每 15 分钟更新一次。refresh=true 会基于最新数据在约 5 秒内重新计算；如果耗时超过 20 秒，你将获得带有 refreshed: false 的最新预测，按 5 计费。没有预测的资产会返回 status: not_forecastable 和 reason；/forecasts/assets 列出了有预测的资产。

消耗 5 个积分，使用 refresh=true 时为 10 个。not_forecastable 答案为免费，每个账号每小时最多 30 次；超过后该端点会返回 429，直到整点重置。

此操作不支持钱包支付；请使用账号认证。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

refresh boolean QUERY

true 表示基于最新数据重新计算预测：10 个积分，约 5 秒。默认为 false。

Example:false

cURL 示例

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/forecasts/sentiment' \
  --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

as_of

string (date-time) 必填

预测的 UTC 起始时间：即用于计算它的最后一个完整 15 分钟区间的结束时间。当该资产从未被评分时为 null。

chance_higher_24h

number (double) 必填

情绪信号在 24 小时后高于 current_sentiment_signal 的概率，取值 0 到 1。

chance_higher_24h_confident

boolean 必填

当 chance_higher_24h 低于 0.3 或高于 0.7 时为 true：预测明显偏向某一方向。越接近 0.5，越应视为方向不明。

chance_higher_72h

number (double) 必填

情绪信号在 72 小时后高于 current_sentiment_signal 的概率，取值 0 到 1。

chance_higher_72h_confident

boolean 必填

当 chance_higher_72h 低于 0.3 或高于 0.7 时为 true：预测明显偏向某一方向。越接近 0.5，越应视为方向不明。

current_sentiment_signal

number (double) 必填

as_of 时的情绪信号，基于 /sentiment 量表：过去 24 小时内看涨帖子数减去看跌帖子数，近期帖子权重更高。所有路径都从这里开始，各项概率也以此为基准衡量。它可能与最新的 /sentiment 数据点略有差异，后者为每小时更新。

horizon_hours

integer 必填

预测向前推进的时长，单位为小时：始终为 72。

reason

string 必填

该资产无法预测的原因：too_little_history、stale_data 或 missing_price。当 status 为 ok 时为 null。

允许的值

too_little_historystale_datamissing_pricenull

refreshed

boolean 必填

当本次请求重新运行了预测时为 true（refresh=true 且重新运行及时完成）；当其为最新的定时预测时为 false。

sample_paths

array<array<number (double)>> 必填

情绪信号的 24 条可能路径，每条都与 series 对齐。绘制它们以展示结果的分布范围。

series

array<object> 必填

从 as_of 起每 4 小时一次的预测：共 18 步，最早的在前。

series[].bearish_posts

object 必填

仅该 4 小时步内预期的看跌帖子数，不含机器人：类似 /sentiment 的区间帖子数，而非其过去 24 小时的累计计数。

series[].bearish_posts.mean

number (double) 必填

该步预期的看跌帖子数。

series[].bearish_posts.p10

number (double) 必填

该步看跌帖子数的第 10 百分位数。

series[].bearish_posts.p25

number (double) 必填

该步看跌帖子数的第 25 百分位数。

series[].bearish_posts.p50

number (double) 必填

该步看跌帖子数的第 50 百分位数。

series[].bearish_posts.p75

number (double) 必填

该步看跌帖子数的第 75 百分位数。

series[].bearish_posts.p90

number (double) 必填

该时段看跌帖子的第 90 百分位数。

series[].bullish_posts

object 必填

仅此 4 小时时段内预期的看涨帖子数，已排除机器人：与 /sentiment 的区间帖子一致，而非其滚动 24 小时计数。

series[].bullish_posts.mean

number (double) 必填

该时段预期的看涨帖子数。

series[].bullish_posts.p10

number (double) 必填

该时段看涨帖子的第 10 百分位数。

series[].bullish_posts.p25

number (double) 必填

该时段看涨帖子的第 25 百分位数。

series[].bullish_posts.p50

number (double) 必填

该时段看涨帖子的第 50 百分位数。

series[].bullish_posts.p75

number (double) 必填

该时段看涨帖子的第 75 百分位数。

series[].bullish_posts.p90

number (double) 必填

该时段看涨帖子的第 90 百分位数。

series[].neutral_posts

object 必填

仅此 4 小时时段内预期的中性帖子数，已排除机器人：与 /sentiment 的区间帖子一致，而非其滚动 24 小时计数。

series[].neutral_posts.mean

number (double) 必填

该时段预期的中性帖子数。

series[].neutral_posts.p10

number (double) 必填

该时段中性帖子的第 10 百分位数。

series[].neutral_posts.p25

number (double) 必填

该时段中性帖子的第 25 百分位数。

series[].neutral_posts.p50

number (double) 必填

该时段中性帖子的第 50 百分位数。

series[].neutral_posts.p75

number (double) 必填

该时段中性帖子的第 75 百分位数。

series[].neutral_posts.p90

number (double) 必填

该时段中性帖子的第 90 百分位数。

series[].sentiment_signal

object 必填

该时段结束时的情绪信号，采用 /sentiment 的刻度：即该线可能所处的位置。

series[].sentiment_signal.mean

number (double) 必填

该时段结束时预期的情绪信号。

series[].sentiment_signal.p10

number (double) 必填

该时段结束时情绪信号的第 10 百分位数。

series[].sentiment_signal.p50

number (double) 必填

该时段结束时情绪信号的第 50 百分位数。

series[].sentiment_signal.p90

number (double) 必填

该时段结束时情绪信号的第 90 百分位数。

series[].sentiment_signal.quantiles

array<number (double)> 必填

该时段结束时情绪信号的 21 个分位数：第 0、5、10……100 百分位数，由低到高排列。可在它们之间插值，以得出落入任一区间的概率。

series[].timestamp

string (date-time) 必填

该时段结束的 UTC 时间：as_of 加上 4、8……72 小时。

series[].total_posts

object 必填

仅此 4 小时时段内预期的帖子数（看涨、看跌和中性合计），已排除机器人：与 /sentiment 的区间帖子一致，而非其滚动 24 小时计数。其百分位数是针对总数本身，因此并非三类帖子百分位数之和。

series[].total_posts.mean

number (double) 必填

该时段预期的帖子数（看涨、看跌和中性合计）。

series[].total_posts.p10

number (double) 必填

该时段帖子（看涨、看跌和中性合计）的第 10 百分位数。

series[].total_posts.p25

number (double) 必填

该时段帖子（看涨、看跌和中性合计）的第 25 百分位数。

series[].total_posts.p50

number (double) 必填

该时段帖子（看涨、看跌和中性合计）的第 50 百分位数。

series[].total_posts.p75

number (double) 必填

该时段帖子（看涨、看跌和中性合计）的第 75 百分位数。

series[].total_posts.p90

number (double) 必填

该时段帖子（看涨、看跌和中性合计）的第 90 百分位数。

status

string 必填

ok，或当该资产无法预测时为 not_forecastable（此时摘要字段为 null，series 为空；reason 说明原因）。

允许的值

oknot_forecastable

turning

integer 必填

当情绪转向看涨时为 1（最近几小时明显比最近一天更看涨），转向看跌时为 -1，其他情况为 0。

允许的值

-101null

{
  "as_of": "2026-09-14T09:15:00Z",
  "chance_higher_24h": 0.74,
  "chance_higher_24h_confident": true,
  "chance_higher_72h": 0.61,
  "chance_higher_72h_confident": false,
  "current_sentiment_signal": 128.6,
  "horizon_hours": 72,
  "reason": null,
  "refreshed": false,
  "sample_paths": [
    [
      133.2,
      141.7
    ],
    [
      126.4,
      118.9
    ]
  ],
  "series": [
    {
      "bearish_posts": {
        "mean": 18,
        "p10": 9.9,
        "p25": 13.5,
        "p50": 17.1,
        "p75": 21.6,
        "p90": 27.9
      },
      "bullish_posts": {
        "mean": 46,
        "p10": 25.3,
        "p25": 34.5,
        "p50": 43.7,
        "p75": 55.2,
        "p90": 71.3
      },
      "neutral_posts": {
        "mean": 29,
        "p10": 16,
        "p25": 21.8,
        "p50": 27.6,
        "p75": 34.8,
        "p90": 45
      },
      "sentiment_signal": {
        "mean": 131.4,
        "p10": 92.9,
        "p50": 129.6,
        "p90": 175.5,
        "quantiles": [
          21.6,
          70.2,
          92.9,
          104.8,
          113.1,
          119.4,
          124.2,
          127.6,
          130.5,
          132.7,
          134.5,
          136.4,
          138.7,
          141.3,
          144.9,
          149.2,
          155.1,
          163.8,
          179.4,
          202.6,
          287.3
        ]
      },
      "timestamp": "2026-09-14T13:15:00Z",
      "total_posts": {
        "mean": 93,
        "p10": 51.2,
        "p25": 69.8,
        "p50": 88.4,
        "p75": 111.6,
        "p90": 144.2
      }
    },
    {
      "bearish_posts": {
        "mean": 19,
        "p10": 10.5,
        "p25": 14.3,
        "p50": 18.1,
        "p75": 22.8,
        "p90": 29.5
      },
      "bullish_posts": {
        "mean": 50,
        "p10": 27.5,
        "p25": 37.5,
        "p50": 47.5,
        "p75": 60,
        "p90": 77.5
      },
      "neutral_posts": {
        "mean": 31,
        "p10": 17.1,
        "p25": 23.3,
        "p50": 29.5,
        "p75": 37.2,
        "p90": 48.1
      },
      "sentiment_signal": {
        "mean": 137.6,
        "p10": 99.1,
        "p50": 135.79999999999998,
        "p90": 181.7,
        "quantiles": [
          21.6,
          70.2,
          92.9,
          104.8,
          113.1,
          119.4,
          124.2,
          127.6,
          130.5,
          132.7,
          134.5,
          136.4,
          138.7,
          141.3,
          144.9,
          149.2,
          155.1,
          163.8,
          179.4,
          202.6,
          287.3
        ]
      },
      "timestamp": "2026-09-14T17:15:00Z",
      "total_posts": {
        "mean": 100,
        "p10": 55,
        "p25": 75,
        "p50": 95,
        "p75": 120,
        "p90": 155
      }
    }
  ],
  "status": "ok",
  "turning": 0
}