Профиль социального объёма
/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.
Параметры
Asset ID из /assets или /search, например NVDA, GLD, SPX или bitcoin. Передавайте его вместе с возвращённым рядом с ним asset_class.
Example:NVDA
Класс актива, указанного в asset_id: equity (акции и ETF), commodity, index или crypto. Передавайте asset_class, который /assets или /search вернули вместе с asset_id.
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
Посты, классифицированные как bearish.
bins[].bearish_share
Доля медвежьих постов среди направленных постов в этом бине, от 0 до 1.
bins[].bullish_posts
Посты, классифицированные как bullish.
bins[].bullish_share
Доля бычьих постов среди направленных постов в этом бине, от 0 до 1.
bins[].compression_score
Насколько медленно двигалась цена, пока находилась в бине, от 0 до 1.
bins[].directional_imbalance
Дисбаланс направленных постов (бычьи − медвежьи) / (бычьи + медвежьи), от −1 до 1; отсутствует при отсутствии направленных постов.
bins[].is_point_of_control
True для бина с наибольшей активностью постов.
bins[].neutral_posts
Посты, классифицированные как neutral.
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
}