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

Confronto tra cluster

GET /clusters/comparison
CompareClusters

Ogni cluster di autori a confronto sulla finestra: post e relativa variazione, quanto è rialzista rispetto al mercato (cluster_bullish_share contro market_bullish_share), l'attività su cui si è orientato di più negli ultimi 7 giorni (trending_asset) e i post giornalieri.

Pagamento con wallet disponibile su https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/comparison. 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 array<string> QUERY

I mercati da confrontare: uno qualsiasi tra equity, commodity, index e crypto, separati da virgole. Il valore predefinito è tutti e quattro. Invia più valori separati da virgole.

Default:equity,commodity,index,crypto

days integer QUERY

Quanti giorni UTC completi confrontare, contando a ritroso dall'ultimo giorno completo: 7, 30 o 90. activity_change_pct confronta con lo stesso numero di giorni precedenti. I piani gratuiti risalgono a 90 giorni; oltre restituisce 403.

Valori consentiti
73090

Default:30

Esempio cURL

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

asset_classes
array<string> obbligatorio

I mercati analizzati, nell'ordine equity, commodity, index, crypto: i valori asset_class richiesti, o tutti e quattro quando asset_class è stato omesso.

clusters
array<object> obbligatorio

Ogni cluster con post nella finestra, prima quelli con più post.
clusters[].activity_change_pct
number (double) obbligatorio

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
integer (int64) obbligatorio

I post ribassisti del cluster nella finestra.

clusters[].bullish_posts
integer (int64) obbligatorio

I post rialzisti del cluster nella finestra.

clusters[].cluster_bullish_share
number (double) obbligatorio

Post rialzisti ÷ (rialzisti + ribassisti) del cluster nella finestra, da 0 a 1. Nullo in assenza di post rialzisti o ribassisti.

clusters[].cluster_id
string obbligatorio

Identificatore canonico del cluster di autori.

clusters[].market_bullish_share
number (double) obbligatorio

La stessa quota per il mercato che il cluster legge, sugli stessi giorni e classi di attività (il mercato equity per una community di post): la baseline cluster_bullish_share con cui viene confrontata. Nullo in assenza di post rialzisti o ribassisti.

clusters[].posts
integer (int64) obbligatorio

I post del cluster nella finestra.

clusters[].series
array<object> obbligatorio

Ogni giorno UTC completo della finestra, dal più vecchio al più recente, inclusi i giorni senza post.
clusters[].series[].bearish_posts
integer (int64) obbligatorio

I post ribassisti del cluster nella giornata.

clusters[].series[].bullish_posts
integer (int64) obbligatorio

I post rialzisti del cluster nella giornata.

clusters[].series[].posts
integer (int64) obbligatorio

I post del cluster nella giornata.

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

Inizio del giorno in UTC: 00:00.

clusters[].trending_asset
object obbligatorio

L'asset su cui il cluster si è spostato più del mercato negli ultimi 7 giorni completi; null quando non ce n'è nessuno.
clusters[].trending_asset.asset_class
string obbligatorio

La classe dell'asset: equity (azioni ed ETF), commodity, index o crypto. Va inviata con asset_id in ogni richiesta con ambito asset.

Valori consentiti
equitycommodityindexcrypto
clusters[].trending_asset.asset_id
string obbligatorio

Identificatore pubblico canonico dell'asset: il ticker o simbolo di mercato per azioni, commodity e indici, e lo slug CoinGecko (o, in mancanza, un id numerico) per le crypto.

clusters[].trending_asset.name
string obbligatorio

Nome leggibile.

clusters[].trending_asset.symbol
string obbligatorio

Ticker o simbolo di mercato visualizzato.

days
integer obbligatorio

Lunghezza della finestra in giorni UTC completi, fino all'ultimo giorno completo.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "clusters": [
    {
      "activity_change_pct": 7.61,
      "bearish_posts": 13550,
      "bullish_posts": 61240,
      "cluster_bullish_share": 0.8188,
      "cluster_id": "media",
      "market_bullish_share": 0.7812,
      "posts": 173412,
      "series": [
        {
          "bearish_posts": 480,
          "bullish_posts": 2210,
          "posts": 6120,
          "timestamp": "2026-09-11T00:00:00Z"
        },
        {
          "bearish_posts": 512,
          "bullish_posts": 2102,
          "posts": 5874,
          "timestamp": "2026-09-12T00:00:00Z"
        }
      ],
      "trending_asset": {
        "asset_class": "equity",
        "asset_id": "NVDA",
        "name": "NVIDIA Corporation",
        "symbol": "NVDA"
      }
    },
    {
      "activity_change_pct": 171.42,
      "bearish_posts": 18860,
      "bullish_posts": 20480,
      "cluster_bullish_share": 0.5206,
      "cluster_id": "wallstreetbets",
      "market_bullish_share": 0.7035,
      "posts": 88034,
      "series": [
        {
          "bearish_posts": 702,
          "bullish_posts": 790,
          "posts": 3310,
          "timestamp": "2026-09-11T00:00:00Z"
        },
        {
          "bearish_posts": 681,
          "bullish_posts": 655,
          "posts": 2987,
          "timestamp": "2026-09-12T00:00:00Z"
        }
      ],
      "trending_asset": {
        "asset_class": "equity",
        "asset_id": "ORCL",
        "name": "Oracle Corporation",
        "symbol": "ORCL"
      }
    }
  ],
  "days": 30
}