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

Profilo del cluster

GET /clusters/profile
GetClusterProfile

I trait comportamentali di un cluster, ciascuno classificato rispetto a ogni altro cluster (rank 1 è il più alto):

  • earliness (giorni): quanto in anticipo pubblica attorno ai picchi dei cicli di hype; positivo significa in anticipo.
  • contrarian (quota): asset su cui propende nella direzione opposta al mercato.
  • hype_fade (giorni): positivo significa che diventa meno rialzista man mano che l'hype cresce.
  • conviction (giorni): per quanto tempo mantiene la stessa opinione su un asset.
  • focus (quota): post sui suoi 5 asset principali.
  • breadth (conteggio): asset di cui parla.
  • bullishness (quota): quota di post rialzisti sul totale dei suoi post rialzisti e ribassisti.
  • discovery (quota): post su asset al di fuori dei primi 100 del mercato.
  • turnover (quota): quanto cambiano di settimana in settimana i suoi 10 asset principali.
  • coverage (quota): cicli di hype a cui ha preso parte.

Un ciclo di hype è un giorno in cui i post su un asset schizzano ad almeno 3× la norma. Solo giorni UTC completi.

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

Su quanti giorni UTC completi eseguire l'analisi, contando a ritroso dall'ultimo giorno completo: 30 o 90. Finestre più lunghe vedono più cicli di hype, quindi i trait dei cicli sono più stabili. I piani gratuiti arrivano 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/profile' \
  --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

active_clusters
integer obbligatorio

Cluster attivi nella finestra: i trait della popolazione sono classificati al loro interno.

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.

days
integer obbligatorio

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

hype_cycles
integer obbligatorio

Cicli di hype del mercato nella finestra: asset i cui post hanno raggiunto un picco di 50 o più in un giorno e almeno 3× la loro giornata mediana.

traits
array<object> obbligatorio

Una voce per trait, nell'ordine earliness, contrarian, hype_fade, conviction, focus, breadth, bullishness, discovery, turnover, coverage.
traits[].peer_values
array<number (double)> obbligatorio

Il valore di ogni altro cluster per questo tratto, in ordine crescente.

traits[].percentile
number (double) obbligatorio

Da 0 (il più basso) a 1 (il più alto) tra i cluster con un valore. Null quando il valore è null.

traits[].rank
integer obbligatorio

1 è il valore più alto; i cluster a pari merito condividono il rango migliore. Null quando il valore è null.

traits[].trait
string obbligatorio

Il trait misurato; la descrizione dell'operazione definisce ciascuno.

Valori consentiti
earlinesscontrarianhype_fadeconvictionfocusbreadthbullishnessdiscoveryturnovercoverage
traits[].unit
string obbligatorio

giorni, quota (da 0 a 1) o conteggio; fisso per trait.

Valori consentiti
dayssharecount
traits[].value
number (double) obbligatorio

Il valore del cluster per questo tratto, in unit; null quando il cluster ha troppi pochi dati per calcolarlo.

{
  "active_clusters": 34,
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "days": 90,
  "hype_cycles": 41,
  "traits": [
    {
      "peer_values": [
        -1.8,
        -0.64,
        0.12,
        0.87,
        2.05
      ],
      "percentile": 0.9394,
      "rank": 3,
      "trait": "earliness",
      "unit": "days",
      "value": 1.42
    },
    {
      "peer_values": [
        0.041,
        0.083,
        0.112,
        0.204,
        0.267
      ],
      "percentile": 0.7576,
      "rank": 9,
      "trait": "contrarian",
      "unit": "share",
      "value": 0.1875
    },
    {
      "peer_values": [
        -1.1,
        -0.3,
        0.2,
        0.9,
        1.4
      ],
      "percentile": 0.8182,
      "rank": 7,
      "trait": "hype_fade",
      "unit": "days",
      "value": 0.6
    },
    {
      "peer_values": [
        1.4,
        1.9,
        2.2,
        2.8,
        3.6
      ],
      "percentile": 0.6667,
      "rank": 12,
      "trait": "conviction",
      "unit": "days",
      "value": 2.35
    },
    {
      "peer_values": [
        0.18,
        0.24,
        0.35,
        0.47,
        0.72
      ],
      "percentile": 0.4242,
      "rank": 20,
      "trait": "focus",
      "unit": "share",
      "value": 0.31
    },
    {
      "peer_values": [
        41,
        96,
        188,
        405,
        1270
      ],
      "percentile": 0.8485,
      "rank": 6,
      "trait": "breadth",
      "unit": "count",
      "value": 312
    },
    {
      "peer_values": [
        0.52,
        0.64,
        0.71,
        0.78,
        0.86
      ],
      "percentile": 0.6061,
      "rank": 14,
      "trait": "bullishness",
      "unit": "share",
      "value": 0.7412
    },
    {
      "peer_values": [
        0.09,
        0.17,
        0.26,
        0.38,
        0.61
      ],
      "percentile": 0.5152,
      "rank": 17,
      "trait": "discovery",
      "unit": "share",
      "value": 0.2837
    },
    {
      "peer_values": [
        0.18,
        0.27,
        0.36,
        0.44,
        0.58
      ],
      "percentile": 0.3939,
      "rank": 21,
      "trait": "turnover",
      "unit": "share",
      "value": 0.3455
    },
    {
      "peer_values": [
        0.05,
        0.22,
        0.41,
        0.63,
        0.88
      ],
      "percentile": 0.7879,
      "rank": 8,
      "trait": "coverage",
      "unit": "share",
      "value": 0.6585
    }
  ]
}