社群成交量分布
/social-volume-profile
以貼文而非成交構成的成交量分佈：關於某項資產的討論落在價格軸上的哪些位置。每個分箱包含貼文數、看漲與看跌占比，以及 directional_imbalance，範圍從 −1（全為看跌）到 +1（全為看漲）；significance_score 依貼文數、均衡度、價格回訪該分箱的頻率與壓縮程度，將各分箱從 0 到 1 排名；控制點是活動最熱絡的分箱。傳入 clusters 可分析單一群組。
可使用錢包於 https://nebula-api.hiddensystems.ai/api/v1/x402/social-volume-profile 付款。不需要 Nebula 帳號或 API 金鑰；簽署前請先確認付款條件。x402 付款指南。
參數
來自 /assets 或 /search 的資產 ID，例如 NVDA、GLD、SPX 或 bitcoin。請與一併回傳的 asset_class 一起送出。
Example:NVDA
asset_id 所指資產的類別：equity（股票與 ETF）、commodity、index 或 crypto。請送出 /assets 或 /search 隨 asset_id 一併回傳的 asset_class。
equitycommodityindexcrypto
Example:equity
回溯期間，以小時為單位。免費方案可回溯 90 天；更早的期間會回傳 403。
Default:168
價格分箱的數量。
Default:30
要讀取的作者叢集；可重複指定以合併，例如 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 --get \
--url 'https://nebula-api.hiddensystems.ai/api/v1/public/social-volume-profile' \
--data-urlencode 'asset_id=NVDA' \
--data-urlencode 'asset_class=equity' \
--header 'X-API-Key: YOUR_API_KEY'回應
媒體類型 application/json
bins
array<object>
價格分箱，由低到高排序。
bins
價格分箱，由低到高排序。
bins[].balance_score
活動在方向之間分布的均勻程度，從 0 到 1。
bins[].bearish_posts
歸類為看跌的貼文。
bins[].bearish_share
此分箱中方向性貼文的看跌占比，從 0 到 1。
bins[].bullish_posts
歸類為看漲的貼文。
bins[].bullish_share
此分箱中方向性貼文的看漲占比，從 0 到 1。
bins[].compression_score
價格在此分箱內移動的緩慢程度，從 0 到 1。
bins[].directional_imbalance
方向性貼文失衡度（看漲 − 看跌）／（看漲 + 看跌），從 −1 到 1；沒有方向性貼文時從缺。
bins[].is_point_of_control
若此分箱包含最多的貼文活動則為 true。
bins[].neutral_posts
歸類為中性的貼文。
bins[].price_high_usd
價格分箱的上緣（不含），單位為美元。
bins[].price_low_usd
價格分箱的下緣（含），單位為美元。
bins[].price_mid_usd
價格分箱的中點，單位為美元。
bins[].significance_score
此分箱的綜合顯著度分數，從 0 到 1。
bins[].total_posts
該指標作用中回溯視窗內的貼文數。
bins[].total_share
貼文數相對於最熱絡分箱的比例，從 0 到 1。
bins[].visit_count
在該時間範圍內，市場價格進入此分箱的次數（分開計算）。
maximum_posts_in_bin
最熱絡價格分箱中的貼文數。
maximum_price_usd
分佈中的最高價格，單位為美元。
metadata
object
解讀回應所需的方法論與請求區間中繼資料。
metadata
解讀回應所需的方法論與請求區間中繼資料。
metadata.as_of
計算該指標的 UTC 時間。
metadata.bin_count
要求的價格分箱數量。
metadata.clusters
結果以標準作者叢集識別碼為鍵或分組。
metadata.hours
此回應所代表的回看區間，以小時為單位。
metadata.priced_buckets
成功對應到市場價格的情緒分桶。
metadata.unpriced_buckets
因附近沒有可用的市場價格而略過的情緒分桶。
minimum_price_usd
分佈中的最低價格，單位為美元。
point_of_control_bin_index
最熱絡分箱的索引（從 0 起算）；分佈為空時從缺。
total_posts
該指標作用中回溯視窗內的貼文數。
{
"bins": [
{
"balance_score": 0.64,
"bearish_posts": 438,
"bearish_share": 0.32,
"bullish_posts": 1120,
"bullish_share": 0.68,
"compression_score": 0.78,
"directional_imbalance": 0.36,
"is_point_of_control": true,
"neutral_posts": 284,
"price_high_usd": 180,
"price_low_usd": 175,
"price_mid_usd": 177.5,
"significance_score": 0.87,
"total_posts": 1842,
"total_share": 0.82,
"visit_count": 6
}
],
"maximum_posts_in_bin": 286,
"maximum_price_usd": 188.75,
"minimum_price_usd": 161.25,
"point_of_control_bin_index": 14,
"total_posts": 1842
}