Tutta la documentazione Documentazione di Nebula Tutti gli endpoint Documentazione interattiva Markdown JSON OpenAPI

API REST
Social & Sentiment

Momentum social

GET /social-momentum

GetSocialMomentum

Post, autori unici e sentiment all'interno di ciascun cluster di autori, affiancati, per un asset, un soggetto o un intero mercato: quali gruppi guidano la conversazione e come il loro tono differisce. I cluster si sovrappongono, quindi non sommarli. Invia clusters per restituire solo quelli che indichi.

Regole dei parametri:

asset_id deve essere inviato insieme a asset_class.
subject_id non può essere combinato con asset_id o asset_class.
Senza asset_id, asset_class deve essere equity o crypto; commodity e index richiedono un asset_id.

Pagamento con wallet disponibile su https://nebula-api.hiddensystems.ai/api/v1/x402/social-momentum. 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

Con asset_id, la classe dell'asset. Senza, il mercato da aggregare: equity (azioni, materie prime e indici; il valore predefinito) o crypto.

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

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

clusters array<string> QUERY

Solo questi cluster, ciascuno come serie a sé; ometti per averli tutti. Usa gli id del parametro clusters di /sentiment, tranne le posting communities.

Example:smart_money

Esempio cURL

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

clusters

object obbligatorio

Serie di momentum social indicizzata per identificatore canonico del cluster di autori.

clusters.{key}[].average_sentiment_score

number (double) obbligatorio

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

clusters.{key}[].bearish_posts

integer (int64) obbligatorio

Post classificati come bearish.

clusters.{key}[].bullish_posts

integer (int64) obbligatorio

Post classificati come bullish.

clusters.{key}[].neutral_posts

integer (int64) obbligatorio

Post classificati come neutral.

clusters.{key}[].timestamp

string (date-time) obbligatorio

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

clusters.{key}[].total_posts

integer (int64) obbligatorio

Numero di post nella finestra di riferimento attiva della metrica.

clusters.{key}[].unique_posters

integer (int64) obbligatorio

Account distinti che hanno pubblicato nel bucket; a granularità più grossolana di quella oraria si tratta di un limite superiore ottenuto sommando i conteggi orari.

{
  "clusters": {
    "smart_money": [
      {
        "average_sentiment_score": 38.5,
        "bearish_posts": 41,
        "bullish_posts": 112,
        "neutral_posts": 31,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 184,
        "unique_posters": 73
      }
    ]
  }
}