すべてのドキュメント 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"
    }
  ]
}