所有文件 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 金鑰；簽署前請先確認付款條件。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 額度已用完；回應會包含續約時間與已購買的額度餘額
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 必填

標記為 trusted 的佐證來源數量。

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