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

Rotazione dei cluster

GET /clusters/rotation
GetClusterRotation

Dove si sta spostando l'attenzione di un cluster: gli asset che guadagnano e perdono quota dei suoi post rispetto alla finestra precedente, in punti base, e come i suoi post si distribuiscono tra mercati, persone ed eventi.

Regole dei parametri:

  • Invia cluster_id.
  • cluster_id indica un solo cluster; per confrontarne diversi, chiama una volta per cluster oppure usa /clusters per tutti i cluster in una sola volta.
  • Le community di posting (wallstreetbets, reddit) coprono solo le equity: con una di esse, asset_class deve includere equity.

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

Parametri

cluster_id string QUERY obbligatorio

Il cluster da analizzare, così come lo restituisce /clusters, ad esempio smart_money o wallstreetbets. Qualsiasi id dal parametro clusters di /sentiment.

Example:smart_money

asset_class array<string> QUERY

I mercati da analizzare: uno qualsiasi tra equity, commodity, index e crypto, separati da virgole. Il valore predefinito è tutti e quattro. Inviane diversi separati da virgole.

Default:equity,commodity,index,crypto

hours integer QUERY

La finestra con cui confrontare quella della stessa lunghezza precedente: 24 (le ultime 24 ore), 168 (gli ultimi 7 giorni completi) o 720 (gli ultimi 30 giorni completi). I piani gratuiti risalgono fino a 90 giorni; oltre restituisce 403.

Valori consentiti
24168720

Default:168

limit integer QUERY

Numero massimo di rialzisti restituiti e, separatamente, numero massimo di ribassisti.

Default:6

Esempio cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/rotation' \
  --data-urlencode 'cluster_id=smart_money' \
  --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.

cluster_id
string obbligatorio

Il cluster analizzato, come suo cluster_id canonico.

gainers
array<object> obbligatorio

Asset la cui quota dei post del cluster è cresciuta di più, con il maggiore aumento per primo. Sono elencati solo gli asset la cui quota è aumentata.
gainers[].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
gainers[].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.

gainers[].current_share
number (double) obbligatorio

Post come frazione di tutti i post del cluster sulle classi di asset selezionate nella finestra corrente, da 0 a 1.

gainers[].name
string obbligatorio

Nome leggibile.

gainers[].previous_share
number (double) obbligatorio

I post sull'asset come frazione di tutti i post del cluster nella finestra di confronto, da 0 a 1.

gainers[].share_change_bps
integer obbligatorio

current_share meno la quota nella finestra di confronto, in punti base: 100 equivale a un punto percentuale. Un valore negativo indica che la quota è diminuita.

gainers[].symbol
string obbligatorio

Ticker o simbolo di mercato visualizzato.

hours
integer obbligatorio

Finestra di lookback rappresentata dalla risposta, in ore.

losers
array<object> obbligatorio

Asset la cui quota dei post del cluster è diminuita di più, con il calo maggiore per primo. Sono elencati solo gli asset la cui quota è diminuita.
losers[].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
losers[].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.

losers[].current_share
number (double) obbligatorio

Post come frazione di tutti i post del cluster sulle classi di asset selezionate nella finestra corrente, da 0 a 1.

losers[].name
string obbligatorio

Nome leggibile.

losers[].previous_share
number (double) obbligatorio

I post sull'asset come frazione di tutti i post del cluster nella finestra di confronto, da 0 a 1.

losers[].share_change_bps
integer obbligatorio

current_share meno la quota nella finestra di confronto, in punti base: 100 equivale a un punto percentuale. Un valore negativo indica che la quota è diminuita.

losers[].symbol
string obbligatorio

Ticker o simbolo di mercato visualizzato.

topic_changes
array<object> obbligatorio

La quota di ogni argomento nella finestra corrente e la sua variazione rispetto a quella precedente, nell'ordine equity, commodity, index, crypto, people, events.
topic_changes[].current_share
number (double) obbligatorio

La quota dell'argomento sui post del cluster nella finestra corrente, da 0 a 1.

topic_changes[].share_change_bps
integer obbligatorio

Variazione della quota rispetto alla finestra precedente, in punti base (100 equivale a un punto percentuale).

topic_changes[].topic
string obbligatorio

equity, commodity, index, crypto, people (persone e i loro account) o events (luoghi, temi ed eventi).

Valori consentiti
equitycommodityindexcryptopeopleevents
topic_series
array<object> obbligatorio

La quota di ogni argomento sui post del cluster per ogni giorno UTC completo, dal più vecchio al più recente.
topic_series[].timestamp
string (date-time) obbligatorio

Inizio del giorno in UTC: 00:00.

topic_series[].topics
array<object> obbligatorio

La quota di ogni argomento sui post del cluster in quel giorno, nell'ordine di topic_changes. Le quote sommano a 1 quando il cluster ha pubblicato post quel giorno.
topic_series[].topics[].topic
string obbligatorio

equity, commodity, index, crypto, people (persone e i loro account) o events (luoghi, temi ed eventi).

Valori consentiti
equitycommodityindexcryptopeopleevents
topic_series[].topics[].topic_share
number (double) obbligatorio

La quota dell'argomento sui post del cluster in quel giorno, da 0 a 1.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "gainers": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "current_share": 0.0687,
      "name": "NVIDIA Corporation",
      "previous_share": 0.0412,
      "share_change_bps": 275,
      "symbol": "NVDA"
    }
  ],
  "hours": 168,
  "losers": [
    {
      "asset_class": "equity",
      "asset_id": "TSLA",
      "current_share": 0.0318,
      "name": "Tesla, Inc.",
      "previous_share": 0.0521,
      "share_change_bps": -203,
      "symbol": "TSLA"
    }
  ],
  "topic_changes": [
    {
      "current_share": 0.52,
      "share_change_bps": 120,
      "topic": "equity"
    },
    {
      "current_share": 0.03,
      "share_change_bps": -15,
      "topic": "commodity"
    },
    {
      "current_share": 0.04,
      "share_change_bps": 10,
      "topic": "index"
    },
    {
      "current_share": 0.14,
      "share_change_bps": -115,
      "topic": "crypto"
    },
    {
      "current_share": 0.11,
      "share_change_bps": 35,
      "topic": "people"
    },
    {
      "current_share": 0.16,
      "share_change_bps": -35,
      "topic": "events"
    }
  ],
  "topic_series": [
    {
      "timestamp": "2026-09-10T00:00:00Z",
      "topics": [
        {
          "topic": "equity",
          "topic_share": 0.5
        },
        {
          "topic": "commodity",
          "topic_share": 0.03
        },
        {
          "topic": "index",
          "topic_share": 0.04
        },
        {
          "topic": "crypto",
          "topic_share": 0.15
        },
        {
          "topic": "people",
          "topic_share": 0.11
        },
        {
          "topic": "events",
          "topic_share": 0.17
        }
      ]
    },
    {
      "timestamp": "2026-09-11T00:00:00Z",
      "topics": [
        {
          "topic": "equity",
          "topic_share": 0.53
        },
        {
          "topic": "commodity",
          "topic_share": 0.03
        },
        {
          "topic": "index",
          "topic_share": 0.04
        },
        {
          "topic": "crypto",
          "topic_share": 0.13
        },
        {
          "topic": "people",
          "topic_share": 0.11
        },
        {
          "topic": "events",
          "topic_share": 0.16
        }
      ]
    }
  ]
}