すべてのドキュメント Nebula ドキュメント すべてのエンドポイント インタラクティブドキュメント Markdown OpenAPI JSON
  1. REST API
  2. ソーシャル & センチメント

関連トピック

GET /related-subjects
GetRelatedSubjects

ある資産やトピックと同じ投稿内で最も頻繁に言及される人物、アカウント、トピック。share はアンカーの投稿に占める共有投稿の割合で、sentiment フィールドはそれらの共有投稿内におけるアンカーのセンチメントです。

パラメータのルール:

  • asset_idまたはsubject_idを送信します。
  • asset_id は asset_class と一緒に送信する必要があります。
  • subject_id は asset_id または asset_class と組み合わせることはできません。

ウォレット支払いは https://nebula-api.hiddensystems.ai/api/v1/x402/related-subjects で利用できます。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

hours integer QUERY

遡及ウィンドウ（時間単位）。無料プランでは 90 日まで遡及できます。それより前を指定すると 403 が返されます。

Default:168

limit integer QUERY

返される結果の最大数。

Default:25

cURL の例

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/related-subjects' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --header 'X-API-Key: YOUR_API_KEY'

レスポンス

200 OK
400 不正なリクエスト
401 未認証
402 クレジットを使い切りました。レスポンスには更新時期と購入済みクレジット残高が含まれます
403 アクセス拒否
404 見つかりません
405 メソッドが許可されていません。Allow ヘッダーにサポートされているメソッドが記載されています。
429 リクエストが多すぎます
500 内部サーバーエラー
503 サービス利用不可

メディアタイプ application/json

authors
integer (int64) 必須

一致した投稿に含まれる重複のない投稿者数。

average_sentiment_score
number (double) 必須

指定した期間内のすべてのアンカー投稿におけるセンチメントスコアの平均。

from
string (date-time) 必須

計測対象期間の開始時点（UTC、開始を含む）。

hours
integer 必須

レスポンスが対象とするルックバック期間（時間単位）。

posts
integer (int64) 必須

指定した期間内で一致した投稿数。

subjects
array<object> 必須

discovery オペレーションが返す、資産以外のトピック。
subjects[].authors
integer (int64) 必須

一致した投稿に含まれる重複のない投稿者数。

subjects[].bearish_posts
integer (int64) 必須

弱気と分類された投稿。

subjects[].bullish_posts
integer (int64) 必須

強気と分類された投稿。

subjects[].first_post_at
string (date-time) 任意

指定した期間内で最初に一致した投稿の時刻（UTC）。

subjects[].last_post_at
string (date-time) 任意

指定した期間内で最後に一致した投稿の時刻（UTC）。

subjects[].name
string 必須

人間が読める名前。

subjects[].neutral_posts
integer (int64) 必須

中立と分類された投稿。

subjects[].posts
integer (int64) 必須

指定した期間内で一致した投稿数。

subjects[].posts_delta
number (double) 必須

posts_prior から posts_recent への変化率。正の値は増加を示します。

subjects[].posts_prior
integer (int64) 必須

指定した期間の前半で一致した投稿。

subjects[].posts_recent
integer (int64) 必須

指定した期間の後半で一致した投稿。

subjects[].sentiment_delta
number (double) 必須

共有された会話の sentiment_score と、アンカーの全期間平均との差。

subjects[].sentiment_score
number (double) 必須

符号付きセンチメントスコア。正は強気、負は弱気を表します。

subjects[].share
number (double) 必須

期間内のすべてのアンカー投稿のうち、このトピックにも言及しているアンカー投稿の小数割合。

subjects[].subject_id
string 必須

アセット以外の人物、アカウント、トピックの正規識別子。

to
string (date-time) 必須

計測対象期間の終了時点（UTC、終了を含まない）。

{
  "authors": 241,
  "average_sentiment_score": 36.2,
  "from": "2026-08-15T09:00:00Z",
  "hours": 168,
  "posts": 684,
  "subjects": [
    {
      "authors": 73,
      "bearish_posts": 41,
      "bullish_posts": 112,
      "first_post_at": "2026-08-15T09:00:00Z",
      "last_post_at": "2026-08-22T08:45:00Z",
      "name": "Artificial Intelligence",
      "neutral_posts": 31,
      "posts": 184,
      "posts_delta": 0.556,
      "posts_prior": 72,
      "posts_recent": 112,
      "sentiment_delta": 8.4,
      "sentiment_score": 42.6,
      "share": 0.148,
      "subject_id": "text:artificial intelligence"
    }
  ],
  "to": "2026-08-22T09:00:00Z"
}