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

Distribución de emociones

GET /emotions
GetEmotions

Cuáles de 15 emociones dominan la conversación sobre un activo o sujeto a lo largo del tiempo. proportion es la share de cada emoción dentro de las emociones del bucket (suman 1); post_count cuenta los posts que la muestran. Un post puede mostrar varias.

Reglas de los parámetros:

  • Envía asset_id o subject_id.
  • asset_id debe enviarse junto con asset_class.
  • subject_id no puede combinarse con asset_id ni con asset_class.

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

Clase del activo nombrado por asset_id: equity (acciones y ETF), commodity, index o crypto. Envía el asset_class que /assets o /search devolvió junto con el asset_id.

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:720

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

Ejemplo de cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/emotions' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --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

metadata
object opcional

Metadatos de metodología y de la ventana de la solicitud necesarios para interpretar la respuesta.
metadata.empty_bucket_policy
string obligatorio

Cómo deben interpretar los clientes los buckets omitidos o emitidos sin datos.

metadata.empty_buckets
integer obligatorio

Número de buckets sin datos que cumplan los criterios.

metadata.granularity
string obligatorio

Tamaño del bucket temporal usado por la serie devuelta.

metadata.hours
integer obligatorio

Ventana de lookback representada por la respuesta, en horas.

metadata.latest_empty_bucket
string (date-time) opcional

Bucket UTC más reciente sin datos que cumplan los criterios.

series
object obligatorio

Observaciones de emociones indexadas por la etiqueta de emoción detectada.

Claves permitidas
angeranticipationboredomconfidencedisgustdistrustfeargreedjoyloveoptimismpessimismsadnesssurprisetrust
series.{key}[].post_count
integer (int64) obligatorio

Número bruto de posts que llevan esta emoción en el bucket.

series.{key}[].proportion
number (double) obligatorio

Share de esta emoción sobre todas las etiquetas de emoción del bucket, de 0 a 1.

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

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

{
  "series": {
    "optimism": [
      {
        "post_count": 286,
        "proportion": 0.37,
        "timestamp": "2026-08-07T15:00:00Z"
      }
    ]
  }
}