Perfil de clúster

GET /clusters/profile
GetClusterProfile

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_id nombra 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_class debe incluir equity.

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

cluster_id string QUERY obligatorio

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

asset_class array<string> QUERY

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

days integer QUERY

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.

Valores permitidos
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

200 OK
400 Solicitud incorrecta
401 No autorizado
402 Créditos agotados; la respuesta incluye el momento de renovación y el saldo de créditos comprados
403 Prohibido
404 No encontrado
405 Método no permitido; el encabezado Allow enumera el método admitido
429 Demasiadas solicitudes
500 Error interno del servidor
503 Servicio no disponible

Tipo de medio application/json

active_clusters
integer obligatorio

Clústeres activos en la ventana: los rasgos de población se ordenan dentro de ella.

asset_classes
array<string> obligatorio

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
string obligatorio

El clúster analizado, como su cluster_id canónico.

days
integer obligatorio

Duración de la ventana en días UTC completos, terminando en el último día completo.

hype_cycles
integer obligatorio

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> obligatorio

Una entrada por rasgo, en el orden earliness, contrarian, hype_fade, conviction, focus, breadth, bullishness, discovery, turnover, coverage.

traits[].peer_values
array<number (double)> obligatorio

El valor de cada uno de los demás clústeres para este rasgo, en orden ascendente.

traits[].percentile
number (double) obligatorio

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
integer obligatorio

1 es el valor más alto; los clústeres empatados comparten la mejor posición. Null cuando el valor es null.

traits[].trait
string obligatorio

El rasgo medido; la descripción de la operación define cada uno.

Valores permitidos
earlinesscontrarianhype_fadeconvictionfocusbreadthbullishnessdiscoveryturnovercoverage
traits[].unit
string obligatorio

días, proporción (0 a 1) o recuento; fijo por rasgo.

Valores permitidos
dayssharecount
traits[].value
number (double) obligatorio

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
    }
  ]
}