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

Eventos del calendario

GET /calendar-events
ListCalendarEvents

Eventos de mercado próximos y pasados (resultados, publicaciones económicas, OPV, cotizaciones, votaciones, audiencias), a nivel global o para un activo o tema concreto, con tipo, estado, importancia de 1 a 3 y las entidades implicadas. Por defecto, desde hoy en adelante, los más próximos primero; envía min_importance_score=2 para los destacados.

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/calendar-events. 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:50

offset integer QUERY

Número de resultados omitidos.

Default:0

start_time_after string (date-time) QUERY

Solo eventos que comiencen después de esta hora RFC3339. Los planes gratuitos abarcan hasta 90 días atrás; más allá devuelve 403.

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

start_time_before string (date-time) QUERY

Solo eventos que comiencen antes de esta hora RFC3339. Los planes gratuitos abarcan hasta 90 días atrás; más allá devuelve 403.

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

domains array<string> QUERY

Conserva los eventos de cualquiera de estos dominios. Envía varios separados por comas.

Example:equities,macro

event_types array<string> QUERY

Conserva los eventos de cualquiera de estos tipos. Envía varios separados por comas.

Example:earnings,economic_release

statuses array<string> QUERY

Conserva los eventos con cualquiera de estos estados. Envía varios separados por comas.

Example:scheduled,postponed

min_importance_score integer QUERY

Importancia mínima de 1 (baja) a 3 (alta). Por defecto 1, que incluye todos los eventos.

Default:1

Ejemplo de cURL

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

calendar_events
array<object> obligatorio

Eventos de calendario que coinciden con los filtros proporcionados.
calendar_events[].calendar_event_id
string obligatorio

Identificador público estable del evento de calendario.

calendar_events[].confidence_score
integer obligatorio

Confianza en el evento, de 1 (baja) a 10 (alta).

calendar_events[].created_at
string (date-time) obligatorio

Hora UTC de creación del registro.

calendar_events[].domains
array<string> obligatorio

Dominios de mercado o de sujeto asociados al registro.

calendar_events[].end_time
string (date-time) opcional

Hora UTC de finalización del evento cuando se conoce.

calendar_events[].entities
array<object> obligatorio

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

La clase del activo, enviada junto con asset_id.

Valores permitidos
equitycommodityindexcrypto
calendar_events[].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.

calendar_events[].entities[].confidence
number (float) opcional

Confianza del vínculo de entidad cuando está disponible.

calendar_events[].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.

calendar_events[].entities[].is_primary
boolean obligatorio

Verdadero cuando esta es la entidad vinculada principal del registro.

calendar_events[].entities[].name
string obligatorio

Nombre legible para personas.

calendar_events[].entities[].role
string obligatorio

Relación de la entidad vinculada con el evento de calendario.

calendar_events[].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.

calendar_events[].event_metadata
object opcional

Metadatos estructurados específicos del tipo de evento. Las claves varían según el tipo de evento.

calendar_events[].event_subtype
string opcional

Clasificación del evento más específica cuando está disponible.

calendar_events[].event_type
string obligatorio

Clasificación de alto nivel del evento.

calendar_events[].importance_score
integer obligatorio

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

calendar_events[].location
string opcional

Lugar donde se celebra físicamente el evento, cuando se conoce. Ausente para eventos en línea y on-chain.

calendar_events[].long_term_impact_score
integer obligatorio

Impacto estimado en el mercado a largo plazo, de 1 (bajo) a 3 (alto).

calendar_events[].macro_impact_score
integer obligatorio

Impacto macroeconómico estimado, de 1 (bajo) a 3 (alto).

calendar_events[].price_impact_score
integer obligatorio

Impacto estimado directo en el precio, de 1 (bajo) a 3 (alto).

calendar_events[].short_term_impact_score
integer obligatorio

Impacto estimado en el mercado a corto plazo, de 1 (bajo) a 3 (alto).

calendar_events[].source_count
integer obligatorio

Número de fuentes que respaldan el evento.

calendar_events[].sources
array<object> obligatorio

Registros de fuentes que respaldan la respuesta principal.
calendar_events[].sources[].external_id
string obligatorio

Identificador asignado por la fuente externa.

calendar_events[].sources[].provider
string opcional

Proveedor de datos de origen cuando está disponible.

calendar_events[].sources[].published_at
string (date-time) obligatorio

Hora UTC de publicación.

calendar_events[].sources[].publisher
string opcional

Editor original cuando está disponible.

calendar_events[].sources[].source
string obligatorio

Plataforma o feed de origen.

calendar_events[].sources[].subtype
string obligatorio

Subtipo de fuente.

calendar_events[].sources[].trusted
boolean obligatorio

Indica si la fuente está clasificada como de confianza.

calendar_events[].sources[].url
string opcional

URL pública de la fuente cuando está disponible.

calendar_events[].start_time
string (date-time) obligatorio

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

calendar_events[].status
string obligatorio

Estado actual del ciclo de vida del evento: scheduled, tentative, cancelled o postponed.

calendar_events[].summary
string opcional

Resumen del elemento de inteligencia basado en evidencia.

calendar_events[].tags
array<string> obligatorio

Etiquetas de búsqueda asociadas al registro.

calendar_events[].tail_risk_impact_score
integer obligatorio

Impacto estimado en el riesgo de cola, de 1 (bajo) a 3 (alto).

calendar_events[].time_precision
string obligatorio

Precisión de la hora del evento publicada: minuto, hora, día, semana, mes, año o desconocida. Un evento con precisión de día comienza a las 00:00 UTC de ese día.

calendar_events[].title
string obligatorio

Título del evento legible para personas.

calendar_events[].trusted_source_count
integer obligatorio

Número de fuentes de apoyo marcadas como fiables.

calendar_events[].updated_at
string (date-time) obligatorio

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

{
  "calendar_events": [
    {
      "calendar_event_id": "earnings:nvda:2026-q3",
      "confidence_score": 9,
      "created_at": "2026-08-06T10:00:00Z",
      "domains": [
        "equities",
        "technology"
      ],
      "end_time": "2026-08-20T21:00:00Z",
      "entities": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "confidence": 0.98,
          "entity_id": "eq:NVDA",
          "is_primary": true,
          "name": "NVIDIA Corporation",
          "role": "affected",
          "subject_id": "text:jensen huang"
        }
      ],
      "event_metadata": {
        "fiscal_quarter": "Q3",
        "fiscal_year": 2026
      },
      "event_subtype": "quarterly_results",
      "event_type": "earnings",
      "importance_score": 3,
      "location": "Santa Clara, California",
      "long_term_impact_score": 2,
      "macro_impact_score": 1,
      "price_impact_score": 3,
      "short_term_impact_score": 3,
      "source_count": 4,
      "sources": [
        {
          "external_id": "0001045810-26-000123",
          "provider": "SEC EDGAR",
          "published_at": "2026-08-07T14:30:00Z",
          "publisher": "NVIDIA Corporation",
          "source": "sec",
          "subtype": "filing",
          "trusted": true,
          "url": "https://www.sec.gov/Archives/edgar/data/1045810/example.htm"
        }
      ],
      "start_time": "2026-08-20T20:00:00Z",
      "status": "scheduled",
      "summary": "Management raised guidance after stronger-than-expected data-centre demand.",
      "tags": [
        "earnings",
        "data_centres"
      ],
      "tail_risk_impact_score": 1,
      "time_precision": "exact",
      "title": "NVIDIA Q3 2026 earnings",
      "trusted_source_count": 3,
      "updated_at": "2026-08-07T14:35:00Z"
    }
  ]
}