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

Distribuzione delle emozioni

GET /emotions
GetEmotions

Quali delle 15 emozioni dominano la conversazione su un asset o un soggetto nel tempo. proportion è la share di ciascuna emozione rispetto alle emozioni del bucket (la loro somma è 1); post_count conta i post che la mostrano. Un post può mostrarne diverse.

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/emotions. 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:720

granularity string QUERY

Dimensione del bucket della serie temporale richiesta. Se omessa, il servizio sceglie una dimensione del bucket adeguata alla finestra di lookback.

Valori consentiti
1h2h4h12h1d

Example:1h

Esempio cURL

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

metadata
object opzionale

Metodologia e metadati della finestra di richiesta necessari per interpretare la risposta.
metadata.empty_bucket_policy
string obbligatorio

Come i client devono interpretare i bucket omessi o emessi senza dati.

metadata.empty_buckets
integer obbligatorio

Numero di bucket senza dati qualificanti.

metadata.granularity
string obbligatorio

Dimensione del bucket temporale usata dalla serie restituita.

metadata.hours
integer obbligatorio

Finestra di lookback rappresentata dalla risposta, in ore.

metadata.latest_empty_bucket
string (date-time) opzionale

Bucket UTC più recente senza dati qualificanti.

series
object obbligatorio

Osservazioni sulle emozioni indicizzate per etichetta di emozione rilevata.

Chiavi consentite
angeranticipationboredomconfidencedisgustdistrustfeargreedjoyloveoptimismpessimismsadnesssurprisetrust
series.{key}[].post_count
integer (int64) obbligatorio

Numero grezzo di post che presentano questa emozione nel bucket.

series.{key}[].proportion
number (double) obbligatorio

Share di questa emozione rispetto a tutte le etichette di emozione nel bucket, da 0 a 1.

series.{key}[].timestamp
string (date-time) obbligatorio

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

{
  "series": {
    "optimism": [
      {
        "post_count": 286,
        "proportion": 0.37,
        "timestamp": "2026-08-07T15:00:00Z"
      }
    ]
  }
}