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

各時間範圍的情緒

GET /sentiment/timeframes
GetSentimentTimeframes

依人們談論的時間跨度區分情緒：短期（最多一週）、中期（數週至數個月）與長期（三個月以上），各自採用 /sentiment 的量表。可區分本週看空但全年看多的群眾，與從頭到尾都看空的群眾。

參數規則：

  • 傳送 asset_id 或 subject_id。
  • asset_id 必須與 asset_class 一起傳送。
  • subject_id 不能與 asset_id 或 asset_class 合併使用。

可使用錢包於 https://nebula-api.hiddensystems.ai/api/v1/x402/sentiment/timeframes 付款。不需要 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:720

granularity string QUERY

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

允許的值
1h2h4h12h1d

Example:1h

cURL 範例

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/sentiment/timeframes' \
  --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

current
object 必填

每個可用時間跨度範圍的最新情緒讀數。

允許的鍵
short_termmedium_termlong_term
metadata
object 選填

解讀回應所需的方法論與請求區間中繼資料。
metadata.as_of
string (date-time) 選填

計算該指標的 UTC 時間。

metadata.calculation
string 選填

計算方法的簡短名稱。

metadata.formula
string 選填

計算公式（人類可讀）。

metadata.half_life_hours
number (double) 選填

儘管名稱如此，這是指線性衰減視窗的長度（以小時為單位）：貼文在全新時完整計入，在中點時計為一半，一旦超過這個時間就不再計入。

metadata.lookback_days
integer 選填

計算所使用的歷史回溯期間（以天為單位）。

metadata.scale
string 選填

此指標已發布的量尺或解讀方式。

series
object 必填

以 short_term、medium_term 與 long_term 時間跨度為鍵的情緒序列。

允許的鍵
short_termmedium_termlong_term
series.{key}[].interval_posts
number (double) 選填

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

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

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

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

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

series.{key}[].total_posts
number (double) 選填

該指標作用中回溯視窗內的貼文數。

{
  "current": {
    "long_term": 52.1,
    "medium_term": 57.8,
    "short_term": 64.2
  },
  "series": {
    "short_term": [
      {
        "sentiment_signal": 64.2,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 318
      }
    ]
  }
}