社交量分布
/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 key；签名前请先查看支付报价。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
最活跃分箱的从零开始的索引；画像为空时缺失。
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
}