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

REST API
情报

情报

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 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

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 Credits 已用尽；响应中包含续期时间和已购买的 credit 余额

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