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 por intervalo temporal

GET /sentiment/timeframes
GetSentimentTimeframes

Sentimiento dividido por el horizonte del que habla la gente: corto plazo (hasta una semana), medio plazo (de semanas a meses) y largo plazo (tres meses o más), cada uno en la escala de /sentiment. Separa a una multitud que es bajista esta semana pero alcista en el año de otra que es bajista en todo momento.

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/sentiment/timeframes. 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/sentiment/timeframes' \
  --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

current
object obligatorio

Última lectura de sentimiento para cada horizonte temporal disponible.

Claves permitidas
short_termmedium_termlong_term
metadata
object opcional

Metadatos de metodología y de la ventana de la solicitud necesarios para interpretar la respuesta.
metadata.as_of
string (date-time) opcional

Hora UTC en la que se calculó la métrica.

metadata.calculation
string opcional

Nombre corto del método de cálculo.

metadata.formula
string opcional

Fórmula legible para humanos del cálculo.

metadata.half_life_hours
number (double) opcional

A pesar del nombre, la longitud de la ventana de decaimiento lineal, en horas: una publicación cuenta por completo cuando es nueva, la mitad en el punto medio y nada una vez que alcanza esta antigüedad.

metadata.lookback_days
integer opcional

Retrospectiva histórica usada por el cálculo, en días.

metadata.scale
string opcional

Escala publicada o interpretación de la métrica.

series
object obligatorio

Serie de sentimiento indexada por horizonte short_term, medium_term y long_term.

Claves permitidas
short_termmedium_termlong_term
series.{key}[].interval_posts
number (double) opcional

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

series.{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.

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.{key}[].total_posts
number (double) opcional

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

{
  "current": {
    "long_term": 52.1,
    "medium_term": 57.8,
    "short_term": 64.2
  },
  "series": {
    "short_term": [
      {
        "sentiment_signal": 64.2,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 318
      }
    ]
  }
}