所有文件 Nebula 文件 所有端點 互動式文件 Markdown OpenAPI JSON
  1. REST API
  2. 情報

情報

GET /insights
ListInsights

關於全球市場或某項資產、主體市場動態的短篇報導，每則包含標題、摘要、情緒（−1、0 或 +1）、標籤、1 到 3 的重要性，以及涉及的實體。依最近更新排序；若想讓最新事件排在最前，請傳送 order_by=start_time_desc。

參數規則：

  • 請同時傳送 asset_class 與 asset_id，或兩者都不傳。
  • subject_id 不能與 asset_id 或 asset_class 合併使用。

可使用錢包於 https://nebula-api.hiddensystems.ai/api/v1/x402/insights 付款。不需要 Nebula 帳號或 API 金鑰；簽署前請先確認付款條件。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

limit integer QUERY

傳回的結果數量上限。

Default:10

offset integer QUERY

略過的結果數量。

Default:0

start_time_after string (date-time) QUERY

僅包含開始時間晚於此 RFC3339 時間的項目。免費方案可回溯 90 天；更早的查詢會回傳 403。

Example:2026-08-01T00:00:00Z

start_time_before string (date-time) QUERY

僅包含開始時間早於此 RFC3339 時間的項目。免費方案可回溯 90 天；更早的查詢會回傳 403。

Example:2026-08-07T00:00:00Z

tags array<string> QUERY

保留帶有任一個這些標籤的報導，須完全相符（例如 earnings）。標籤是自由格式的標記；請從回傳的報導中讀取。可傳送多個，以逗號分隔。

Example:earnings

exclude_tags array<string> QUERY

排除帶有任一個這些標籤的報導。此參數只比對標籤，不比對分類或網域：若要排除加密貨幣報導，請改為篩選網域。可傳送多個，以逗號分隔。

Example:rumour

categories array<string> QUERY

保留主要分類為任一個這些值的報導，須完全相符（例如 equities 或 technology）。分類是自由格式；請從回傳的報導中讀取。可傳送多個，以逗號分隔。

Example:equities

domains array<string> QUERY

保留位於任一個這些網域的報導。可傳送多個，以逗號分隔。

Example:equities,macro

order_by string QUERY

結果排序方式。預設為 updated_at_desc。

允許的值
start_time_ascstart_time_descupdated_at_ascupdated_at_desccreated_at_asccreated_at_descimportance_score_ascimportance_score_desc

Default:updated_at_desc

cURL 範例

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

回應

200 OK
400 錯誤的要求
401 未經授權
402 額度已用完；回應會包含續約時間與已購買的額度餘額
403 禁止
404 找不到
405 不允許的方法；Allow 標頭會列出支援的方法
429 要求過多
500 內部伺服器錯誤
503 服務無法使用

媒體類型 application/json

insights
array<object> 必填

符合所提供篩選條件的精選情報項目。
insights[].category
string 選填

指派的主要情報分類。

insights[].domains
array<string> 必填

附加於此記錄的市場或主體網域。

insights[].entities
array<object> 必填

與此記錄連結的資產及非資產主體。
insights[].entities[].asset_class
string 選填

資產的類別，與 asset_id 一同傳送。

允許的值
equitycommodityindexcrypto
insights[].entities[].asset_id
string 選填

對於股票、大宗商品、指數或加密貨幣，這是資產端點所接受的 asset_id；人物、帳號與主題則不會有此欄位，Nebula 無法歸類的少數資產亦然。

insights[].entities[].entity_id
string 必填

Nebula 為連結實體所指派的 id，例如 eq:NVDA、gecko:1 或 text:ai。若要查詢該實體，請使用同一物件中的 asset_id 與 asset_class，或 subject_id。

insights[].entities[].entity_types
array<string> 必填

連結實體的知識圖譜分類。

insights[].entities[].is_direct
boolean 必填

當此記錄直接與這個連結實體相關時為 true。

insights[].entities[].is_primary
boolean 必填

當這是此記錄的主要連結實體時為 true。

insights[].entities[].name
string 必填

人類可讀的名稱。

insights[].entities[].role
string 必填

連結實體與此情報項目的關係。

insights[].entities[].subject_id
string 選填

對於人物、帳號或主題，這是主體感知端點所接受的 subject_id；資產則不會有此欄位。

insights[].headline
string 必填

簡潔的情報標題。

insights[].importance_score
integer 必填

重要性，從 1（低）到 3（高）。

insights[].insight_id
integer (int64) 必填

情報項目的穩定識別碼。

insights[].sentiment_score
integer 必填

帶正負號的情緒分數；正值代表看漲，負值代表看跌。

insights[].start_time
string (date-time) 選填

情報項目或事件開始的 UTC 時間。

insights[].summary
string 必填

以證據為基礎的情報項目摘要。

insights[].tags
array<string> 必填

附加於該紀錄的可搜尋標籤。

insights[].updated_at
string (date-time) 選填

該紀錄最後更新時間（UTC）。

{
  "insights": [
    {
      "category": "earnings",
      "domains": [
        "equities",
        "technology"
      ],
      "entities": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "entity_id": "eq:NVDA",
          "entity_types": [
            "equity"
          ],
          "is_direct": true,
          "is_primary": true,
          "name": "NVIDIA Corporation",
          "role": "primary",
          "subject_id": "text:jensen huang"
        }
      ],
      "headline": "NVIDIA raises its quarterly revenue outlook",
      "importance_score": 3,
      "insight_id": 38421,
      "sentiment_score": 1,
      "start_time": "2026-08-20T20:00:00Z",
      "summary": "Management raised guidance after stronger-than-expected data-centre demand.",
      "tags": [
        "earnings",
        "data_centres"
      ],
      "updated_at": "2026-08-07T14:35:00Z"
    }
  ]
}