Chiamate long/short

GET /calls

GetCalls

Quante chiamate long e short le persone fanno su un asset, o su ogni mercato, nel tempo. Una chiamata afferma che un asset salirà o scenderà, divulga una posizione o dice agli altri di prenderne una; la semplice opinione non conta. Invia clusters per contare le chiamate di un gruppo.

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

hours integer QUERY

Finestra di lookback in ore. I piani gratuiti risalgono fino a 90 giorni; oltre viene restituito 403.

Default:720

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' \
  --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

series

array<object> obbligatorio

Osservazioni ordinate cronologicamente.

series[].long_calls

integer (int64) obbligatorio

Numero di chiamate long nel bucket.

series[].short_calls

integer (int64) obbligatorio

Numero di chiamate short nel bucket.

series[].timestamp

string obbligatorio

Timestamp UTC in formato RFC 3339 per l'osservazione o l'inizio del bucket.

{
  "series": [
    {
      "long_calls": 184,
      "short_calls": 71,
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}