Social volume profile
/social-volume-profile
A volume profile made of posts instead of trades: where on the price axis the conversation about an asset happened. Each bin has post counts, bullish and bearish shares, and directional_imbalance from −1 (all bearish) to +1 (all bullish); significance_score ranks the bins from 0 to 1 on posts, balance, how often price revisits them, and compression; the point of control is the busiest bin. Send clusters to profile one group.
Wallet payment available at https://nebula-api.hiddensystems.ai/api/v1/x402/social-volume-profile. No Nebula account or API key required; check the payment offer before signing. x402 payment guide.
Parameters
Asset ID from /assets or /search, such as NVDA, GLD, SPX, or bitcoin. Send it with the asset_class returned alongside it.
Example:NVDA
Class of the asset named by asset_id: equity (stocks and ETFs), commodity, index, or crypto. Send the asset_class that /assets or /search returned alongside the asset_id.
equitycommodityindexcrypto
Example:equity
Lookback window in hours. Free plans reach back 90 days; further returns 403.
Default:168
Number of price bins.
Default:30
Author clusters to read; repeat to combine, for example clusters=kols&clusters=media. Selected clusters are added together, and an author can belong to several.
- Callers:
smart_money(best-performing callers),dumb_money(worst-performing),top_degens(best on small-cap crypto) - Timing:
early_movers(first to talk about an asset as attention rises),late_movers(arrive at the peak or after) - 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, by where the post was made:
wallstreetbets,reddit
Example:smart_money
cURL Example
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'Responses
Media type application/json
bins
array<object>
Price bins ordered from low to high.
bins
Price bins ordered from low to high.
bins[].balance_score
How evenly activity is split between directions, from 0 to 1.
bins[].bearish_posts
Posts classified as bearish.
bins[].bearish_share
Bearish share of directional posts in this bin, from 0 to 1.
bins[].bullish_posts
Posts classified as bullish.
bins[].bullish_share
Bullish share of directional posts in this bin, from 0 to 1.
bins[].compression_score
How slowly price moved while in the bin, from 0 to 1.
bins[].directional_imbalance
Directional post imbalance (bullish − bearish) / (bullish + bearish), from −1 to 1; absent with no directional posts.
bins[].is_point_of_control
True for the bin containing the greatest post activity.
bins[].neutral_posts
Posts classified as neutral.
bins[].price_high_usd
Exclusive upper edge of the price bin in US dollars.
bins[].price_low_usd
Inclusive lower edge of the price bin in US dollars.
bins[].price_mid_usd
Midpoint of the price bin in US dollars.
bins[].significance_score
Composite prominence score for the bin, from 0 to 1.
bins[].total_posts
Post count over the metric's active lookback window.
bins[].total_share
Post count relative to the busiest bin, from 0 to 1.
bins[].visit_count
Separate times the market price entered this bin during the window.
maximum_posts_in_bin
Post count in the busiest price bin.
maximum_price_usd
Highest profile price in US dollars.
metadata
object
Methodology and request-window metadata needed to interpret the response.
metadata
Methodology and request-window metadata needed to interpret the response.
metadata.as_of
UTC time at which the metric was calculated.
metadata.bin_count
Number of requested price bins.
metadata.clusters
Results keyed or grouped by canonical author-cluster identifier.
metadata.hours
Lookback window represented by the response, in hours.
metadata.priced_buckets
Sentiment buckets successfully matched to a market price.
metadata.unpriced_buckets
Sentiment buckets omitted because no nearby market price was available.
minimum_price_usd
Lowest profile price in US dollars.
point_of_control_bin_index
Zero-based index of the busiest bin; absent when the profile is empty.
total_posts
Post count over the metric's active lookback window.
{
"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
}