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

Sentiment per intervallo temporale

GET /sentiment/timeframes
GetSentimentTimeframes

Sentiment suddiviso per l'orizzonte temporale di cui si parla: breve termine (fino a una settimana), medio termine (da settimane a mesi) e lungo termine (tre mesi o più), ciascuno sulla scala di /sentiment. Distingue una massa che è ribassista questa settimana ma rialzista sull'anno da una che è ribassista su tutto l'arco temporale.

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/sentiment/timeframes. 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/sentiment/timeframes' \
  --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

current
object obbligatorio

Ultima lettura di sentiment per ogni orizzonte temporale disponibile.

Chiavi consentite
short_termmedium_termlong_term
metadata
object opzionale

Metodologia e metadati della finestra di richiesta necessari per interpretare la risposta.
metadata.as_of
string (date-time) opzionale

Ora UTC in cui è stata calcolata la metrica.

metadata.calculation
string opzionale

Nome breve del metodo di calcolo.

metadata.formula
string opzionale

Formula leggibile del calcolo.

metadata.half_life_hours
number (double) opzionale

Nonostante il nome, la lunghezza della finestra di decadimento lineare, in ore: un post conta per intero quando è nuovo, per metà al punto centrale e per nulla una volta raggiunta questa età.

metadata.lookback_days
integer opzionale

Periodo storico di riferimento usato dal calcolo, in giorni.

metadata.scale
string opzionale

Scala pubblicata o interpretazione della metrica.

series
object obbligatorio

Serie di sentiment indicizzata per orizzonte short_term, medium_term e long_term.

Chiavi consentite
short_termmedium_termlong_term
series.{key}[].interval_posts
number (double) opzionale

Post in questo bucket temporale emesso, prima dell'accumulo del lookback.

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

Post netti rialzisti ponderati per decadimento: rialzisti meno ribassisti. Positivo è rialzista, negativo è ribassista e l'ampiezza cresce con l'attività.

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

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

series.{key}[].total_posts
number (double) opzionale

Numero di post nella finestra di riferimento attiva della metrica.

{
  "current": {
    "long_term": 52.1,
    "medium_term": 57.8,
    "short_term": 64.2
  },
  "series": {
    "short_term": [
      {
        "sentiment_signal": 64.2,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 318
      }
    ]
  }
}