Toda la documentación Documentación de Nebula Todos los endpoints Documentación interactiva Markdown JSON de OpenAPI
  1. API REST
  2. Social & Sentimiento

Impulso social

GET /social-momentum
GetSocialMomentum

Publicaciones, autores únicos y sentimiento dentro de cada clúster de autores, en paralelo, para un activo, un asunto o un mercado completo: qué grupos impulsan la conversación y en qué se diferencia su tono. Los clústeres se solapan, así que no los sumes. Envía clusters para devolver solo los que nombres.

Reglas de los parámetros:

  • asset_id debe enviarse junto con asset_class.
  • subject_id no puede combinarse con asset_id ni con asset_class.
  • Sin asset_id, asset_class debe ser equity o crypto; commodity y index necesitan un asset_id.

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

ID del activo de /assets o /search, como NVDA, GLD, SPX o bitcoin. Envíalo junto con el asset_class que se devolvió con él.

Example:NVDA

asset_class string QUERY

Con asset_id, la clase del activo. Sin él, el mercado que se va a agregar: equity (acciones, materias primas e índices; el valor predeterminado) o crypto.

Valores permitidos
equitycommodityindexcrypto

Example:equity

subject_id string QUERY

Identificador canónico que no corresponde a un activo y que devuelven /subjects o /search, como text:jensen huang o handle:elonmusk. Se acepta en cualquier combinación de mayúsculas y minúsculas. No puede combinarse con asset_id ni con asset_class.

Example:text:jensen huang

hours integer QUERY

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

Default:168

granularity string QUERY

Tamaño de bucket de serie temporal solicitado. Si se omite, el servicio elige un tamaño de bucket adecuado para la ventana de lookback.

Valores permitidos
1h2h4h12h1d

Example:1h

clusters array<string> QUERY

Solo estos clústeres, cada uno como su propia serie; omítelo para todos. Usa los ids del parámetro clusters de /sentiment, excepto las comunidades de publicación.

Example:smart_money

Ejemplo de cURL

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

Serie de momentum social indexada por identificador canónico de clúster de autores.
clusters.{key}[].average_sentiment_score
number (double) obligatorio

Media aritmética de las puntuaciones de sentimiento de las publicaciones, en la escala de −100 (muy bajista) a +100 (muy alcista).

clusters.{key}[].bearish_posts
integer (int64) obligatorio

Publicaciones clasificadas como bearish.

clusters.{key}[].bullish_posts
integer (int64) obligatorio

Publicaciones clasificadas como bullish.

clusters.{key}[].neutral_posts
integer (int64) obligatorio

Publicaciones clasificadas como neutral.

clusters.{key}[].timestamp
string (date-time) obligatorio

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

clusters.{key}[].total_posts
integer (int64) obligatorio

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

clusters.{key}[].unique_posters
integer (int64) obligatorio

Cuentas de publicación distintas en el intervalo; con una granularidad más gruesa que la horaria, es un límite superior sumado a partir de recuentos horarios.

{
  "clusters": {
    "smart_money": [
      {
        "average_sentiment_score": 38.5,
        "bearish_posts": 41,
        "bullish_posts": 112,
        "neutral_posts": 31,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 184,
        "unique_posters": 73
      }
    ]
  }
}