Toda la documentación Documentación de Nebula Todos los endpoints Documentación interactiva Markdown JSON de OpenAPI

API REST
Clústeres

Rotación de clústeres

GET /clusters/rotation

GetClusterRotation

Hacia dónde se mueve la atención de un clúster: los activos que ganan y pierden proporción de sus publicaciones frente a la ventana anterior, en puntos básicos, y cómo se reparten sus publicaciones entre mercados, personas y eventos.

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/rotation. 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

hours integer QUERY

La ventana con la que comparar, la de la misma longitud inmediatamente anterior: 24 (las últimas 24 horas), 168 (los últimos 7 días completos) o 720 (los últimos 30 días completos). Los planes gratuitos llegan hasta 90 días atrás; más allá devuelve 403.

Valores permitidos

24168720

Default:168

limit integer QUERY

Número máximo de ganadores devueltos y, por separado, número máximo de perdedores.

Default:6

Ejemplo de cURL

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

gainers

array<object> obligatorio

Activos cuya proporción de las publicaciones del clúster más aumentó, primero el mayor aumento. Solo se listan los activos cuya proporción aumentó.

gainers[].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

gainers[].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.

gainers[].current_share

number (double) obligatorio

Publicaciones como fracción de todas las publicaciones del clúster sobre las clases de activos seleccionadas en la ventana actual, de 0 a 1.

gainers[].name

string obligatorio

Nombre legible para personas.

gainers[].previous_share

number (double) obligatorio

Las publicaciones sobre el activo como fracción de todas las publicaciones del clúster en la ventana de comparación, de 0 a 1.

gainers[].share_change_bps

integer obligatorio

current_share menos la proporción en la ventana de comparación, en puntos básicos: 100 es un punto porcentual. Un valor negativo significa que la proporción cayó.

gainers[].symbol

string obligatorio

Ticker o símbolo de mercado para mostrar.

hours

integer obligatorio

Ventana de lookback representada por la respuesta, en horas.

losers

array<object> obligatorio

Activos cuya proporción de las publicaciones del clúster más cayó, primero la mayor caída. Solo se listan los activos cuya proporción cayó.

losers[].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

losers[].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.

losers[].current_share

number (double) obligatorio

Publicaciones como fracción de todas las publicaciones del clúster sobre las clases de activos seleccionadas en la ventana actual, de 0 a 1.

losers[].name

string obligatorio

Nombre legible para personas.

losers[].previous_share

number (double) obligatorio

Las publicaciones sobre el activo como fracción de todas las publicaciones del clúster en la ventana de comparación, de 0 a 1.

losers[].share_change_bps

integer obligatorio

current_share menos la proporción en la ventana de comparación, en puntos básicos: 100 es un punto porcentual. Un valor negativo significa que la proporción cayó.

losers[].symbol

string obligatorio

Ticker o símbolo de mercado para mostrar.

topic_changes

array<object> obligatorio

La proporción de cada tema en la ventana actual y su cambio frente a la anterior, en el orden equity, commodity, index, crypto, people, events.

topic_changes[].current_share

number (double) obligatorio

La proporción del tema en las publicaciones del clúster en la ventana actual, de 0 a 1.

topic_changes[].share_change_bps

integer obligatorio

Cambio de proporción frente a la ventana anterior, en puntos básicos (100 es un punto porcentual).

topic_changes[].topic

string obligatorio

equity, commodity, index, crypto, people (personas y sus cuentas) o events (lugares, temas y eventos).

Valores permitidos

equitycommodityindexcryptopeopleevents

topic_series

array<object> obligatorio

La proporción de cada tema en las publicaciones del clúster por día UTC completo, del más antiguo al más reciente.

topic_series[].timestamp

string (date-time) obligatorio

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

topic_series[].topics

array<object> obligatorio

La proporción de cada tema en las publicaciones del clúster ese día, en el orden de topic_changes. Las proporciones suman 1 cuando el clúster publicó ese día.

topic_series[].topics[].topic

string obligatorio

equity, commodity, index, crypto, people (personas y sus cuentas) o events (lugares, temas y eventos).

Valores permitidos

equitycommodityindexcryptopeopleevents

topic_series[].topics[].topic_share

number (double) obligatorio

La proporción del tema en las publicaciones del clúster ese día, de 0 a 1.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "gainers": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "current_share": 0.0687,
      "name": "NVIDIA Corporation",
      "previous_share": 0.0412,
      "share_change_bps": 275,
      "symbol": "NVDA"
    }
  ],
  "hours": 168,
  "losers": [
    {
      "asset_class": "equity",
      "asset_id": "TSLA",
      "current_share": 0.0318,
      "name": "Tesla, Inc.",
      "previous_share": 0.0521,
      "share_change_bps": -203,
      "symbol": "TSLA"
    }
  ],
  "topic_changes": [
    {
      "current_share": 0.52,
      "share_change_bps": 120,
      "topic": "equity"
    },
    {
      "current_share": 0.03,
      "share_change_bps": -15,
      "topic": "commodity"
    },
    {
      "current_share": 0.04,
      "share_change_bps": 10,
      "topic": "index"
    },
    {
      "current_share": 0.14,
      "share_change_bps": -115,
      "topic": "crypto"
    },
    {
      "current_share": 0.11,
      "share_change_bps": 35,
      "topic": "people"
    },
    {
      "current_share": 0.16,
      "share_change_bps": -35,
      "topic": "events"
    }
  ],
  "topic_series": [
    {
      "timestamp": "2026-09-10T00:00:00Z",
      "topics": [
        {
          "topic": "equity",
          "topic_share": 0.5
        },
        {
          "topic": "commodity",
          "topic_share": 0.03
        },
        {
          "topic": "index",
          "topic_share": 0.04
        },
        {
          "topic": "crypto",
          "topic_share": 0.15
        },
        {
          "topic": "people",
          "topic_share": 0.11
        },
        {
          "topic": "events",
          "topic_share": 0.17
        }
      ]
    },
    {
      "timestamp": "2026-09-11T00:00:00Z",
      "topics": [
        {
          "topic": "equity",
          "topic_share": 0.53
        },
        {
          "topic": "commodity",
          "topic_share": 0.03
        },
        {
          "topic": "index",
          "topic_share": 0.04
        },
        {
          "topic": "crypto",
          "topic_share": 0.13
        },
        {
          "topic": "people",
          "topic_share": 0.11
        },
        {
          "topic": "events",
          "topic_share": 0.16
        }
      ]
    }
  ]
}