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

Cluster di autori

GET /clusters
ListClusters

Attività e sentiment di ogni cluster di autori in un mercato: post, autori unici, variazione rispetto alla finestra precedente e sentiment netto (post rialzisti meno ribassisti) con una serie oraria. asset_class è equity (il valore predefinito) o crypto.

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

Parametri

asset_class string QUERY

Mercato da aggregare: equity (mercati tradizionali, che coprono insieme azioni, materie prime e indici) o crypto.

Valori consentiti
equitycrypto

Default:equity

hours integer QUERY

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

Default:24

Esempio cURL

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

Riepiloghi dei cluster di autori per la classe di attività selezionata.
clusters[].activity_change_pct
number (double) opzionale

Variazione percentuale dei post rispetto alla finestra precedente di pari durata (76 post dopo 84 è -9,52); assente quando non è possibile alcun confronto.

clusters[].bearish_posts
number (double) obbligatorio

Post classificati come bearish.

clusters[].bullish_posts
number (double) obbligatorio

Post classificati come bullish.

clusters[].cluster_id
string obbligatorio

Identificatore canonico del cluster di autori.

clusters[].neutral_posts
number (double) obbligatorio

Post classificati come neutral.

clusters[].previous_total_posts
number (double) obbligatorio

Numero di post nella finestra immediatamente precedente di pari durata.

clusters[].recent_sentiment_signal
number (double) obbligatorio

L'ultimo valore della serie oraria del sentiment: l'ora più recente con post.

clusters[].series
array<object> obbligatorio

Osservazioni ordinate cronologicamente.
clusters[].series[].bearish_posts
number (double) obbligatorio

Post classificati come bearish.

clusters[].series[].bullish_posts
number (double) obbligatorio

Post classificati come bullish.

clusters[].series[].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à.

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

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

clusters[].series[].total_posts
number (double) obbligatorio

Numero di post nella finestra di riferimento attiva della metrica.

clusters[].total_posts
number (double) obbligatorio

Numero di post nella finestra di riferimento attiva della metrica.

clusters[].window_sentiment_signal
number (double) obbligatorio

Segnale di sentiment netto rialzista sull'intera finestra richiesta.

hours
integer obbligatorio

Finestra di lookback rappresentata dalla risposta, in ore.

{
  "clusters": [
    {
      "activity_change_pct": 18.4,
      "bearish_posts": 438,
      "bullish_posts": 1120,
      "cluster_id": "smart_money",
      "neutral_posts": 284,
      "previous_total_posts": 1556,
      "recent_sentiment_signal": 84.2,
      "series": [
        {
          "bearish_posts": 438,
          "bullish_posts": 1120,
          "sentiment_signal": 128.6,
          "timestamp": "2026-08-07T15:00:00Z",
          "total_posts": 1842
        }
      ],
      "total_posts": 1842,
      "window_sentiment_signal": 63.7
    }
  ],
  "hours": 168
}