全部文档 Nebula 文档 所有端点 交互式文档 Markdown OpenAPI JSON
  1. REST API
  2. 情报

日历事件

GET /calendar-events
ListCalendarEvents

即将发生和已发生的市场事件（财报、经济数据发布、IPO、上市、投票、听证会），可按全球范围或单个资产或主题查询，包含类型、状态、1 至 3 的重要性以及涉及的实体。默认从今天起，最早优先；发送 min_importance_score=2 可仅获取值得关注的事件。

参数规则：

  • 同时发送 asset_class 和 asset_id，或两者都不发送。
  • subject_id 不能与 asset_id 或 asset_class 组合使用。

钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/calendar-events 使用。无需 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:50

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

domains array<string> QUERY

保留属于以下任一领域的事件。可发送多个，以逗号分隔。

Example:equities,macro

event_types array<string> QUERY

保留属于以下任一类型的事件。可发送多个，以逗号分隔。

Example:earnings,economic_release

statuses array<string> QUERY

保留处于以下任一状态的事件。可发送多个，以逗号分隔。

Example:scheduled,postponed

min_importance_score integer QUERY

最低重要性，从 1（低）到 3（高）。默认为 1，即包含所有事件。

Default:1

cURL 示例

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

响应

200 OK
400 错误请求
401 未授权
402 Credits 已用尽；响应中包含续期时间和已购买的 credit 余额
403 禁止访问
404 未找到
405 方法不被允许；Allow 响应头列出了支持的方法
429 请求过多
500 内部服务器错误
503 服务不可用

媒体类型 application/json

calendar_events
array<object> 必填

符合所提供筛选条件的日历事件。
calendar_events[].calendar_event_id
string 必填

日历事件的稳定公开标识符。

calendar_events[].confidence_score
integer 必填

对该事件的置信度，从 1（低）到 10（高）。

calendar_events[].created_at
string (date-time) 必填

记录创建时的 UTC 时间。

calendar_events[].domains
array<string> 必填

附加到该记录的市场或主体域。

calendar_events[].end_time
string (date-time) 可选

已知时的事件结束 UTC 时间。

calendar_events[].entities
array<object> 必填

与该记录关联的资产和非资产主体。
calendar_events[].entities[].asset_class
string 可选

资产的类别，与 asset_id 一同发送。

允许的值
equitycommodityindexcrypto
calendar_events[].entities[].asset_id
string 可选

对于股票、大宗商品、指数或代币，这是资产端点所接受的 asset_id；对于人物、账户和话题，以及 Nebula 无法归类的少数资产，则不存在。

calendar_events[].entities[].confidence
number (float) 可选

可用时的实体关联置信度。

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

Nebula 为关联实体分配的 id，例如 eq:NVDA、gecko:1 或 text:ai。要查询该实体，请使用同一对象中的 asset_id 和 asset_class，或 subject_id。

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

当此实体是该记录的主要关联实体时为 true。

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

人类可读的名称。

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

所关联实体与日历事件的关系。

calendar_events[].entities[].subject_id
string 可选

对于人物、账户或话题，这是主体感知端点所接受的 subject_id；对于资产则不存在。

calendar_events[].event_metadata
object 可选

特定于事件类型的结构化元数据。键因事件类型而异。

calendar_events[].event_subtype
string 可选

可用时更具体的事件分类。

calendar_events[].event_type
string 必填

高层级事件分类。

calendar_events[].importance_score
integer 必填

重要程度，从 1（低）到 3（高）。

calendar_events[].location
string 可选

已知地点时事件实际发生的位置。线上和链上事件不包含此项。

calendar_events[].long_term_impact_score
integer 必填

预估的长期市场影响，从 1（低）到 3（高）。

calendar_events[].macro_impact_score
integer 必填

预估的宏观经济影响，从 1（低）到 3（高）。

calendar_events[].price_impact_score
integer 必填

预估的直接价格影响，从 1（低）到 3（高）。

calendar_events[].short_term_impact_score
integer 必填

预估的短期市场影响，从 1（低）到 3（高）。

calendar_events[].source_count
integer 必填

支持该事件的来源数量。

calendar_events[].sources
array<object> 必填

支持父响应的来源记录。
calendar_events[].sources[].external_id
string 必填

由外部来源分配的标识符。

calendar_events[].sources[].provider
string 可选

可用时的上游数据提供方。

calendar_events[].sources[].published_at
string (date-time) 必填

UTC 发布时间。

calendar_events[].sources[].publisher
string 可选

可用时的原始发布方。

calendar_events[].sources[].source
string 必填

来源平台或数据源。

calendar_events[].sources[].subtype
string 必填

来源子类型。

calendar_events[].sources[].trusted
boolean 必填

该来源是否被归类为可信。

calendar_events[].sources[].url
string 可选

可用时的公开来源 URL。

calendar_events[].start_time
string (date-time) 必填

情报条目或事件开始的 UTC 时间。

calendar_events[].status
string 必填

事件的当前生命周期状态：scheduled、tentative、cancelled 或 postponed。

calendar_events[].summary
string 可选

基于证据的情报条目摘要。

calendar_events[].tags
array<string> 必填

附加到该记录的可搜索标签。

calendar_events[].tail_risk_impact_score
integer 必填

预估的尾部风险影响，从 1（低）到 3（高）。

calendar_events[].time_precision
string 必填

已发布事件时间的精度：minute、hour、day、week、month、year 或 unknown。精度为 day 的事件从当天 00:00 UTC 开始。

calendar_events[].title
string 必填

人类可读的事件标题。

calendar_events[].trusted_source_count
integer 必填

标记为可信的支持来源数量。

calendar_events[].updated_at
string (date-time) 必填

记录最后更新时的 UTC 时间。

{
  "calendar_events": [
    {
      "calendar_event_id": "earnings:nvda:2026-q3",
      "confidence_score": 9,
      "created_at": "2026-08-06T10:00:00Z",
      "domains": [
        "equities",
        "technology"
      ],
      "end_time": "2026-08-20T21:00:00Z",
      "entities": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "confidence": 0.98,
          "entity_id": "eq:NVDA",
          "is_primary": true,
          "name": "NVIDIA Corporation",
          "role": "affected",
          "subject_id": "text:jensen huang"
        }
      ],
      "event_metadata": {
        "fiscal_quarter": "Q3",
        "fiscal_year": 2026
      },
      "event_subtype": "quarterly_results",
      "event_type": "earnings",
      "importance_score": 3,
      "location": "Santa Clara, California",
      "long_term_impact_score": 2,
      "macro_impact_score": 1,
      "price_impact_score": 3,
      "short_term_impact_score": 3,
      "source_count": 4,
      "sources": [
        {
          "external_id": "0001045810-26-000123",
          "provider": "SEC EDGAR",
          "published_at": "2026-08-07T14:30:00Z",
          "publisher": "NVIDIA Corporation",
          "source": "sec",
          "subtype": "filing",
          "trusted": true,
          "url": "https://www.sec.gov/Archives/edgar/data/1045810/example.htm"
        }
      ],
      "start_time": "2026-08-20T20:00:00Z",
      "status": "scheduled",
      "summary": "Management raised guidance after stronger-than-expected data-centre demand.",
      "tags": [
        "earnings",
        "data_centres"
      ],
      "tail_risk_impact_score": 1,
      "time_precision": "exact",
      "title": "NVIDIA Q3 2026 earnings",
      "trusted_source_count": 3,
      "updated_at": "2026-08-07T14:35:00Z"
    }
  ]
}