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

Posizioni dei cluster

GET /clusters/stances
GetClusterStances

La posizione di un cluster sui suoi asset più discussi accanto a quella del mercato, da −1 (tutti ribassisti) a +1 (tutti rialzisti). contrarian_share indica quanto spesso tende nella direzione opposta al mercato, con la media degli altri cluster per confronto.

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/stances. 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 le posizioni, 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 asset restituiti.

Default:30

Esempio cURL

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

assets
array<object> obbligatorio

Gli asset idonei più discussi del cluster (3 o più post del cluster, 20 o più post del mercato), fino a limit.
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
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.

assets[].cluster_posts
integer (int64) obbligatorio

I post del cluster sull'asset nella finestra.

assets[].cluster_stance
number (double) obbligatorio

La posizione netta del cluster sull'asset nella finestra: post (rialzisti − ribassisti) / (rialzisti + ribassisti), da −1 (tutti ribassisti) a +1 (tutti rialzisti).

assets[].market_stance
number (double) obbligatorio

La posizione netta del mercato sullo stesso asset nella stessa finestra, sulla stessa scala da −1 a +1, da tutti gli autori tranne i bot.

assets[].name
string obbligatorio

Nome leggibile.

assets[].symbol
string obbligatorio

Ticker o simbolo di mercato visualizzato.

cluster_id
string obbligatorio

Il cluster analizzato, come suo cluster_id canonico.

contrarian_share
number (double) obbligatorio

Quota di asset idonei su cui il cluster e il mercato tendono in direzioni opposte, entrambi ad almeno 0,1 dalla neutralità. Null con meno di 5 asset.

days
integer obbligatorio

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

peer_average_contrarian_share
number (double) obbligatorio

contrarian_share mediata sugli altri cluster; null quando nessuno ne ha una.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "assets": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "cluster_posts": 214,
      "cluster_stance": 0.62,
      "market_stance": 0.41,
      "name": "NVIDIA Corporation",
      "symbol": "NVDA"
    },
    {
      "asset_class": "equity",
      "asset_id": "TSLA",
      "cluster_posts": 137,
      "cluster_stance": -0.35,
      "market_stance": 0.22,
      "name": "Tesla, Inc.",
      "symbol": "TSLA"
    },
    {
      "asset_class": "equity",
      "asset_id": "AMZN",
      "cluster_posts": 96,
      "cluster_stance": 0.48,
      "market_stance": 0.3,
      "name": "Amazon.com, Inc.",
      "symbol": "AMZN"
    }
  ],
  "cluster_id": "smart_money",
  "contrarian_share": 0.1875,
  "days": 30,
  "peer_average_contrarian_share": 0.1123
}