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

Sovrapposizione dei cluster

GET /clusters/overlap
GetClusterOverlap

Quali cluster osservano gli stessi asset di questo, e se concordano. overlap_share è quanto dei suoi 50 asset principali è condiviso da un peer; direction_agreement_share è quanto spesso propendono nella stessa direzione; stance_gap è positivo quando questo cluster è il più rialzista.

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/overlap. 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 misurare la focus, contando a ritroso dall'ultimo giorno completo: 7, 30 o 90. I piani gratuiti arrivano fino a 90 giorni; oltre restituisce 403.

Valori consentiti
73090

Default:30

Esempio cURL

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

days
integer obbligatorio

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

peers
array<object> obbligatorio

Ogni altro cluster attivo, dal più sovrapposto.
peers[].agreeing_asset_count
integer obbligatorio

Asset confrontati su cui entrambi i cluster propendono nella stessa direzione rispetto al mercato.

peers[].cluster_id
string obbligatorio

Identificatore canonico del cluster di autori.

peers[].compared_asset_count
integer obbligatorio

Asset condivisi, sull'intera sovrapposizione, su cui entrambi i cluster si discostano di almeno 0,05 dalla posizione del mercato.

peers[].direction_agreement_share
number (double) obbligatorio

Sugli asset condivisi in cui entrambi i cluster si discostano di almeno 0,05 dalla posizione del mercato, la quota in cui propendono nella stessa direzione: agreeing_asset_count ÷ compared_asset_count. Null sotto 3 asset.

peers[].overlap_share
number (double) obbligatorio

Quota del focus set di questo cluster presente anche in quello del peer, da 0 a 1.

peers[].shared_assets
array<object> obbligatorio

Fino a 5 asset presenti in entrambi i focus set, nell'ordine di attenzione di questo cluster.
peers[].shared_assets[].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
peers[].shared_assets[].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.

peers[].shared_assets[].cluster_stance
number (double) obbligatorio

La posizione netta di questo cluster sull'asset, da −1 a +1. Null sotto 3 post rialzisti o ribassisti.

peers[].shared_assets[].market_stance
number (double) obbligatorio

La posizione netta del mercato sull'asset, da −1 a +1: la baseline rispetto a cui si misurano entrambe le inclinazioni. Null sotto 3 post rialzisti o ribassisti.

peers[].shared_assets[].name
string obbligatorio

Nome leggibile.

peers[].shared_assets[].peer_stance
number (double) obbligatorio

La posizione netta del peer sull'asset, da −1 a +1. Null sotto 3 post rialzisti o ribassisti.

peers[].shared_assets[].symbol
string obbligatorio

Ticker o simbolo di mercato visualizzato.

peers[].stance_gap
number (double) obbligatorio

La posizione di questo cluster meno quella del peer, mediata sugli asset condivisi su cui entrambi hanno una posizione, da −2 a +2. Positivo significa che questo cluster è più rialzista. Null sotto 3 asset.

top_asset_count
integer obbligatorio

Dimensione del focus set di ciascun cluster: i suoi asset più discussi, fino a questo numero.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "days": 30,
  "peers": [
    {
      "agreeing_asset_count": 11,
      "cluster_id": "fa_analyst",
      "compared_asset_count": 17,
      "direction_agreement_share": 0.6471,
      "overlap_share": 0.62,
      "shared_assets": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "cluster_stance": 0.62,
          "market_stance": 0.41,
          "name": "NVIDIA Corporation",
          "peer_stance": 0.54,
          "symbol": "NVDA"
        },
        {
          "asset_class": "equity",
          "asset_id": "AMZN",
          "cluster_stance": 0.48,
          "market_stance": 0.3,
          "name": "Amazon.com, Inc.",
          "peer_stance": null,
          "symbol": "AMZN"
        }
      ],
      "stance_gap": 0.0812
    },
    {
      "agreeing_asset_count": 5,
      "cluster_id": "kols",
      "compared_asset_count": 12,
      "direction_agreement_share": 0.4167,
      "overlap_share": 0.46,
      "shared_assets": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "cluster_stance": 0.62,
          "market_stance": 0.41,
          "name": "NVIDIA Corporation",
          "peer_stance": 0.71,
          "symbol": "NVDA"
        },
        {
          "asset_class": "equity",
          "asset_id": "TSLA",
          "cluster_stance": -0.35,
          "market_stance": 0.22,
          "name": "Tesla, Inc.",
          "peer_stance": 0.28,
          "symbol": "TSLA"
        }
      ],
      "stance_gap": -0.1375
    }
  ],
  "top_asset_count": 50
}