Toda la documentación Documentación de Nebula Todos los endpoints Documentación interactiva Markdown JSON de OpenAPI
  1. API REST
  2. Clústeres

Ciclos de hype de clústeres

GET /clusters/hype-cycles
GetClusterHypeCycles

Con cuánta antelación llega un clúster a los ciclos de hype en comparación con el mercado. curve es la proporción acumulada de publicaciones de cada lado desde 7 días antes de un pico hasta 7 después, por lo que la línea más a la izquierda es más temprana; lead_days es la ventaja del clúster (positiva es temprano) y clusters clasifica la ventaja de cada clúster.

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/hype-cycles. 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 de picos de mercado incluir, contando hacia atrás desde el último día completo: 30 o 90. 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/hype-cycles' \
  --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

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.

clusters
array<object> obligatorio

Todos los clústeres con una ventaja (5 ciclos o más), los más tempranos primero, incluido el solicitado.
clusters[].cluster_id
string obligatorio

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

clusters[].cycles_joined
integer obligatorio

Ciclos de hype completados en los que el clúster publicó dentro de las 24 horas posteriores a la hora del pico del mercado.

clusters[].lead_days
number (double) obligatorio

La ventaja del clúster en días, calculada como el lead_days de nivel superior. Positiva es temprano.

clusters[].lead_high_days
number (double) obligatorio

Extremo superior del rango probable de lead_days.

clusters[].lead_low_days
number (double) obligatorio

Extremo inferior del rango probable de lead_days.

curve
array<object> obligatorio

La acumulación media, un punto por cada day_offset de −7 a +7; vacío cuando no se ha completado ningún ciclo.
curve[].cluster_cumulative_pct
number (double) obligatorio

Porcentaje de las publicaciones del clúster en los 15 días alrededor del pico realizadas al final de este día, promediado entre ciclos; 100 en day_offset 7.

curve[].day_offset
integer obligatorio

Días desde el pico del mercado: negativo antes de él, 0 el día del pico, positivo después.

curve[].market_cumulative_pct
number (double) obligatorio

Lo mismo para el mercado, en los mismos ciclos.

cycles_joined
integer obligatorio

Ciclos de hype completados a los que se unió el clúster: 3 o más publicaciones dentro de los 7 días posteriores al pico.

days
integer obligatorio

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

lead_days
number (double) obligatorio

Con cuánta antelación llegan las publicaciones del clúster respecto a todos los demás dentro de las 24 horas posteriores a la hora del pico del mercado, en días. Positiva es temprano; null con menos de 20 ciclos.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "clusters": [
    {
      "cluster_id": "wallstreetbets",
      "cycles_joined": 171,
      "lead_days": 0.0542,
      "lead_high_days": 0.0708,
      "lead_low_days": 0.0417
    },
    {
      "cluster_id": "smart_money",
      "cycles_joined": 471,
      "lead_days": 0.0125,
      "lead_high_days": 0.0292,
      "lead_low_days": -0.0083
    },
    {
      "cluster_id": "exchanges",
      "cycles_joined": 466,
      "lead_days": -0.0667,
      "lead_high_days": -0.0542,
      "lead_low_days": -0.0792
    }
  ],
  "curve": [
    {
      "cluster_cumulative_pct": 46.8,
      "day_offset": -1,
      "market_cumulative_pct": 38.2
    },
    {
      "cluster_cumulative_pct": 63.5,
      "day_offset": 0,
      "market_cumulative_pct": 57.9
    },
    {
      "cluster_cumulative_pct": 73.1,
      "day_offset": 1,
      "market_cumulative_pct": 69.4
    }
  ],
  "cycles_joined": 27,
  "days": 90,
  "lead_days": 0.0125
}