Perfil de volumen social
/social-volume-profile
Un perfil de volumen formado por publicaciones en lugar de operaciones: dónde se produjo la conversación sobre un activo en el eje de precios. Cada bin tiene recuentos de publicaciones, proporciones alcistas y bajistas, y directional_imbalance de −1 (todo bajista) a +1 (todo alcista); significance_score clasifica los bins de 0 a 1 según las publicaciones, el equilibrio, con qué frecuencia el precio los revisita y la compresión; el punto de control es el bin con más actividad. Envía clusters para perfilar un grupo.
Pago con wallet disponible en https://nebula-api.hiddensystems.ai/api/v1/x402/social-volume-profile. No se requiere cuenta de Nebula ni clave de API; consulta la oferta de pago antes de firmar. Guía de pago x402.
Parámetros
ID del activo de /assets o /search, como NVDA, GLD, SPX o bitcoin. Envíalo junto con el asset_class que se devolvió con él.
Example:NVDA
Clase del activo nombrado por asset_id: equity (acciones y ETF), commodity, index o crypto. Envía el asset_class que /assets o /search devolvió junto con el asset_id.
equitycommodityindexcrypto
Example:equity
Ventana de retroceso en horas. Los planes gratuitos llegan hasta 90 días; más allá devuelve 403.
Default:168
Número de bins de precio.
Default:30
Clusters de autores que se van a leer; repite para combinarlos, por ejemplo clusters=kols&clusters=media. Los clusters seleccionados se suman, y un autor puede pertenecer a varios.
- Callers:
smart_money(los de mejor rendimiento),dumb_money(los de peor rendimiento),top_degens(los mejores en cripto de pequeña capitalización) - Timing:
early_movers(los primeros en hablar de un activo cuando la atención aumenta),late_movers(llegan al pico o después) - Builders:
developers,founders,team_leaders,project_accounts - Instituciones:
vcs,asset_managers,dao_guild_funds,incubators,exchanges - Influencia:
kols,celebrities,media,marketer,shiller - Analistas:
ta_analyst,fa_analyst,macro_analyst,onchain_analyst,investigators - Traders:
position_trader,swing_trader,day_trader - Sesgo:
perma_bull,doomer,tribalist - Otros:
political,nft,bots,automated_ai - Comunidades, según dónde se hizo la publicación:
wallstreetbets,reddit
Example:smart_money
Ejemplo de 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'Respuestas
Tipo de medio application/json
bins
array<object>
Bins de precio ordenados de menor a mayor.
bins
Bins de precio ordenados de menor a mayor.
bins[].balance_score
Cuán uniformemente se reparte la actividad entre las direcciones, de 0 a 1.
bins[].bearish_posts
Publicaciones clasificadas como bearish.
bins[].bearish_share
Proporción bajista de las publicaciones direccionales en este bin, de 0 a 1.
bins[].bullish_posts
Publicaciones clasificadas como bullish.
bins[].bullish_share
Proporción alcista de las publicaciones direccionales en este bin, de 0 a 1.
bins[].compression_score
Cuán lentamente se movió el precio mientras estuvo en el bin, de 0 a 1.
bins[].directional_imbalance
Desequilibrio de publicaciones direccionales (alcistas − bajistas) / (alcistas + bajistas), de −1 a 1; ausente cuando no hay publicaciones direccionales.
bins[].is_point_of_control
True para el bin que contiene la mayor actividad de publicaciones.
bins[].neutral_posts
Publicaciones clasificadas como neutral.
bins[].price_high_usd
Borde superior exclusivo del bin de precio en dólares estadounidenses.
bins[].price_low_usd
Borde inferior inclusivo del bin de precio en dólares estadounidenses.
bins[].price_mid_usd
Punto medio del bin de precio en dólares estadounidenses.
bins[].significance_score
Puntuación de prominencia compuesta del bin, de 0 a 1.
bins[].total_posts
Recuento de publicaciones en la ventana de retrospectiva activa de la métrica.
bins[].total_share
Recuento de publicaciones en relación con el bin con más actividad, de 0 a 1.
bins[].visit_count
Número de veces independientes en que el precio de mercado entró en este bin durante la ventana.
maximum_posts_in_bin
Recuento de publicaciones en el bin de precio con más actividad.
maximum_price_usd
Precio más alto del perfil en dólares estadounidenses.
metadata
object
Metadatos de metodología y de la ventana de la solicitud necesarios para interpretar la respuesta.
metadata
Metadatos de metodología y de la ventana de la solicitud necesarios para interpretar la respuesta.
metadata.as_of
Hora UTC en la que se calculó la métrica.
metadata.bin_count
Número de bins de precio solicitados.
metadata.clusters
Resultados indexados o agrupados por identificador canónico de clúster de autores.
metadata.hours
Ventana de lookback representada por la respuesta, en horas.
metadata.priced_buckets
Buckets de sentimiento que se emparejaron correctamente con un precio de mercado.
metadata.unpriced_buckets
Buckets de sentimiento omitidos porque no había ningún precio de mercado cercano disponible.
minimum_price_usd
Precio más bajo del perfil en dólares estadounidenses.
point_of_control_bin_index
Índice basado en cero del bin con más actividad; ausente cuando el perfil está vacío.
total_posts
Recuento de publicaciones en la ventana de retrospectiva activa de la métrica.
{
"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
}