ソーシャルボリュームプロファイル
/social-volume-profile
取引ではなく投稿で構成されるボリュームプロファイルです。ある資産に関する会話が価格軸上のどこで起きたかを示します。各ビンには投稿数、強気と弱気のシェア、そしてdirectional_imbalance（−1はすべて弱気、+1はすべて強気）が含まれます。significance_scoreは投稿数、バランス、価格がそのビンを再訪する頻度、圧縮度に基づいてビンを0〜1で順位付けし、ポイント・オブ・コントロールは最も活発なビンです。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）。選択したクラスターは合算され、1 人の投稿者が複数のクラスターに属することもあります。
- Callers:
smart_money（成績の良い Caller）、dumb_money（成績の悪い Caller）、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
正規のauthor-cluster識別子をキーとして、またはそれでグループ化された結果。
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
}