Tutta la documentazione Documentazione di Nebula Tutti gli endpoint Documentazione interattiva Markdown JSON OpenAPI
  1. API REST
  2. Intelligence

Intelligence

GET /insights
ListInsights

Notizie brevi su ciò che accade sui mercati, a livello globale o per un singolo asset o soggetto, ciascuna con titolo, riassunto, sentiment (−1, 0 o +1), tag, importanza da 1 a 3 e le entità coinvolte. Prima le più recenti per aggiornamento; invia order_by=start_time_desc per avere prima gli eventi più recenti.

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/insights. 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:10

offset integer QUERY

Numero di risultati saltati.

Default:0

start_time_after string (date-time) QUERY

Solo gli elementi che iniziano dopo questo orario RFC3339. I piani gratuiti arrivano indietro di 90 giorni; oltre restituisce 403.

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

start_time_before string (date-time) QUERY

Solo gli elementi che iniziano prima di questo orario RFC3339. I piani gratuiti arrivano indietro di 90 giorni; oltre restituisce 403.

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

tags array<string> QUERY

Mantiene le notizie che riportano uno qualsiasi di questi tag, con corrispondenza esatta (ad esempio earnings). I tag sono etichette libere; leggili dalle notizie restituite. Invia più tag separati da virgola.

Example:earnings

exclude_tags array<string> QUERY

Esclude le notizie che riportano uno qualsiasi di questi tag. Corrisponde solo ai tag, non a categorie o domini: per escludere le notizie crypto, filtra invece i domini. Invia più tag separati da virgola.

Example:rumour

categories array<string> QUERY

Mantiene le notizie la cui categoria principale è una di queste, con corrispondenza esatta (ad esempio equities o technology). Le categorie sono libere; leggile dalle notizie restituite. Invia più categorie separate da virgola.

Example:equities

domains array<string> QUERY

Mantiene le notizie in uno qualsiasi di questi domini. Invia più domini separati da virgola.

Example:equities,macro

order_by string QUERY

Ordinamento dei risultati. Il valore predefinito è updated_at_desc.

Valori consentiti
start_time_ascstart_time_descupdated_at_ascupdated_at_desccreated_at_asccreated_at_descimportance_score_ascimportance_score_desc

Default:updated_at_desc

Esempio cURL

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

insights
array<object> obbligatorio

Elementi di intelligence curati che corrispondono ai filtri forniti.
insights[].category
string opzionale

Categoria principale di intelligence, quando assegnata.

insights[].domains
array<string> obbligatorio

Domini di mercato o di argomento associati al record.

insights[].entities
array<object> obbligatorio

Asset e soggetti non-asset collegati a questo record.
insights[].entities[].asset_class
string opzionale

La classe dell'asset, inviata con asset_id.

Valori consentiti
equitycommodityindexcrypto
insights[].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.

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

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

Classificazioni del knowledge graph per l'entità collegata.

insights[].entities[].is_direct
boolean obbligatorio

True quando il record riguarda direttamente questa entità collegata.

insights[].entities[].is_primary
boolean obbligatorio

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

insights[].entities[].name
string obbligatorio

Nome leggibile.

insights[].entities[].role
string obbligatorio

Relazione dell'entità collegata con l'elemento di intelligence.

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

insights[].headline
string obbligatorio

Titolo conciso dell'intelligence.

insights[].importance_score
integer obbligatorio

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

insights[].insight_id
integer (int64) obbligatorio

Identificatore stabile per l'elemento di intelligence.

insights[].sentiment_score
integer obbligatorio

Punteggio di sentiment con segno; positivo è rialzista e negativo è ribassista.

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

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

insights[].summary
string obbligatorio

Riepilogo dell'elemento di intelligence basato sulle evidenze.

insights[].tags
array<string> obbligatorio

Etichette ricercabili associate al record.

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

Ora UTC dell'ultimo aggiornamento del record.

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