Toda la documentación Documentación de Nebula Todos los endpoints Documentación interactiva Markdown JSON de OpenAPI

API REST
Inteligencia

Atención de los insights

GET /insights/attention

GetInsightAttention

La conversación en torno a un elemento de inteligencia: la ventana de atención de 24 horas, los recuentos de autores y de sentimiento, los buckets por hora, la mezcla de clústeres, los vectores de impacto y las reacciones de precio de cada entidad vinculada con precio. Úsalo después de /insights cuando un lector abre un elemento y necesita todo el contexto del panel de detalle.

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

insight_id integer QUERY obligatorio

Identificador estable del elemento de inteligencia devuelto por /insights. Los planes gratuitos llegan hasta 90 días atrás; más allá devuelve 403.

Example:1

Ejemplo de cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/insights/attention' \
  --data-urlencode 'insight_id=1' \
  --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

attention

object obligatorio

Lectura de conversación e impacto para el elemento de inteligencia solicitado.

attention.anchor_subject_id

string obligatorio

Id del sujeto usado para anclar el escaneo de atención.

attention.authors

integer (int64) obligatorio

Autores distintos representados por las publicaciones coincidentes.

attention.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).

attention.bearish_posts

integer (int64) obligatorio

Publicaciones clasificadas como bearish.

attention.bucket_hours

integer obligatorio

Ancho de cada bucket en horas.

attention.buckets

array<object> obligatorio

Buckets de atención en orden cronológico.

attention.buckets[].authors

integer (int64) obligatorio

Autores distintos representados por las publicaciones coincidentes.

attention.buckets[].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).

attention.buckets[].bearish_posts

integer (int64) obligatorio

Publicaciones clasificadas como bearish.

attention.buckets[].bullish_posts

integer (int64) obligatorio

Publicaciones clasificadas como bullish.

attention.buckets[].neutral_posts

integer (int64) obligatorio

Publicaciones clasificadas como neutral.

attention.buckets[].posts

integer (int64) obligatorio

Recuento de publicaciones coincidentes en la ventana solicitada.

attention.buckets[].timestamp

string (date-time) obligatorio

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

attention.bullish_posts

integer (int64) obligatorio

Publicaciones clasificadas como bullish.

attention.cluster_mix

array<object> obligatorio

Mezcla de clústeres de autores de las publicaciones coincidentes, ordenada por autores.

attention.cluster_mix[].authors

integer (int64) obligatorio

Autores distintos representados por las publicaciones coincidentes.

attention.cluster_mix[].cluster_id

string obligatorio

Identificador canónico del clúster de autores.

attention.cluster_mix[].posts

integer (int64) opcional

Recuento de publicaciones coincidentes en la ventana solicitada.

attention.cluster_mix[].share

number (double) obligatorio

Cuota de atención social elegible como fracción decimal de 0 a 1.

attention.clusters

integer (int64) obligatorio

Clústeres de autores distintos representados por las publicaciones coincidentes.

attention.from

string (date-time) obligatorio

Inicio inclusivo en UTC de la ventana medida.

attention.impact

object opcional

Evaluación de impacto estructurada para el elemento de inteligencia.

attention.impact.max_score

integer obligatorio

Puntuación máxima posible para cada vector de impacto.

attention.impact.sentiment_score

integer obligatorio

Puntuación de sentimiento con signo; positivo es alcista y negativo es bajista.

attention.impact.vectors

array<object> obligatorio

Vectores de impacto que sustentan la evaluación de impacto a nivel de elemento.

attention.impact.vectors[].key

string obligatorio

Clave estable legible por máquina para este vector de impacto.

attention.impact.vectors[].label

string obligatorio

Etiqueta legible del bucket o del índice.

attention.impact.vectors[].score

integer obligatorio

Puntuación de este vector de impacto.

attention.last_post_at

string (date-time) opcional

Hora UTC de la publicación coincidente más reciente en la ventana solicitada.

attention.neutral_posts

integer (int64) obligatorio

Publicaciones clasificadas como neutral.

attention.optional_subjects

array<string> obligatorio

Ids de sujeto que las publicaciones coincidentes debían mencionar al menos uno; vacío significa que no se exigía ningún lado opcional.

attention.posts

integer (int64) obligatorio

Recuento de publicaciones coincidentes en la ventana solicitada.

attention.required_subjects

array<string> obligatorio

Ids de sujeto que todas las publicaciones coincidentes debían mencionar.

attention.subjects_used

array<string> obligatorio

Ids de sujeto realmente usados para la ventana de atención devuelta tras cualquier mecanismo de reserva.

attention.to

string (date-time) obligatorio

Fin exclusivo en UTC de la ventana medida.

attention.window_kind

string obligatorio

Ubicación de la ventana en torno al insight: antes o alrededor.

insight_id

integer (int64) obligatorio

Identificador estable del elemento de inteligencia.

price_reactions

array<object> obligatorio

Reacciones de precio de las entidades con precio vinculadas al elemento de inteligencia.

price_reactions[].insight_at

string (date-time) obligatorio

Hora UTC usada como línea base para la reacción de precio.

price_reactions[].insight_id

integer (int64) obligatorio

Identificador estable del elemento de inteligencia.

price_reactions[].live_pct

number (double) opcional

Última variación de precio frente a la línea base del insight; presente para insights recientes.

price_reactions[].moves

array<object> obligatorio

Movimientos de precio a horizontes fijos una vez transcurrido cada horizonte.

price_reactions[].moves[].change_pct

number (double) obligatorio

Variación de precio en puntos porcentuales frente a la línea base en el momento del insight.

price_reactions[].moves[].hours

integer obligatorio

Ventana de lookback representada por la respuesta, en horas.

price_reactions[].series

array<object> obligatorio

Observaciones ordenadas cronológicamente.

price_reactions[].series[].change_pct

number (double) obligatorio

Variación de precio en puntos porcentuales frente a la línea base en el momento del insight.

price_reactions[].series[].timestamp

string (date-time) obligatorio

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

price_reactions[].subject_id

string obligatorio

Identificador canónico de una persona, cuenta o tema que no es un activo.

{
  "attention": {
    "anchor_subject_id": "eq:NVDA",
    "authors": 241,
    "average_sentiment_score": 38.5,
    "bearish_posts": 438,
    "bucket_hours": 1,
    "buckets": [
      {
        "authors": 241,
        "average_sentiment_score": 38.5,
        "bearish_posts": 438,
        "bullish_posts": 1120,
        "neutral_posts": 284,
        "posts": 684,
        "timestamp": "2026-08-07T15:00:00Z"
      }
    ],
    "bullish_posts": 1120,
    "cluster_mix": [
      {
        "authors": 241,
        "cluster_id": "smart_money",
        "posts": 684,
        "share": 0.148
      }
    ],
    "clusters": 4,
    "from": "2026-08-15T09:00:00Z",
    "last_post_at": "2026-08-22T08:45:00Z",
    "neutral_posts": 284,
    "optional_subjects": [
      "string"
    ],
    "posts": 684,
    "required_subjects": [
      "string"
    ],
    "subjects_used": [
      "string"
    ],
    "to": "2026-08-22T09:00:00Z",
    "window_kind": "around"
  },
  "insight_id": 38421,
  "price_reactions": [
    {
      "insight_at": "2026-08-20T20:00:00Z",
      "insight_id": 38421,
      "live_pct": 1.8,
      "moves": [
        {
          "change_pct": 2.4,
          "hours": 168
        }
      ],
      "series": [
        {
          "change_pct": 2.4,
          "timestamp": "2026-08-07T15:00:00Z"
        }
      ],
      "subject_id": "text:artificial intelligence"
    }
  ]
}