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

Inteligencia

GET /insights
ListInsights

Historias breves sobre lo que ocurre en los mercados, a nivel global o sobre un activo o sujeto concreto, cada una con un titular, un resumen, sentimiento (−1, 0 o +1), etiquetas, importancia de 1 a 3 y las entidades implicadas. Las actualizadas más recientemente primero; envía order_by=start_time_desc para ver primero los eventos más recientes.

Reglas de los parámetros:

  • Envía asset_class y asset_id juntos, o ninguno de los dos.
  • 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/insights. 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

limit integer QUERY

Número máximo de resultados devueltos.

Default:10

offset integer QUERY

Número de resultados omitidos.

Default:0

start_time_after string (date-time) QUERY

Solo elementos que empiezan después de esta hora RFC3339. Los planes gratuitos llegan hasta 90 días atrás; más atrás devuelve 403.

Example:2026-08-01T00:00:00Z

start_time_before string (date-time) QUERY

Solo elementos que empiezan antes de esta hora RFC3339. Los planes gratuitos llegan hasta 90 días atrás; más atrás devuelve 403.

Example:2026-08-07T00:00:00Z

tags array<string> QUERY

Conserva las historias que lleven alguna de estas etiquetas, con coincidencia exacta (por ejemplo, earnings). Las etiquetas son libres; léelas de las historias devueltas. Envía varias separadas por comas.

Example:earnings

exclude_tags array<string> QUERY

Omite las historias que lleven alguna de estas etiquetas. Solo coincide con etiquetas, no con categorías ni dominios: para omitir historias de cripto, filtra por dominios. Envía varias separadas por comas.

Example:rumour

categories array<string> QUERY

Conserva las historias cuya categoría principal sea una de estas, con coincidencia exacta (por ejemplo, equities o technology). Las categorías son libres; léelas de las historias devueltas. Envía varias separadas por comas.

Example:equities

domains array<string> QUERY

Conserva las historias que estén en cualquiera de estos dominios. Envía varios separados por comas.

Example:equities,macro

order_by string QUERY

Orden de los resultados. Por defecto, updated_at_desc.

Valores permitidos
start_time_ascstart_time_descupdated_at_ascupdated_at_desccreated_at_asccreated_at_descimportance_score_ascimportance_score_desc

Default:updated_at_desc

Ejemplo de cURL

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

insights
array<object> obligatorio

Elementos de inteligencia seleccionados que coinciden con los filtros indicados.
insights[].category
string opcional

Categoría principal de inteligencia cuando se asigna.

insights[].domains
array<string> obligatorio

Dominios de mercado o de sujeto asociados al registro.

insights[].entities
array<object> obligatorio

Activos y sujetos que no son activos vinculados a este registro.
insights[].entities[].asset_class
string opcional

La clase del activo, enviada junto con asset_id.

Valores permitidos
equitycommodityindexcrypto
insights[].entities[].asset_id
string opcional

Para una acción, materia prima, índice o moneda, el asset_id que aceptan los endpoints de activos; ausente para personas, cuentas y temas, y para el raro activo que Nebula no puede ubicar.

insights[].entities[].entity_id
string obligatorio

El id de Nebula para la entidad vinculada, como eq:NVDA, gecko:1 o text:ai. Para consultar la entidad, usa asset_id y asset_class, o subject_id, del mismo objeto.

insights[].entities[].entity_types
array<string> obligatorio

Clasificaciones del grafo de conocimiento para la entidad vinculada.

insights[].entities[].is_direct
boolean obligatorio

Verdadero cuando el registro se refiere directamente a esta entidad vinculada.

insights[].entities[].is_primary
boolean obligatorio

Verdadero cuando esta es la entidad vinculada principal del registro.

insights[].entities[].name
string obligatorio

Nombre legible para personas.

insights[].entities[].role
string obligatorio

Relación de la entidad vinculada con el elemento de inteligencia.

insights[].entities[].subject_id
string opcional

Para una persona, cuenta o tema, el subject_id que aceptan los endpoints que reconocen sujetos; ausente para los activos.

insights[].headline
string obligatorio

Titular conciso de inteligencia.

insights[].importance_score
integer obligatorio

Importancia de 1 (baja) a 3 (alta).

insights[].insight_id
integer (int64) obligatorio

Identificador estable del elemento de inteligencia.

insights[].sentiment_score
integer obligatorio

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

insights[].start_time
string (date-time) opcional

Hora UTC en la que empieza el elemento de inteligencia o el evento.

insights[].summary
string obligatorio

Resumen del elemento de inteligencia basado en evidencia.

insights[].tags
array<string> obligatorio

Etiquetas de búsqueda asociadas al registro.

insights[].updated_at
string (date-time) opcional

Hora UTC de la última actualización del registro.

{
  "insights": [
    {
      "category": "earnings",
      "domains": [
        "equities",
        "technology"
      ],
      "entities": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "entity_id": "eq:NVDA",
          "entity_types": [
            "equity"
          ],
          "is_direct": true,
          "is_primary": true,
          "name": "NVIDIA Corporation",
          "role": "primary",
          "subject_id": "text:jensen huang"
        }
      ],
      "headline": "NVIDIA raises its quarterly revenue outlook",
      "importance_score": 3,
      "insight_id": 38421,
      "sentiment_score": 1,
      "start_time": "2026-08-20T20:00:00Z",
      "summary": "Management raised guidance after stronger-than-expected data-centre demand.",
      "tags": [
        "earnings",
        "data_centres"
      ],
      "updated_at": "2026-08-07T14:35:00Z"
    }
  ]
}