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

Sentimiento

GET /sentiment
GetSentiment

Cuán alcista o bajista es la conversación sobre un activo, un sujeto o todo un mercado, a lo largo del tiempo. sentiment_signal es publicaciones alcistas menos bajistas durante las últimas 24 horas, con más peso para las publicaciones recientes: un valor positivo indica un sesgo alcista neto. Crece con el volumen, así que compara un activo con su propio historial.

cohorts ofrece la misma medida para bots y, para un activo o sujeto, para los top callers. Envía clusters para leer uno o varios grupos de autores, u omite el activo y el sujeto para obtener una vista de todo el mercado.

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

Clusters de autores que se van a leer; repite para combinarlos, por ejemplo clusters=kols&clusters=media. Los clusters seleccionados se suman, y un autor puede pertenecer a varios.

  • Callers: smart_money (los de mejor rendimiento), dumb_money (los de peor rendimiento), top_degens (los mejores en cripto de pequeña capitalización)
  • Timing: early_movers (los primeros en hablar de un activo cuando la atención aumenta), late_movers (llegan al pico o después)
  • Builders: developers, founders, team_leaders, project_accounts
  • Instituciones: vcs, asset_managers, dao_guild_funds, incubators, exchanges
  • Influencia: kols, celebrities, media, marketer, shiller
  • Analistas: ta_analyst, fa_analyst, macro_analyst, onchain_analyst, investigators
  • Traders: position_trader, swing_trader, day_trader
  • Sesgo: perma_bull, doomer, tribalist
  • Otros: political, nft, bots, automated_ai
  • Comunidades, según dónde se hizo la publicación: wallstreetbets, reddit

Example:smart_money

Ejemplo de cURL

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

cohorts
object obligatorio

La misma medida para otros grupos de autores: bots y top_callers cuando esa población está disponible. La población que no son bots es la propia serie.

Claves permitidas
botstop_callers
cohorts.{key}[].bearish_posts
number (double) obligatorio

Publicaciones bajistas durante las últimas 24 horas hasta este punto; interval_bearish_posts corresponde al bucket.

cohorts.{key}[].bullish_posts
number (double) obligatorio

Publicaciones alcistas durante las últimas 24 horas hasta este punto; interval_bullish_posts corresponde al bucket.

cohorts.{key}[].interval_bearish_posts
number (double) opcional

Publicaciones bajistas en este bucket de tiempo emitido.

cohorts.{key}[].interval_bullish_posts
number (double) opcional

Publicaciones alcistas en este bucket de tiempo emitido.

cohorts.{key}[].interval_neutral_posts
number (double) opcional

Publicaciones neutrales en este bucket de tiempo emitido.

cohorts.{key}[].interval_posts
number (double) opcional

Publicaciones en este bucket de tiempo emitido, antes de la acumulación del lookback.

cohorts.{key}[].neutral_posts
number (double) obligatorio

Publicaciones neutrales durante las últimas 24 horas hasta este punto; interval_neutral_posts corresponde al bucket.

cohorts.{key}[].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.

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

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

cohorts.{key}[].total_posts
number (double) obligatorio

Publicaciones durante las últimas 24 horas hasta este punto, no solo en este bucket; interval_posts corresponde al bucket.

series
array<object> obligatorio

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

Publicaciones bajistas durante las últimas 24 horas hasta este punto; interval_bearish_posts corresponde al bucket.

series[].bullish_posts
number (double) obligatorio

Publicaciones alcistas durante las últimas 24 horas hasta este punto; interval_bullish_posts corresponde al bucket.

series[].interval_bearish_posts
number (double) opcional

Publicaciones bajistas en este bucket de tiempo emitido.

series[].interval_bullish_posts
number (double) opcional

Publicaciones alcistas en este bucket de tiempo emitido.

series[].interval_neutral_posts
number (double) opcional

Publicaciones neutrales en este bucket de tiempo emitido.

series[].interval_posts
number (double) opcional

Publicaciones en este bucket de tiempo emitido, antes de la acumulación del lookback.

series[].neutral_posts
number (double) obligatorio

Publicaciones neutrales durante las últimas 24 horas hasta este punto; interval_neutral_posts corresponde al bucket.

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.

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

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

series[].total_posts
number (double) obligatorio

Publicaciones durante las últimas 24 horas hasta este punto, no solo en este bucket; interval_posts corresponde al bucket.

{
  "cohorts": {
    "bots": [
      {
        "bearish_posts": 438,
        "bullish_posts": 1120,
        "neutral_posts": 284,
        "sentiment_signal": 128.6,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 1842
      }
    ]
  },
  "series": [
    {
      "bearish_posts": 438,
      "bullish_posts": 1120,
      "interval_bearish_posts": 18,
      "interval_bullish_posts": 46,
      "interval_neutral_posts": 10,
      "interval_posts": 74,
      "neutral_posts": 284,
      "sentiment_signal": 128.6,
      "timestamp": "2026-08-07T15:00:00Z",
      "total_posts": 1842
    }
  ]
}