情緒

GET /sentiment
GetSentiment

一段時間內,關於某資產、某主題或整體市場的討論有多看多或多看空。sentiment_signal 是過去 24 小時內看多貼文數減去看空貼文數,近期貼文權重較高:正值代表淨看多。此值會隨討論量成長,因此請將資產與其自身歷史相比。

cohorts 提供機器人以及(針對單一資產或主題)top callers 的相同量測。傳送 clusters 可讀取一個或多個作者群組,或省略資產與主題以取得整體市場檢視。

參數規則:

  • asset_id 必須與 asset_class 一起傳送。
  • subject_id 不能與 asset_id 或 asset_class 合併使用。
  • 若未提供 asset_id,asset_class 必須為 equity 或 crypto;commodity 與 index 則需要 asset_id。

可使用錢包於 https://nebula-api.hiddensystems.ai/api/v1/x402/sentiment 付款。不需要 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(股票、大宗商品與指數;預設值)或 crypto。

允許的值
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

granularity string QUERY

要求的時間序列分桶大小。省略時,服務會依回看區間選擇合適的分桶大小。

允許的值
1h2h4h12h1d

Example:1h

clusters array<string> QUERY

要讀取的作者叢集;可重複指定以合併,例如 clusters=kols&clusters=media。選取的叢集會加總在一起,而一位作者可以隸屬於多個叢集。

  • Callers:smart_money(表現最佳的 caller)、dumb_money(表現最差的)、top_degens(小型加密貨幣上表現最佳)
  • Timing:early_movers(在關注度上升時率先談到某項資產)、late_movers(在高峰或之後才到)
  • Builders:developers、founders、team_leaders、project_accounts
  • Institutions:vcs、asset_managers、dao_guild_funds、incubators、exchanges
  • Influence:kols、celebrities、media、marketer、shiller
  • Analysts:ta_analyst、fa_analyst、macro_analyst、onchain_analyst、investigators
  • Traders:position_trader、swing_trader、day_trader
  • Bias:perma_bull、doomer、tribalist
  • Other:political、nft、bots、automated_ai
  • Communities,依貼文發布的位置:wallstreetbets、reddit

Example:smart_money

cURL 範例

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/sentiment' \
  --header 'X-API-Key: YOUR_API_KEY'

回應

200 OK
400 錯誤的要求
401 未經授權
402 額度已用完;回應會包含續約時間與已購買的額度餘額
403 禁止
404 找不到
405 不允許的方法;Allow 標頭會列出支援的方法
429 要求過多
500 內部伺服器錯誤
503 服務無法使用

媒體類型 application/json

cohorts
object 必填

其他作者群組的相同量測:bots,以及當該族群可用時的 top_callers。非機器人族群即為 series 本身。

允許的鍵
botstop_callers
cohorts.{key}[].bearish_posts
number (double) 必填

截至此時間點過去 24 小時內的看空貼文數;interval_bearish_posts 則是該分桶的數量。

cohorts.{key}[].bullish_posts
number (double) 必填

截至此時間點過去 24 小時內的看多貼文數;interval_bullish_posts 則是該分桶的數量。

cohorts.{key}[].interval_bearish_posts
number (double) 選填

此輸出時間分桶內的看空貼文數。

cohorts.{key}[].interval_bullish_posts
number (double) 選填

此輸出時間分桶內的看多貼文數。

cohorts.{key}[].interval_neutral_posts
number (double) 選填

此輸出時間分桶內的中性貼文數。

cohorts.{key}[].interval_posts
number (double) 選填

此輸出時間分桶內的貼文數,尚未累計回看期間。

cohorts.{key}[].neutral_posts
number (double) 必填

截至此時間點過去 24 小時內的中性貼文數;interval_neutral_posts 則是該分桶的數量。

cohorts.{key}[].sentiment_signal
number (double) 必填

經衰減加權的淨看多貼文數:看多減去看空。正值代表看多,負值代表看空,且幅度會隨活動量成長。

cohorts.{key}[].timestamp
string (date-time) 必填

觀測值或分桶開始時間的 UTC RFC 3339 時間戳記。

cohorts.{key}[].total_posts
number (double) 必填

截至此時間點過去 24 小時內的貼文數,而非僅此分桶;interval_posts 則是該分桶的數量。

series
array<object> 必填

依時間順序排列的觀測值。

series[].bearish_posts
number (double) 必填

截至此時間點過去 24 小時內的看空貼文數;interval_bearish_posts 則是該分桶的數量。

series[].bullish_posts
number (double) 必填

截至此時間點過去 24 小時內的看多貼文數;interval_bullish_posts 則是該分桶的數量。

series[].interval_bearish_posts
number (double) 選填

此輸出時間分桶內的看空貼文數。

series[].interval_bullish_posts
number (double) 選填

此輸出時間分桶內的看多貼文數。

series[].interval_neutral_posts
number (double) 選填

此輸出時間分桶內的中性貼文數。

series[].interval_posts
number (double) 選填

此輸出時間分桶內的貼文數,尚未累計回看期間。

series[].neutral_posts
number (double) 必填

截至此時間點過去 24 小時內的中性貼文數;interval_neutral_posts 則是該分桶的數量。

series[].sentiment_signal
number (double) 必填

經衰減加權的淨看多貼文數:看多減去看空。正值代表看多,負值代表看空,且幅度會隨活動量成長。

series[].timestamp
string (date-time) 必填

觀測值或分桶開始時間的 UTC RFC 3339 時間戳記。

series[].total_posts
number (double) 必填

截至此時間點過去 24 小時內的貼文數,而非僅此分桶;interval_posts 則是該分桶的數量。

{
  "cohorts": {
    "bots": [
      {
        "bearish_posts": 438,
        "bullish_posts": 1120,
        "neutral_posts": 284,
        "sentiment_signal": 128.6,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 1842
      }
    ]
  },
  "series": [
    {
      "bearish_posts": 438,
      "bullish_posts": 1120,
      "interval_bearish_posts": 18,
      "interval_bullish_posts": 46,
      "interval_neutral_posts": 10,
      "interval_posts": 74,
      "neutral_posts": 284,
      "sentiment_signal": 128.6,
      "timestamp": "2026-08-07T15:00:00Z",
      "total_posts": 1842
    }
  ]
}