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

Attenzione degli insight

GET /insights/attention
GetInsightAttention

La conversazione attorno a un elemento di intelligence: la finestra di attenzione di 24 ore, i conteggi di autori e sentiment, i bucket orari, la composizione dei cluster, i vettori di impatto e le reazioni di prezzo per ogni entità collegata con prezzo disponibile. Usalo dopo /insights quando un lettore apre un elemento e necessita del contesto completo a livello di drawer.

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

Parametri

insight_id integer QUERY obbligatorio

Identificatore stabile dell'elemento di intelligence restituito da /insights. I piani gratuiti risalgono a 90 giorni; oltre restituisce 403.

Example:1

Esempio 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'

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

attention
object obbligatorio

Lettura di conversazione e impatto per l'elemento di intelligence richiesto.
attention.anchor_subject_id
string obbligatorio

Id del soggetto usato per ancorare la scansione dell'attenzione.

attention.authors
integer (int64) obbligatorio

Autori distinti rappresentati dai post corrispondenti.

attention.average_sentiment_score
number (double) obbligatorio

Media aritmetica dei punteggi di sentiment dei post, sulla scala da −100 (molto ribassista) a +100 (molto rialzista).

attention.bearish_posts
integer (int64) obbligatorio

Post classificati come bearish.

attention.bucket_hours
integer obbligatorio

Ampiezza di ciascun bucket in ore.

attention.buckets
array<object> obbligatorio

Bucket di attenzione in ordine cronologico.
attention.buckets[].authors
integer (int64) obbligatorio

Autori distinti rappresentati dai post corrispondenti.

attention.buckets[].average_sentiment_score
number (double) obbligatorio

Media aritmetica dei punteggi di sentiment dei post, sulla scala da −100 (molto ribassista) a +100 (molto rialzista).

attention.buckets[].bearish_posts
integer (int64) obbligatorio

Post classificati come bearish.

attention.buckets[].bullish_posts
integer (int64) obbligatorio

Post classificati come bullish.

attention.buckets[].neutral_posts
integer (int64) obbligatorio

Post classificati come neutral.

attention.buckets[].posts
integer (int64) obbligatorio

Numero di post corrispondenti nella finestra richiesta.

attention.buckets[].timestamp
string (date-time) obbligatorio

Timestamp UTC in formato RFC 3339 per l'osservazione o l'inizio del bucket.

attention.bullish_posts
integer (int64) obbligatorio

Post classificati come bullish.

attention.cluster_mix
array<object> obbligatorio

Composizione dei cluster di autori per i post corrispondenti, ordinata per numero di autori.
attention.cluster_mix[].authors
integer (int64) obbligatorio

Autori distinti rappresentati dai post corrispondenti.

attention.cluster_mix[].cluster_id
string obbligatorio

Identificatore canonico del cluster di autori.

attention.cluster_mix[].posts
integer (int64) opzionale

Numero di post corrispondenti nella finestra richiesta.

attention.cluster_mix[].share
number (double) obbligatorio

Quota di attenzione social idonea, come frazione decimale da 0 a 1.

attention.clusters
integer (int64) obbligatorio

Cluster di autori distinti rappresentati dai post corrispondenti.

attention.from
string (date-time) obbligatorio

Inizio UTC incluso della finestra misurata.

attention.impact
object opzionale

Valutazione strutturata dell'impatto per l'elemento di intelligence.
attention.impact.max_score
integer obbligatorio

Punteggio massimo possibile per ciascun vettore di impatto.

attention.impact.sentiment_score
integer obbligatorio

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

attention.impact.vectors
array<object> obbligatorio

Vettori di impatto alla base della valutazione dell'impatto a livello di elemento.
attention.impact.vectors[].key
string obbligatorio

Chiave stabile leggibile dalla macchina per questo vettore di impatto.

attention.impact.vectors[].label
string obbligatorio

Etichetta leggibile del bucket o dell'indice.

attention.impact.vectors[].score
integer obbligatorio

Punteggio per questo vettore di impatto.

attention.last_post_at
string (date-time) opzionale

Ora UTC del post corrispondente più recente nella finestra richiesta.

attention.neutral_posts
integer (int64) obbligatorio

Post classificati come neutral.

attention.optional_subjects
array<string> obbligatorio

Id dei soggetti che i post corrispondenti dovevano menzionare almeno uno; vuoto significa che non era richiesto alcun lato opzionale.

attention.posts
integer (int64) obbligatorio

Numero di post corrispondenti nella finestra richiesta.

attention.required_subjects
array<string> obbligatorio

Id dei soggetti che tutti i post corrispondenti dovevano menzionare.

attention.subjects_used
array<string> obbligatorio

Id dei soggetti effettivamente usati per la finestra di attenzione restituita dopo eventuali fallback.

attention.to
string (date-time) obbligatorio

Fine UTC esclusa della finestra misurata.

attention.window_kind
string obbligatorio

Posizionamento della finestra rispetto all'insight: prima o attorno.

insight_id
integer (int64) obbligatorio

Identificatore stabile per l'elemento di intelligence.

price_reactions
array<object> obbligatorio

Reazioni di prezzo per le entità con prezzo disponibile collegate all'elemento di intelligence.
price_reactions[].insight_at
string (date-time) obbligatorio

Ora UTC usata come baseline per la reazione di prezzo.

price_reactions[].insight_id
integer (int64) obbligatorio

Identificatore stabile per l'elemento di intelligence.

price_reactions[].live_pct
number (double) opzionale

Variazione di prezzo più recente rispetto alla baseline dell'insight, presente per gli insight recenti.

price_reactions[].moves
array<object> obbligatorio

Movimenti di prezzo a orizzonte fisso una volta trascorso ciascun orizzonte.
price_reactions[].moves[].change_pct
number (double) obbligatorio

Variazione percentuale in punti del prezzo rispetto alla baseline al momento dell'insight.

price_reactions[].moves[].hours
integer obbligatorio

Finestra di lookback rappresentata dalla risposta, in ore.

price_reactions[].series
array<object> obbligatorio

Osservazioni ordinate cronologicamente.
price_reactions[].series[].change_pct
number (double) obbligatorio

Variazione percentuale in punti del prezzo rispetto alla baseline al momento dell'insight.

price_reactions[].series[].timestamp
string (date-time) obbligatorio

Timestamp UTC in formato RFC 3339 per l'osservazione o l'inizio del bucket.

price_reactions[].subject_id
string obbligatorio

Identificatore canonico per una persona, un account o un argomento non riconducibile a un asset.

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