すべてのドキュメント 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 必須

信頼済みとしてマークされた裏付けソースの数。

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