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

REST API
情报

洞察关注度

GET /insights/attention

GetInsightAttention

围绕单条情报的对话：24 小时关注窗口、作者与情绪计数、按小时分桶、集群构成、影响向量，以及每个可定价关联实体的价格反应。当读者打开某条情报、需要抽屉级别的完整上下文时，在 /insights 之后使用。

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

参数

insight_id integer QUERY 必填

由 /insights 返回的情报条目的稳定标识符。免费套餐可回溯 90 天；更早的请求返回 403。

Example:1

cURL 示例

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/insights/attention' \
  --data-urlencode 'insight_id=1' \
  --header 'X-API-Key: YOUR_API_KEY'

响应

200 OK

400 错误请求

401 未授权

402 Credits 已用尽；响应中包含续期时间和已购买的 credit 余额

403 禁止访问

404 未找到

405 方法不被允许；Allow 响应头列出了支持的方法

429 请求过多

500 内部服务器错误

503 服务不可用

媒体类型 application/json

attention

object 必填

所请求情报条目的对话与影响读数。

attention.anchor_subject_id

string 必填

用于锚定关注扫描的主体 id。

attention.authors

integer (int64) 必填

匹配帖子所代表的不同作者数。

attention.average_sentiment_score

number (double) 必填

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

attention.bearish_posts

integer (int64) 必填

被归类为看跌的帖子。

attention.bucket_hours

integer 必填

每个分桶的宽度，单位为小时。

attention.buckets

array<object> 必填

按时间顺序排列的关注分桶。

attention.buckets[].authors

integer (int64) 必填

匹配帖子所代表的不同作者数。

attention.buckets[].average_sentiment_score

number (double) 必填

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

attention.buckets[].bearish_posts

integer (int64) 必填

被归类为看跌的帖子。

attention.buckets[].bullish_posts

integer (int64) 必填

被归类为看涨的帖子。

attention.buckets[].neutral_posts

integer (int64) 必填

被归类为中性的帖子。

attention.buckets[].posts

integer (int64) 必填

所请求时间窗口内的匹配帖子数。

attention.buckets[].timestamp

string (date-time) 必填

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

attention.bullish_posts

integer (int64) 必填

被归类为看涨的帖子。

attention.cluster_mix

array<object> 必填

匹配帖子的作者集群构成，按作者数排序。

attention.cluster_mix[].authors

integer (int64) 必填

匹配帖子所代表的不同作者数。

attention.cluster_mix[].cluster_id

string 必填

规范的作者集群标识符。

attention.cluster_mix[].posts

integer (int64) 可选

所请求时间窗口内的匹配帖子数。

attention.cluster_mix[].share

number (double) 必填

在符合条件的社交关注度中所占份额，以 0 到 1 的小数表示。

attention.clusters

integer (int64) 必填

匹配帖子所代表的不同作者集群数。

attention.from

string (date-time) 必填

所测量时间窗口的 UTC 起始时间（含）。

attention.impact

object 可选

该情报条目的结构化影响评估。

attention.impact.max_score

integer 必填

每个影响向量的最高可能得分。

attention.impact.sentiment_score

integer 必填

带符号的情绪分数；正值为看涨，负值为看跌。

attention.impact.vectors

array<object> 必填

条目级影响评估背后的影响向量。

attention.impact.vectors[].key

string 必填

该影响向量的稳定机器可读键。

attention.impact.vectors[].label

string 必填

人类可读的桶标签或指数标签。

attention.impact.vectors[].score

integer 必填

该影响向量的得分。

attention.last_post_at

string (date-time) 可选

所请求时间窗口内最新一条匹配帖子的 UTC 时间。

attention.neutral_posts

integer (int64) 必填

被归类为中性的帖子。

attention.optional_subjects

array<string> 必填

匹配帖子必须至少提及其中一个的主体 id；为空表示未要求任何可选侧。

attention.posts

integer (int64) 必填

所请求时间窗口内的匹配帖子数。

attention.required_subjects

array<string> 必填

所有匹配帖子都必须提及的主体 id。

attention.subjects_used

array<string> 必填

经过任何回退后，实际用于所返回关注窗口的主体 id。

attention.to

string (date-time) 必填

所测量时间窗口的 UTC 结束时间（不含）。

attention.window_kind

string 必填

窗口相对于该洞察的位置：之前或围绕。

insight_id

integer (int64) 必填

情报条目的稳定标识符。

price_reactions

array<object> 必填

与该情报条目关联的可定价实体的价格反应。

price_reactions[].insight_at

string (date-time) 必填

用作价格反应基准的 UTC 时间。

price_reactions[].insight_id

integer (int64) 必填

情报条目的稳定标识符。

price_reactions[].live_pct

number (double) 可选

相对洞察基准的最新价格变动，仅近期洞察会提供。

price_reactions[].moves

array<object> 必填

各固定时间跨度到期后的价格变动。

price_reactions[].moves[].change_pct

number (double) 必填

在洞察时间相对基准的价格变动百分点。

price_reactions[].moves[].hours

integer 必填

响应所代表的回溯窗口，以小时为单位。

price_reactions[].series

array<object> 必填

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

price_reactions[].series[].change_pct

number (double) 必填

在洞察时间相对基准的价格变动百分点。

price_reactions[].series[].timestamp

string (date-time) 必填

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

price_reactions[].subject_id

string 必填

非资产的人物、账户或主题的规范标识符。

{
  "attention": {
    "anchor_subject_id": "eq:NVDA",
    "authors": 241,
    "average_sentiment_score": 38.5,
    "bearish_posts": 438,
    "bucket_hours": 1,
    "buckets": [
      {
        "authors": 241,
        "average_sentiment_score": 38.5,
        "bearish_posts": 438,
        "bullish_posts": 1120,
        "neutral_posts": 284,
        "posts": 684,
        "timestamp": "2026-08-07T15:00:00Z"
      }
    ],
    "bullish_posts": 1120,
    "cluster_mix": [
      {
        "authors": 241,
        "cluster_id": "smart_money",
        "posts": 684,
        "share": 0.148
      }
    ],
    "clusters": 4,
    "from": "2026-08-15T09:00:00Z",
    "last_post_at": "2026-08-22T08:45:00Z",
    "neutral_posts": 284,
    "optional_subjects": [
      "string"
    ],
    "posts": 684,
    "required_subjects": [
      "string"
    ],
    "subjects_used": [
      "string"
    ],
    "to": "2026-08-22T09:00:00Z",
    "window_kind": "around"
  },
  "insight_id": 38421,
  "price_reactions": [
    {
      "insight_at": "2026-08-20T20:00:00Z",
      "insight_id": 38421,
      "live_pct": 1.8,
      "moves": [
        {
          "change_pct": 2.4,
          "hours": 168
        }
      ],
      "series": [
        {
          "change_pct": 2.4,
          "timestamp": "2026-08-07T15:00:00Z"
        }
      ],
      "subject_id": "text:artificial intelligence"
    }
  ]
}