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

Soggetti correlati

GET /related-subjects
GetRelatedSubjects

Le persone, gli account e gli argomenti di cui si parla più spesso negli stessi post di un asset o di un soggetto. share indica i post condivisi come frazione dei post dell'anchor; i campi di sentiment sono il sentiment dell'anchor all'interno di quei post condivisi.

Regole dei parametri:

  • Invia asset_id o subject_id.
  • asset_id deve essere inviato insieme a asset_class.
  • 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/related-subjects. 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

hours integer QUERY

Finestra di lookback in ore. I piani gratuiti risalgono fino a 90 giorni; oltre viene restituito 403.

Default:168

limit integer QUERY

Numero massimo di risultati restituiti.

Default:25

Esempio cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/related-subjects' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --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

authors
integer (int64) obbligatorio

Autori distinti rappresentati dai post corrispondenti.

average_sentiment_score
number (double) obbligatorio

Punteggio di sentiment medio su tutti i post dell'anchor nella finestra richiesta.

from
string (date-time) obbligatorio

Inizio UTC incluso della finestra misurata.

hours
integer obbligatorio

Finestra di lookback rappresentata dalla risposta, in ore.

posts
integer (int64) obbligatorio

Numero di post corrispondenti nella finestra richiesta.

subjects
array<object> obbligatorio

Soggetti non-asset restituiti dall'operazione di discovery.
subjects[].authors
integer (int64) obbligatorio

Autori distinti rappresentati dai post corrispondenti.

subjects[].bearish_posts
integer (int64) obbligatorio

Post classificati come bearish.

subjects[].bullish_posts
integer (int64) obbligatorio

Post classificati come bullish.

subjects[].first_post_at
string (date-time) opzionale

Ora UTC del primo post corrispondente nella finestra richiesta.

subjects[].last_post_at
string (date-time) opzionale

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

subjects[].name
string obbligatorio

Nome leggibile.

subjects[].neutral_posts
integer (int64) obbligatorio

Post classificati come neutral.

subjects[].posts
integer (int64) obbligatorio

Numero di post corrispondenti nella finestra richiesta.

subjects[].posts_delta
number (double) obbligatorio

Variazione frazionaria da posts_prior a posts_recent; i valori positivi indicano crescita.

subjects[].posts_prior
integer (int64) obbligatorio

Post corrispondenti nella prima metà della finestra richiesta.

subjects[].posts_recent
integer (int64) obbligatorio

Post corrispondenti nella seconda metà della finestra richiesta.

subjects[].sentiment_delta
number (double) obbligatorio

Differenza tra sentiment_score per la conversazione condivisa e la media dell'anchor sull'intera finestra.

subjects[].sentiment_score
number (double) obbligatorio

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

subjects[].share
number (double) obbligatorio

Post dell'anchor che menzionano anche questo soggetto, come frazione decimale di tutti i post dell'anchor nella finestra.

subjects[].subject_id
string obbligatorio

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

to
string (date-time) obbligatorio

Fine UTC esclusa della finestra misurata.

{
  "authors": 241,
  "average_sentiment_score": 36.2,
  "from": "2026-08-15T09:00:00Z",
  "hours": 168,
  "posts": 684,
  "subjects": [
    {
      "authors": 73,
      "bearish_posts": 41,
      "bullish_posts": 112,
      "first_post_at": "2026-08-15T09:00:00Z",
      "last_post_at": "2026-08-22T08:45:00Z",
      "name": "Artificial Intelligence",
      "neutral_posts": 31,
      "posts": 184,
      "posts_delta": 0.556,
      "posts_prior": 72,
      "posts_recent": 112,
      "sentiment_delta": 8.4,
      "sentiment_score": 42.6,
      "share": 0.148,
      "subject_id": "text:artificial intelligence"
    }
  ],
  "to": "2026-08-22T09:00:00Z"
}