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

Confronto dei tratti dei cluster

GET /clusters/comparison/traits
CompareClusterTraits

Ogni trait di /clusters/profile su tutti i cluster, dal valore più alto, per vedere quali gruppi sono in testa o in coda su ciascuno.

Pagamento con wallet disponibile su https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/comparison/traits. 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 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 --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/comparison/traits' \
  --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.

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[].clusters
array<object> obbligatorio

Ogni cluster con un valore per il trait, dal più alto.
traits[].clusters[].cluster_id
string obbligatorio

Identificatore canonico del cluster di autori.

traits[].clusters[].value
number (double) obbligatorio

Il valore del cluster per il trait, in unit.

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 
{
  "active_clusters": 35,
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "days": 90,
  "hype_cycles": 41,
  "traits": [
    {
      "clusters": [
        {
          "cluster_id": "early_movers",
          "value": 0.0875
        },
        {
          "cluster_id": "smart_money",
          "value": 0.0111
        },
        {
          "cluster_id": "late_movers",
          "value": -0.0917
        }
      ],
      "trait": "earliness",
      "unit": "days"
    },
    {
      "clusters": [
        {
          "cluster_id": "dao_funds",
          "value": 0.9912
        },
        {
          "cluster_id": "smart_money",
          "value": 0.8431
        },
        {
          "cluster_id": "doomers",
          "value": 0.3015
        }
      ],
      "trait": "bullishness",
      "unit": "share"
    }
  ]
}