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

Clústeres de autores

GET /clusters
ListClusters

Actividad y sentimiento de cada clúster de autores en un mercado: publicaciones, autores únicos, variación frente a la ventana anterior y sentimiento neto (publicaciones alcistas menos bajistas) con una serie por hora. asset_class es equity (el valor predeterminado) o crypto.

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

Mercado que se va a agregar: equity (mercados tradicionales, que abarcan acciones, materias primas e índices en conjunto) o crypto.

Valores permitidos
equitycrypto

Default:equity

hours integer QUERY

Ventana de retroceso en horas. Los planes gratuitos llegan hasta 90 días; más allá devuelve 403.

Default:24

Ejemplo de cURL

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

clusters
array<object> obligatorio

Resúmenes de clústeres de autores para la clase de activo seleccionada.
clusters[].activity_change_pct
number (double) opcional

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
number (double) obligatorio

Publicaciones clasificadas como bearish.

clusters[].bullish_posts
number (double) obligatorio

Publicaciones clasificadas como bullish.

clusters[].cluster_id
string obligatorio

Identificador canónico del clúster de autores.

clusters[].neutral_posts
number (double) obligatorio

Publicaciones clasificadas como neutral.

clusters[].previous_total_posts
number (double) obligatorio

Recuento de publicaciones en la ventana inmediatamente anterior de igual longitud.

clusters[].recent_sentiment_signal
number (double) obligatorio

El valor más reciente de la serie de sentimiento por hora: la hora más reciente con publicaciones.

clusters[].series
array<object> obligatorio

Observaciones ordenadas cronológicamente.
clusters[].series[].bearish_posts
number (double) obligatorio

Publicaciones clasificadas como bearish.

clusters[].series[].bullish_posts
number (double) obligatorio

Publicaciones clasificadas como bullish.

clusters[].series[].sentiment_signal
number (double) obligatorio

Publicaciones netas alcistas ponderadas por decaimiento: alcistas menos bajistas. Un valor positivo es alcista, uno negativo es bajista, y la magnitud crece con la actividad.

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

Marca de tiempo UTC en formato RFC 3339 para la observación o el inicio del bucket.

clusters[].series[].total_posts
number (double) obligatorio

Recuento de publicaciones en la ventana de retrospectiva activa de la métrica.

clusters[].total_posts
number (double) obligatorio

Recuento de publicaciones en la ventana de retrospectiva activa de la métrica.

clusters[].window_sentiment_signal
number (double) obligatorio

Señal de sentimiento alcista neto durante toda la ventana solicitada.

hours
integer obligatorio

Ventana de lookback representada por la respuesta, en horas.

{
  "clusters": [
    {
      "activity_change_pct": 18.4,
      "bearish_posts": 438,
      "bullish_posts": 1120,
      "cluster_id": "smart_money",
      "neutral_posts": 284,
      "previous_total_posts": 1556,
      "recent_sentiment_signal": 84.2,
      "series": [
        {
          "bearish_posts": 438,
          "bullish_posts": 1120,
          "sentiment_signal": 128.6,
          "timestamp": "2026-08-07T15:00:00Z",
          "total_posts": 1842
        }
      ],
      "total_posts": 1842,
      "window_sentiment_signal": 63.7
    }
  ],
  "hours": 168
}