소셜 거래량 프로필
/social-volume-profile
거래 대신 게시물로 구성된 거래량 프로파일로, 가격 축에서 자산에 대한 대화가 어디에서 일어났는지를 보여줍니다. 각 구간에는 게시물 수, 강세 및 약세 비중, 그리고 −1(전부 약세)에서 +1(전부 강세)까지의 directional_imbalance가 있습니다. 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(성과가 가장 좋은 콜러),dumb_money(성과가 가장 나쁜 콜러),top_degens(소형주 크립토에서 가장 우수한 콜러) - Timing:
early_movers(관심이 높아질 때 자산에 대해 가장 먼저 언급),late_movers(정점이나 그 이후에 진입) - 빌더:
developers,founders,team_leaders,project_accounts - 기관:
vcs,asset_managers,dao_guild_funds,incubators,exchanges - 인플루언스:
kols,celebrities,media,marketer,shiller - 애널리스트:
ta_analyst,fa_analyst,macro_analyst,onchain_analyst,investigators - 트레이더:
position_trader,swing_trader,day_trader - 바이어스:
perma_bull,doomer,tribalist - 기타:
political,nft,bots,automated_ai - 게시 위치에 따른 커뮤니티:
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
응답이 나타내는 조회 기간(lookback window)으로, 시간 단위입니다.
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
}