Comparación de clústeres

GET /clusters/comparison
CompareClusters

Todos los clústeres de autores en paralelo durante la ventana: publicaciones y su variación, cuán alcista es frente al mercado (cluster_bullish_share frente a market_bullish_share), el activo al que más se orientó en los últimos 7 días (trending_asset) y publicaciones diarias.

Pago con wallet disponible en https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/comparison. 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 comparar, contando hacia atrás desde el último día completo: 7, 30 o 90. activity_change_pct compara con el mismo número de días anteriores. Los planes gratuitos llegan hasta 90 días atrás; más allá devuelve 403.

Valores permitidos
73090

Default:30

Ejemplo de cURL

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

clusters
array<object> obligatorio

Todos los clústeres con publicaciones en la ventana, primero los que más publicaciones tienen.

clusters[].activity_change_pct
number (double) obligatorio

Variación porcentual de las publicaciones frente a la ventana anterior de igual longitud (76 publicaciones después de 84 es -9,52); ausente cuando no es posible ninguna comparación.

clusters[].bearish_posts
integer (int64) obligatorio

Las publicaciones bajistas del clúster durante la ventana.

clusters[].bullish_posts
integer (int64) obligatorio

Las publicaciones alcistas del clúster durante la ventana.

clusters[].cluster_bullish_share
number (double) obligatorio

Publicaciones alcistas ÷ (alcistas + bajistas) del clúster durante la ventana, de 0 a 1. Null cuando no hay publicaciones alcistas ni bajistas.

clusters[].cluster_id
string obligatorio

Identificador canónico del clúster de autores.

clusters[].market_bullish_share
number (double) obligatorio

La misma proporción para el mercado que lee el clúster, durante los mismos días y clases de activo (el mercado equity para una comunidad de publicaciones): la línea base cluster_bullish_share con la que se compara. Null cuando no hay publicaciones alcistas ni bajistas.

clusters[].posts
integer (int64) obligatorio

Las publicaciones del clúster durante la ventana.

clusters[].series
array<object> obligatorio

Todos los días UTC completos de la ventana, del más antiguo al más reciente, incluidos los días sin publicaciones.

clusters[].series[].bearish_posts
integer (int64) obligatorio

Las publicaciones bajistas del clúster ese día.

clusters[].series[].bullish_posts
integer (int64) obligatorio

Las publicaciones alcistas del clúster ese día.

clusters[].series[].posts
integer (int64) obligatorio

Las publicaciones del clúster ese día.

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

Inicio del día en UTC: 00:00.

clusters[].trending_asset
object obligatorio

El activo al que el clúster se orientó más de lo que lo hizo el mercado durante los últimos 7 días completos; null cuando no hay ninguno.

clusters[].trending_asset.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
clusters[].trending_asset.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.

clusters[].trending_asset.name
string obligatorio

Nombre legible para personas.

clusters[].trending_asset.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"
  ],
  "clusters": [
    {
      "activity_change_pct": 7.61,
      "bearish_posts": 13550,
      "bullish_posts": 61240,
      "cluster_bullish_share": 0.8188,
      "cluster_id": "media",
      "market_bullish_share": 0.7812,
      "posts": 173412,
      "series": [
        {
          "bearish_posts": 480,
          "bullish_posts": 2210,
          "posts": 6120,
          "timestamp": "2026-09-11T00:00:00Z"
        },
        {
          "bearish_posts": 512,
          "bullish_posts": 2102,
          "posts": 5874,
          "timestamp": "2026-09-12T00:00:00Z"
        }
      ],
      "trending_asset": {
        "asset_class": "equity",
        "asset_id": "NVDA",
        "name": "NVIDIA Corporation",
        "symbol": "NVDA"
      }
    },
    {
      "activity_change_pct": 171.42,
      "bearish_posts": 18860,
      "bullish_posts": 20480,
      "cluster_bullish_share": 0.5206,
      "cluster_id": "wallstreetbets",
      "market_bullish_share": 0.7035,
      "posts": 88034,
      "series": [
        {
          "bearish_posts": 702,
          "bullish_posts": 790,
          "posts": 3310,
          "timestamp": "2026-09-11T00:00:00Z"
        },
        {
          "bearish_posts": 681,
          "bullish_posts": 655,
          "posts": 2987,
          "timestamp": "2026-09-12T00:00:00Z"
        }
      ],
      "trending_asset": {
        "asset_class": "equity",
        "asset_id": "ORCL",
        "name": "Oracle Corporation",
        "symbol": "ORCL"
      }
    }
  ],
  "days": 30
}