情緒
/sentiment
一段時間內,關於某資產、某主題或整體市場的討論有多看多或多看空。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 付款指南。
參數
來自 /assets 或 /search 的資產 ID,例如 NVDA、GLD、SPX 或 bitcoin。請與一併回傳的 asset_class 一起送出。
Example:NVDA
搭配 asset_id 時,代表該資產的類別。未提供時,代表要彙總的市場:equity(股票、大宗商品與指數;預設值)或 crypto。
equitycommodityindexcrypto
Example:equity
由 /subjects 或 /search 回傳的標準非資產識別碼,例如 text:jensen huang 或 handle:elonmusk。大小寫不拘。不能與 asset_id 或 asset_class 合併使用。
Example:text:jensen huang
回溯期間,以小時為單位。免費方案可回溯 90 天;更早的期間會回傳 403。
Default:168
要求的時間序列分桶大小。省略時,服務會依回看區間選擇合適的分桶大小。
1h2h4h12h1d
Example:1h
要讀取的作者叢集;可重複指定以合併,例如 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'
回應
媒體類型 application/json
cohorts
object
其他作者群組的相同量測:bots,以及當該族群可用時的 top_callers。非機器人族群即為 series 本身。
允許的鍵
botstop_callers
cohorts
其他作者群組的相同量測:bots,以及當該族群可用時的 top_callers。非機器人族群即為 series 本身。
botstop_callers
cohorts.{key}[].bearish_posts
截至此時間點過去 24 小時內的看空貼文數;interval_bearish_posts 則是該分桶的數量。
cohorts.{key}[].bullish_posts
截至此時間點過去 24 小時內的看多貼文數;interval_bullish_posts 則是該分桶的數量。
cohorts.{key}[].interval_bearish_posts
此輸出時間分桶內的看空貼文數。
cohorts.{key}[].interval_bullish_posts
此輸出時間分桶內的看多貼文數。
cohorts.{key}[].interval_neutral_posts
此輸出時間分桶內的中性貼文數。
cohorts.{key}[].interval_posts
此輸出時間分桶內的貼文數,尚未累計回看期間。
cohorts.{key}[].neutral_posts
截至此時間點過去 24 小時內的中性貼文數;interval_neutral_posts 則是該分桶的數量。
cohorts.{key}[].sentiment_signal
經衰減加權的淨看多貼文數:看多減去看空。正值代表看多,負值代表看空,且幅度會隨活動量成長。
cohorts.{key}[].timestamp
觀測值或分桶開始時間的 UTC RFC 3339 時間戳記。
cohorts.{key}[].total_posts
截至此時間點過去 24 小時內的貼文數,而非僅此分桶;interval_posts 則是該分桶的數量。
series
array<object>
依時間順序排列的觀測值。
series
依時間順序排列的觀測值。
series[].bearish_posts
截至此時間點過去 24 小時內的看空貼文數;interval_bearish_posts 則是該分桶的數量。
series[].bullish_posts
截至此時間點過去 24 小時內的看多貼文數;interval_bullish_posts 則是該分桶的數量。
series[].interval_bearish_posts
此輸出時間分桶內的看空貼文數。
series[].interval_bullish_posts
此輸出時間分桶內的看多貼文數。
series[].interval_neutral_posts
此輸出時間分桶內的中性貼文數。
series[].interval_posts
此輸出時間分桶內的貼文數,尚未累計回看期間。
series[].neutral_posts
截至此時間點過去 24 小時內的中性貼文數;interval_neutral_posts 則是該分桶的數量。
series[].sentiment_signal
經衰減加權的淨看多貼文數:看多減去看空。正值代表看多,負值代表看空,且幅度會隨活動量成長。
series[].timestamp
觀測值或分桶開始時間的 UTC RFC 3339 時間戳記。
series[].total_posts
截至此時間點過去 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
}
]
}