所有文件 Nebula 文件 所有端點 互動式文件 Markdown OpenAPI JSON
  1. REST API
  2. 社群與情緒

相關主體

GET /related-subjects
GetRelatedSubjects

與某個資產或主題最常出現在同一批貼文中的人、帳號與主題。share 是共同貼文佔錨定對象貼文的比例；情緒欄位則是錨定對象在這些共同貼文中的情緒。

參數規則：

  • 傳送 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> 必填

探索操作所傳回的非資產主題。
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"
}