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

Arrivi del ciclo di hype

GET /clusters/comparison/hype-cycles
CompareHypeCycles

I maggiori cicli di hype della finestra e l'ordine in cui i cluster sono arrivati in ciascuno, rispetto all'ora di picco del mercato, con i post orari del mercato intorno al picco.

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

Su quanti giorni UTC completi di picchi di mercato misurare, contando a ritroso dall'ultimo giorno completo: 7, 30 o 90. I piani gratuiti arrivano a 90 giorni; oltre restituisce 403.

Valori consentiti
73090

Default:30

limit integer QUERY

Numero massimo di cicli di hype restituiti: i maggiori per post nel loro giorno di picco.

Default:40

Esempio cURL

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

cycles
array<object> obbligatorio

I maggiori cicli di hype della finestra, con il picco più recente per primo, fino a limit.
cycles[].arrivals
array<object> obbligatorio

Ogni cluster con 3 o più post nelle 48 ore intorno all'ora di picco, dal più precoce.
cycles[].arrivals[].cluster_id
string obbligatorio

Identificatore canonico del cluster di autori.

cycles[].arrivals[].offset_hours
number (double) obbligatorio

Ore dall'ora di picco del mercato all'ora media ponderata per i post dei post del cluster nelle 48 ore intorno a essa. Un valore negativo indica prima del picco.

cycles[].arrivals[].posts
integer (int64) obbligatorio

I post del cluster sull'asset nelle 48 ore intorno all'ora di picco.

cycles[].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
cycles[].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.

cycles[].name
string obbligatorio

Nome leggibile.

cycles[].peak_day_posts
integer (int64) obbligatorio

I post del mercato sull'asset nel giorno di picco, esclusi i bot.

cycles[].peak_timestamp
string (date-time) obbligatorio

Inizio in UTC dell'ora più intensa del mercato nel giorno di picco.

cycles[].series
array<object> obbligatorio

I post del mercato sull'asset ora per ora, da 24 ore prima dell'ora di picco a 23 ore dopo: 48 osservazioni.
cycles[].series[].posts
integer (int32) obbligatorio

I post del mercato sull'asset nell'ora, esclusi i bot.

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

Inizio dell'ora in UTC.

cycles[].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"
  ],
  "cycles": [
    {
      "arrivals": [
        {
          "cluster_id": "smart_money",
          "offset_hours": -3.2,
          "posts": 18
        },
        {
          "cluster_id": "team_leaders",
          "offset_hours": -2.1,
          "posts": 9
        },
        {
          "cluster_id": "media",
          "offset_hours": 1.4,
          "posts": 57
        }
      ],
      "asset_class": "equity",
      "asset_id": "ORCL",
      "name": "Oracle Corporation",
      "peak_day_posts": 930,
      "peak_timestamp": "2026-09-10T14:00:00Z",
      "series": [
        {
          "posts": 41,
          "timestamp": "2026-09-10T13:00:00Z"
        },
        {
          "posts": 112,
          "timestamp": "2026-09-10T14:00:00Z"
        },
        {
          "posts": 64,
          "timestamp": "2026-09-10T15:00:00Z"
        }
      ],
      "symbol": "ORCL"
    }
  ],
  "days": 30
}