所有文件 Nebula 文件所有端點互動式文件 Markdown OpenAPI JSON

REST API
情報

洞察關注度

GET /insights/attention

GetInsightAttention

單一情報項目的對話內容：24 小時關注視窗、作者與情緒計數、每小時分桶、叢集組成、影響向量，以及每個可計價連結實體的價格反應。當讀者開啟單一項目、需要完整抽屜層級的背景資訊時，請在 /insights 之後使用。

可使用錢包於 https://nebula-api.hiddensystems.ai/api/v1/x402/insights/attention 付款。不需要 Nebula 帳號或 API 金鑰；簽署前請先確認付款條件。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 額度已用完；回應會包含續約時間與已購買的額度餘額

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"
    }
  ]
}