Tutta la documentazione Documentazione di Nebula Tutti gli endpoint Documentazione interattiva Markdown JSON OpenAPI

API REST
Intelligence

Eventi del calendario

GET /calendar-events

ListCalendarEvents

Eventi di mercato futuri e passati (utili, dati economici, IPO, quotazioni, votazioni, udienze), a livello globale o per un singolo asset o soggetto, con tipo, stato, importanza da 1 a 3 e le entità coinvolte. Per impostazione predefinita parte da oggi in avanti, dal più vicino; invia min_importance_score=2 per quelli rilevanti.

Regole dei parametri:

Invia asset_class e asset_id insieme, oppure nessuno dei due.
subject_id non può essere combinato con asset_id o asset_class.

Pagamento con wallet disponibile su https://nebula-api.hiddensystems.ai/api/v1/x402/calendar-events. Non sono richiesti un account Nebula o una chiave API; controlla l'offerta di pagamento prima di firmare. Guida al pagamento x402.

Parametri

asset_id string QUERY

Asset ID da /assets o /search, ad esempio NVDA, GLD, SPX o bitcoin. Va inviato con l'asset_class restituito insieme ad esso.

Example:NVDA

asset_class string QUERY

Classe dell'asset indicato da asset_id: equity (azioni ed ETF), commodity, index o crypto. Va inviata l'asset_class restituita da /assets o /search insieme all'asset_id.

Valori consentiti

equitycommodityindexcrypto

Example:equity

subject_id string QUERY

Identificatore canonico non relativo a un asset restituito da /subjects o /search, ad esempio text:jensen huang o handle:elonmusk. Accettato in qualsiasi combinazione di maiuscole e minuscole. Non può essere combinato con asset_id o asset_class.

Example:text:jensen huang

limit integer QUERY

Numero massimo di risultati restituiti.

Default:50

offset integer QUERY

Numero di risultati saltati.

Default:0

start_time_after string (date-time) QUERY

Solo gli eventi che iniziano dopo questa ora RFC3339. I piani gratuiti risalgono fino a 90 giorni; oltre restituisce 403.

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

start_time_before string (date-time) QUERY

Solo gli eventi che iniziano prima di questa ora RFC3339. I piani gratuiti risalgono fino a 90 giorni; oltre restituisce 403.

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

domains array<string> QUERY

Mantieni gli eventi in uno qualsiasi di questi domini. Inviane diversi separati da virgola.

Example:equities,macro

event_types array<string> QUERY

Mantieni gli eventi di uno qualsiasi di questi tipi. Inviane diversi separati da virgola.

Example:earnings,economic_release

statuses array<string> QUERY

Mantieni gli eventi in uno qualsiasi di questi stati. Inviane diversi separati da virgola.

Example:scheduled,postponed

min_importance_score integer QUERY

Importanza minima da 1 (bassa) a 3 (alta). Il valore predefinito è 1, che include ogni evento.

Default:1

Esempio cURL

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/calendar-events' \
  --header 'X-API-Key: YOUR_API_KEY'

Risposte

200 OK

400 Richiesta non valida

401 Non autorizzato

402 Crediti esauriti; la risposta include i tempi di rinnovo e il saldo dei crediti acquistati

403 Vietato

404 Non trovato

405 Metodo non consentito; l'header Allow elenca il metodo supportato

429 Troppe richieste

500 Errore interno del server

503 Servizio non disponibile

Tipo di media application/json

calendar_events

array<object> obbligatorio

Eventi di calendario corrispondenti ai filtri forniti.

calendar_events[].calendar_event_id

string obbligatorio

Identificatore pubblico stabile per l'evento di calendario.

calendar_events[].confidence_score

integer obbligatorio

Confidenza nell'evento, da 1 (bassa) a 10 (alta).

calendar_events[].created_at

string (date-time) obbligatorio

Ora UTC di creazione del record.

calendar_events[].domains

array<string> obbligatorio

Domini di mercato o di argomento associati al record.

calendar_events[].end_time

string (date-time) opzionale

Ora UTC di fine evento, quando nota.

calendar_events[].entities

array<object> obbligatorio

Asset e soggetti non-asset collegati a questo record.

calendar_events[].entities[].asset_class

string opzionale

La classe dell'asset, inviata con asset_id.

Valori consentiti

equitycommodityindexcrypto

calendar_events[].entities[].asset_id

string opzionale

Per un'azione, una materia prima, un indice o una coin, l'asset_id accettato dagli endpoint degli asset; assente per persone, account e argomenti, e per i rari asset che Nebula non riesce a collocare.

calendar_events[].entities[].confidence

number (float) opzionale

Confidenza del collegamento all'entità, quando disponibile.

calendar_events[].entities[].entity_id

string obbligatorio

L'id di Nebula per l'entità collegata, ad esempio eq:NVDA, gecko:1 o text:ai. Per interrogare l'entità, usa asset_id e asset_class, oppure subject_id, dallo stesso oggetto.

calendar_events[].entities[].is_primary

boolean obbligatorio

True quando questa è l'entità collegata principale del record.

calendar_events[].entities[].name

string obbligatorio

Nome leggibile.

calendar_events[].entities[].role

string obbligatorio

Relazione dell'entità collegata con l'evento di calendario.

calendar_events[].entities[].subject_id

string opzionale

Per una persona, un account o un argomento, il subject_id accettato dagli endpoint che gestiscono i soggetti; assente per gli asset.

calendar_events[].event_metadata

object opzionale

Metadati strutturati specifici del tipo di evento. Le chiavi variano in base al tipo di evento.

calendar_events[].event_subtype

string opzionale

Classificazione dell'evento più specifica, quando disponibile.

calendar_events[].event_type

string obbligatorio

Classificazione di alto livello dell'evento.

calendar_events[].importance_score

integer obbligatorio

Importanza da 1 (bassa) a 3 (alta).

calendar_events[].location

string opzionale

Luogo fisico in cui si svolge l'evento, quando è noto. Assente per gli eventi online e on-chain.

calendar_events[].long_term_impact_score

integer obbligatorio

Impatto stimato sul mercato a lungo termine, da 1 (basso) a 3 (alto).

calendar_events[].macro_impact_score

integer obbligatorio

Impatto macroeconomico stimato, da 1 (basso) a 3 (alto).

calendar_events[].price_impact_score

integer obbligatorio

Impatto stimato diretto sul prezzo, da 1 (basso) a 3 (alto).

calendar_events[].short_term_impact_score

integer obbligatorio

Impatto stimato sul mercato a breve termine, da 1 (basso) a 3 (alto).

calendar_events[].source_count

integer obbligatorio

Numero di fonti che supportano l'evento.

calendar_events[].sources

array<object> obbligatorio

Record delle fonti che supportano la risposta principale.

calendar_events[].sources[].external_id

string obbligatorio

Identificatore assegnato dalla fonte esterna.

calendar_events[].sources[].provider

string opzionale

Provider di dati upstream, quando disponibile.

calendar_events[].sources[].published_at

string (date-time) obbligatorio

Ora UTC di pubblicazione.

calendar_events[].sources[].publisher

string opzionale

Editore originale, quando disponibile.

calendar_events[].sources[].source

string obbligatorio

Piattaforma o feed di origine.

calendar_events[].sources[].subtype

string obbligatorio

Sottotipo della fonte.

calendar_events[].sources[].trusted

boolean obbligatorio

Indica se la fonte è classificata come attendibile.

calendar_events[].sources[].url

string opzionale

URL pubblico della fonte, quando disponibile.

calendar_events[].start_time

string (date-time) obbligatorio

Orario UTC in cui inizia l'elemento di intelligence o l'evento.

calendar_events[].status

string obbligatorio

Stato attuale del ciclo di vita dell'evento: scheduled, tentative, cancelled o postponed.

calendar_events[].summary

string opzionale

Riepilogo dell'elemento di intelligence basato sulle evidenze.

calendar_events[].tags

array<string> obbligatorio

Etichette ricercabili associate al record.

calendar_events[].tail_risk_impact_score

integer obbligatorio

Impatto stimato sul rischio di coda, da 1 (basso) a 3 (alto).

calendar_events[].time_precision

string obbligatorio

Precisione dell'orario dell'evento pubblicato: minuto, ora, giorno, settimana, mese, anno o sconosciuta. Un evento con precisione giornaliera inizia alle 00:00 UTC di quel giorno.

calendar_events[].title

string obbligatorio

Titolo dell'evento leggibile.

calendar_events[].trusted_source_count

integer obbligatorio

Numero di fonti di supporto contrassegnate come attendibili.

calendar_events[].updated_at

string (date-time) obbligatorio

Ora UTC dell'ultimo aggiornamento del record.

{
  "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"
    }
  ]
}