Perfil de clúster
/clusters/profile
Los rasgos de comportamiento de un clúster, cada uno clasificado frente a todos los demás clústeres (rank 1 es el más alto):
earliness(días): con cuánta antelación publica alrededor de los picos de los ciclos de hype; positivo es temprano.contrarian(proporción): activos en los que se inclina en sentido contrario al mercado.hype_fade(días): positivo significa que se vuelve menos alcista a medida que crece el hype.conviction(días): cuánto tiempo mantiene la misma opinión sobre un activo.focus(proporción): publicaciones sobre sus 5 principales activos.breadth(recuento): activos de los que habla.bullishness(proporción): proporción alcista de sus publicaciones alcistas y bajistas.discovery(proporción): publicaciones sobre activos fuera del top 100 del mercado.turnover(proporción): cuánto cambian sus 10 activos principales de una semana a otra.coverage(proporción): ciclos de hype en los que participó.
Un ciclo de hype es un día en el que las publicaciones sobre un activo se disparan hasta al menos 3× lo normal. Solo días UTC completos.
Reglas de los parámetros:
- Envía
cluster_id. cluster_idnombra un clúster; para comparar varios, llama una vez por clúster o usa /clusters para todos los clústeres a la vez.- Las comunidades de publicación (
wallstreetbets,reddit) solo cubren acciones: con una de ellas,asset_classdebe incluirequity.
Pago con wallet disponible en https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/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
El clúster que se va a analizar, tal como lo devuelve /clusters, por ejemplo smart_money o wallstreetbets. Cualquier id del parámetro clusters de /sentiment.
Example:smart_money
Los mercados que se van a analizar: cualquiera de equity, commodity, index y crypto, separados por comas. Por defecto, los cuatro. Envía varios separados por comas.
Default:equity,commodity,index,crypto
Cuántos días UTC completos analizar, contando hacia atrás desde el último día completo: 30 o 90. Las ventanas más largas ven más ciclos de hype, por lo que los rasgos de los ciclos son más estables. Los planes gratuitos llegan hasta 90 días atrás; más allá devuelve 403.
3090
Default:90
Ejemplo de cURL
curl --get \
--url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/profile' \
--data-urlencode 'cluster_id=smart_money' \
--header 'X-API-Key: YOUR_API_KEY'
Respuestas
Tipo de medio application/json
active_clusters
Clústeres activos en la ventana: los rasgos de población se ordenan dentro de ella.
asset_classes
Los mercados analizados, en el orden equity, commodity, index, crypto: los valores de asset_class solicitados, o los cuatro cuando se omitió asset_class.
cluster_id
El clúster analizado, como su cluster_id canónico.
days
Duración de la ventana en días UTC completos, terminando en el último día completo.
hype_cycles
Ciclos de hype del mercado en la ventana: activos cuyas publicaciones alcanzaron un pico de 50 o más en un día y al menos 3× su día mediano.
traits
array<object>
Una entrada por rasgo, en el orden earliness, contrarian, hype_fade, conviction, focus, breadth, bullishness, discovery, turnover, coverage.
traits
Una entrada por rasgo, en el orden earliness, contrarian, hype_fade, conviction, focus, breadth, bullishness, discovery, turnover, coverage.
traits[].peer_values
El valor de cada uno de los demás clústeres para este rasgo, en orden ascendente.
traits[].percentile
De 0 (el más bajo) a 1 (el más alto) entre los clústeres con un valor. Null cuando el valor es null.
traits[].rank
1 es el valor más alto; los clústeres empatados comparten la mejor posición. Null cuando el valor es null.
traits[].trait
El rasgo medido; la descripción de la operación define cada uno.
earlinesscontrarianhype_fadeconvictionfocusbreadthbullishnessdiscoveryturnovercoverage
traits[].unit
días, proporción (0 a 1) o recuento; fijo por rasgo.
dayssharecount
traits[].value
El valor del clúster para este rasgo, en unit; null cuando el clúster tiene muy pocos datos para calcularlo.
{
"active_clusters": 34,
"asset_classes": [
"equity",
"commodity",
"index",
"crypto"
],
"cluster_id": "smart_money",
"days": 90,
"hype_cycles": 41,
"traits": [
{
"peer_values": [
-1.8,
-0.64,
0.12,
0.87,
2.05
],
"percentile": 0.9394,
"rank": 3,
"trait": "earliness",
"unit": "days",
"value": 1.42
},
{
"peer_values": [
0.041,
0.083,
0.112,
0.204,
0.267
],
"percentile": 0.7576,
"rank": 9,
"trait": "contrarian",
"unit": "share",
"value": 0.1875
},
{
"peer_values": [
-1.1,
-0.3,
0.2,
0.9,
1.4
],
"percentile": 0.8182,
"rank": 7,
"trait": "hype_fade",
"unit": "days",
"value": 0.6
},
{
"peer_values": [
1.4,
1.9,
2.2,
2.8,
3.6
],
"percentile": 0.6667,
"rank": 12,
"trait": "conviction",
"unit": "days",
"value": 2.35
},
{
"peer_values": [
0.18,
0.24,
0.35,
0.47,
0.72
],
"percentile": 0.4242,
"rank": 20,
"trait": "focus",
"unit": "share",
"value": 0.31
},
{
"peer_values": [
41,
96,
188,
405,
1270
],
"percentile": 0.8485,
"rank": 6,
"trait": "breadth",
"unit": "count",
"value": 312
},
{
"peer_values": [
0.52,
0.64,
0.71,
0.78,
0.86
],
"percentile": 0.6061,
"rank": 14,
"trait": "bullishness",
"unit": "share",
"value": 0.7412
},
{
"peer_values": [
0.09,
0.17,
0.26,
0.38,
0.61
],
"percentile": 0.5152,
"rank": 17,
"trait": "discovery",
"unit": "share",
"value": 0.2837
},
{
"peer_values": [
0.18,
0.27,
0.36,
0.44,
0.58
],
"percentile": 0.3939,
"rank": 21,
"trait": "turnover",
"unit": "share",
"value": 0.3455
},
{
"peer_values": [
0.05,
0.22,
0.41,
0.63,
0.88
],
"percentile": 0.7879,
"rank": 8,
"trait": "coverage",
"unit": "share",
"value": 0.6585
}
]
}