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

Llegadas del ciclo de hype

GET /clusters/comparison/hype-cycles
CompareHypeCycles

Los mayores ciclos de hype de la ventana y el orden en que llegaron los clústeres a cada uno, en relación con la hora punta del mercado, con las publicaciones horarias del mercado en torno a la punta.

Pago con wallet disponible en https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/comparison/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

asset_class array<string> QUERY

Los mercados que se van a comparar: cualquiera de equity, commodity, index y crypto, separados por comas. De forma predeterminada, los cuatro. Envía varios separados por comas.

Default:equity,commodity,index,crypto

days integer QUERY

Cuántos días UTC completos de puntas de mercado incluir, contando hacia atrás desde el último día completo: 7, 30 o 90. Los planes gratuitos llegan hasta 90 días atrás; más allá devuelve 403.

Valores permitidos
73090

Default:30

limit integer QUERY

Máximo de ciclos de hype devueltos: los mayores por publicaciones en su día punta.

Default:40

Ejemplo de cURL

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/comparison/hype-cycles' \
  --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.

cycles
array<object> obligatorio

Los mayores ciclos de hype de la ventana, la punta más reciente primero, hasta el límite.
cycles[].arrivals
array<object> obligatorio

Todos los clústeres con 3 o más publicaciones en las 48 horas en torno a la hora punta, los más tempranos primero.
cycles[].arrivals[].cluster_id
string obligatorio

Identificador canónico del clúster de autores.

cycles[].arrivals[].offset_hours
number (double) obligatorio

Horas desde la hora punta del mercado hasta la hora promedio ponderada por publicaciones de las publicaciones del clúster en las 48 horas en torno a ella. Negativo es antes de la punta.

cycles[].arrivals[].posts
integer (int64) obligatorio

Las publicaciones del clúster sobre el activo en las 48 horas en torno a la hora punta.

cycles[].asset_class
string obligatorio

Clase del activo: equity (acciones y ETF), commodity, index o crypto. Envíala junto con asset_id en cada solicitud con alcance de asset.

Valores permitidos
equitycommodityindexcrypto
cycles[].asset_id
string obligatorio

Identificador público canónico del activo: el ticker o símbolo de mercado para acciones, commodities e índices, y el slug de CoinGecko (o, si no lo hay, un id numérico) para crypto.

cycles[].name
string obligatorio

Nombre legible para personas.

cycles[].peak_day_posts
integer (int64) obligatorio

Las publicaciones del mercado sobre el activo el día punta, excluidos los bots.

cycles[].peak_timestamp
string (date-time) obligatorio

Inicio en UTC de la hora más ajetreada del mercado el día punta.

cycles[].series
array<object> obligatorio

Las publicaciones del mercado sobre el activo hora a hora, desde 24 horas antes de la hora punta hasta 23 horas después: 48 observaciones.
cycles[].series[].posts
integer (int32) obligatorio

Las publicaciones del mercado sobre el activo en la hora, excluidos los bots.

cycles[].series[].timestamp
string (date-time) obligatorio

Inicio de la hora en UTC.

cycles[].symbol
string obligatorio

Ticker o símbolo de mercado para mostrar.

days
integer obligatorio

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

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cycles": [
    {
      "arrivals": [
        {
          "cluster_id": "smart_money",
          "offset_hours": -3.2,
          "posts": 18
        },
        {
          "cluster_id": "team_leaders",
          "offset_hours": -2.1,
          "posts": 9
        },
        {
          "cluster_id": "media",
          "offset_hours": 1.4,
          "posts": 57
        }
      ],
      "asset_class": "equity",
      "asset_id": "ORCL",
      "name": "Oracle Corporation",
      "peak_day_posts": 930,
      "peak_timestamp": "2026-09-10T14:00:00Z",
      "series": [
        {
          "posts": 41,
          "timestamp": "2026-09-10T13:00:00Z"
        },
        {
          "posts": 112,
          "timestamp": "2026-09-10T14:00:00Z"
        },
        {
          "posts": 64,
          "timestamp": "2026-09-10T15:00:00Z"
        }
      ],
      "symbol": "ORCL"
    }
  ],
  "days": 30
}