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

Cicli di hype dei cluster

GET /clusters/hype-cycles
GetClusterHypeCycles

Quanto in anticipo un cluster arriva sui cicli di hype rispetto al mercato. curve è la quota cumulativa dei post di ciascuna parte da 7 giorni prima di un picco a 7 giorni dopo, quindi la linea più a sinistra è la più anticipata; lead_days è il lead del cluster (positivo significa in anticipo), e clusters classifica il lead di ogni cluster.

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/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

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

days integer QUERY

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

Valori consentiti
3090

Default:90

Esempio cURL

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

clusters
array<object> obbligatorio

Ogni cluster con un lead (5 o più cicli), dal più anticipato, incluso quello richiesto.
clusters[].cluster_id
string obbligatorio

Il cluster, come suo cluster_id canonico.

clusters[].cycles_joined
integer obbligatorio

Cicli di hype completati in cui il cluster ha pubblicato entro 24 ore dall'ora di picco del mercato.

clusters[].lead_days
number (double) obbligatorio

Il lead del cluster in giorni, calcolato come lead_days di primo livello. Positivo significa in anticipo.

clusters[].lead_high_days
number (double) obbligatorio

Estremo superiore dell'intervallo probabile di lead_days.

clusters[].lead_low_days
number (double) obbligatorio

Estremo inferiore dell'intervallo probabile di lead_days.

curve
array<object> obbligatorio

La build-up cumulativa media, un punto per ogni day_offset da −7 a +7; vuoto quando nessun ciclo è stato completato.
curve[].cluster_cumulative_pct
number (double) obbligatorio

Percentuale dei post del cluster nei 15 giorni attorno al picco effettuati entro la fine di questo giorno, mediata sui cicli; 100 con day_offset 7.

curve[].day_offset
integer obbligatorio

Giorni dal picco di mercato: negativi prima, 0 il giorno del picco, positivi dopo.

curve[].market_cumulative_pct
number (double) obbligatorio

Lo stesso per il mercato, sugli stessi cicli.

cycles_joined
integer obbligatorio

Cicli di hype completati a cui il cluster ha partecipato: 3 o più post entro 7 giorni dal picco.

days
integer obbligatorio

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

lead_days
number (double) obbligatorio

Quanto in anticipo rispetto a tutti gli altri arrivano i post del cluster entro 24 ore dall'ora di picco del mercato, in giorni. Positivo significa in anticipo; null sotto 20 cicli.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "clusters": [
    {
      "cluster_id": "wallstreetbets",
      "cycles_joined": 171,
      "lead_days": 0.0542,
      "lead_high_days": 0.0708,
      "lead_low_days": 0.0417
    },
    {
      "cluster_id": "smart_money",
      "cycles_joined": 471,
      "lead_days": 0.0125,
      "lead_high_days": 0.0292,
      "lead_low_days": -0.0083
    },
    {
      "cluster_id": "exchanges",
      "cycles_joined": 466,
      "lead_days": -0.0667,
      "lead_high_days": -0.0542,
      "lead_low_days": -0.0792
    }
  ],
  "curve": [
    {
      "cluster_cumulative_pct": 46.8,
      "day_offset": -1,
      "market_cumulative_pct": 38.2
    },
    {
      "cluster_cumulative_pct": 63.5,
      "day_offset": 0,
      "market_cumulative_pct": 57.9
    },
    {
      "cluster_cumulative_pct": 73.1,
      "day_offset": 1,
      "market_cumulative_pct": 69.4
    }
  ],
  "cycles_joined": 27,
  "days": 90,
  "lead_days": 0.0125
}