Distribuzione degli esiti delle chiamate

GET /calls/returns
GetCallReturns

Come si sono comportate le chiamate recenti: win rate, rendimento mediano e medio e distribuzione dei rendimenti. Ogni chiamata è valutata sulla variazione di prezzo nelle 24 ore successive, dal punto di vista di chi la effettua, quindi una chiamata short su un calo del 10% vale +10%. Invia clusters per confrontare i gruppi, ad esempio smart_money contro dumb_money.

Regole dei parametri:

  • Invia asset_class e asset_id insieme, oppure nessuno dei due.

Pagamento con wallet disponibile su https://nebula-api.hiddensystems.ai/api/v1/x402/calls/returns. Non sono richiesti un account Nebula o una chiave API; controlla l'offerta di pagamento prima di firmare. Guida al pagamento x402.

Parametri

asset_id string QUERY

Asset ID da /assets o /search, ad esempio NVDA, GLD, SPX o bitcoin. Va inviato con l'asset_class restituito insieme ad esso.

Example:NVDA

asset_class string QUERY

Classe dell'asset indicato da asset_id: equity (azioni ed ETF), commodity, index o crypto. Va inviata l'asset_class restituita da /assets o /search insieme all'asset_id.

Valori consentiti
equitycommodityindexcrypto

Example:equity

resolved_days integer QUERY

Per quanti giorni includere le chiamate risolte: le chiamate il cui traguardo delle 24 ore è caduto entro questo numero di giorni. I piani gratuiti arrivano a 90 giorni; oltre viene restituito 403.

Default:7

clusters array<string> QUERY

Cluster di autori da leggere; ripeti per combinarli, ad esempio clusters=kols&clusters=media. I cluster selezionati vengono sommati e un autore può appartenere a più cluster.

  • Caller: smart_money (i caller con le migliori performance), dumb_money (con le peggiori), top_degens (i migliori sulle crypto a bassa capitalizzazione)
  • Tempismo: early_movers (i primi a parlare di un asset quando l'attenzione sale), late_movers (arrivano al picco o dopo)
  • Builder: developers, founders, team_leaders, project_accounts
  • Istituzioni: vcs, asset_managers, dao_guild_funds, incubators, exchanges
  • Influenza: kols, celebrities, media, marketer, shiller
  • Analisti: ta_analyst, fa_analyst, macro_analyst, onchain_analyst, investigators
  • Trader: position_trader, swing_trader, day_trader
  • Bias: perma_bull, doomer, tribalist
  • Altro: political, nft, bots, automated_ai

Example:smart_money

Esempio cURL

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/calls/returns' \
  --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

average_return_pct
number (double) obbligatorio

Rendimento medio allineato alla direzione su tutte le chiamate risolte, in punti percentuali.

buckets
array<object> obbligatorio

Bucket della distribuzione dei rendimenti in ordine crescente.

buckets[].call_count
integer (int64) obbligatorio

Chiamate risolte in questo bucket di rendimento.

buckets[].capped_total_aligned_return_pct
number (double) obbligatorio

Somma dei rendimenti allineati alla direzione, con ogni call limitata a ±100%, in punti percentuali.

buckets[].label
string obbligatorio

Etichetta leggibile del bucket o dell'indice.

buckets[].lower_bound_pct
number (double) obbligatorio

Limite inferiore di rendimento incluso, in punti percentuali; null per il primo bucket, aperto verso il basso.

buckets[].total_aligned_return_pct
number (double) obbligatorio

Somma dei rendimenti allineati alla direzione in questo bucket, in punti percentuali.

buckets[].upper_bound_pct
number (double) obbligatorio

Limite superiore di rendimento escluso, in punti percentuali; null per l'ultimo bucket, aperto verso l'alto.

losses
integer (int64) obbligatorio

Call risolte con rendimento allineato alla direzione negativo.

median_return_pct
number (double) obbligatorio

Rendimento allineato alla direzione mediano sulle call risolte, in punti percentuali.

resolved_calls
integer (int64) obbligatorio

Numero di call con esito risolto.

resolved_days
integer obbligatorio

Su quanti giorni di call risolte si estendono le statistiche.

win_rate_pct
number (double) obbligatorio

Call risolte vincenti in percentuale, da 0 a 100.

wins
integer (int64) obbligatorio

Call risolte con rendimento allineato alla direzione positivo.

{
  "average_return_pct": 4.1,
  "buckets": [
    {
      "call_count": 91,
      "capped_total_aligned_return_pct": -228,
      "label": "-10% to 0%",
      "lower_bound_pct": -10,
      "total_aligned_return_pct": -342.5,
      "upper_bound_pct": 0
    }
  ],
  "losses": 174,
  "median_return_pct": 2.8,
  "resolved_calls": 412,
  "resolved_days": 7,
  "win_rate_pct": 57.77,
  "wins": 238
}