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

Screener

GET /screener
Screener

Ordina asset o soggetti in base a una misura sulle 24 ore e filtra sugli altri: share, variazione di share, post, post netti rialzisti (rialzisti meno ribassisti; un valore negativo è ribassista) o variazione di prezzo sulle 24 ore. Gli intervalli sono inclusivi e si combinano; i filtri sul prezzo si applicano solo agli asset.

La quota è la frazione di tutti i post nello stesso mercato nello stesso arco di 24 ore (azioni, crypto, oppure persone e argomenti), bot esclusi; con clusters, è la quota di ciò che quei cluster hanno pubblicato.

Regole dei parametri:

  • asset_class si applica solo a kind=asset.
  • Le community di pubblicazione come wallstreetbets sono accettate solo per kind=asset con asset_class equity, commodity o index.
  • Ogni minimo non deve superare il rispettivo massimo.
  • L'ordinamento e gli intervalli di prezzo richiedono kind=asset.

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

Parametri

kind string QUERY

Cosa classificare: asset (azioni, commodity, indici o crypto) oppure subject (persone, account e argomenti). Il valore predefinito è asset.

Valori consentiti
assetsubject

Default:asset

asset_class string QUERY

Con kind=asset, il mercato da classificare: equity (il valore predefinito), commodity, index o crypto.

Valori consentiti
equitycommodityindexcrypto

Default:equity

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
  • Community, in base a dove è stato pubblicato il post: wallstreetbets, reddit

Example:smart_money

sort string QUERY

La misura in base a cui ordinare. Il valore predefinito è share.

Valori consentiti
shareshare_changeshare_change_pctpostsnet_bullish_postsprice_change_24h_pct

Default:share

order string QUERY

desc (il valore predefinito) mette per primi i valori più alti; asc mette per primi i più bassi.

Valori consentiti
descasc

Default:desc

limit integer QUERY

Numero massimo di risultati restituiti.

Default:25

min_share number QUERY

Mantiene i risultati la cui share è almeno questa frazione della conversazione, da 0 a 1.

Example:1

max_share number QUERY

Mantiene i risultati la cui share è al massimo questa frazione, da 0 a 1.

Example:1

min_share_change number QUERY

Mantiene i risultati la cui share è aumentata almeno di questa quantità rispetto alle 24 ore precedenti, come frazione da -1 a 1: 0.01 equivale a un punto percentuale.

Example:1

max_share_change number QUERY

Mantiene i risultati la cui share è cambiata al massimo di questa quantità, come frazione da -1 a 1; i valori negativi selezionano i risultati che perdono share.

Example:1

min_posts integer QUERY

Mantiene i risultati con almeno questo numero di post nelle 24 ore. Il valore predefinito è 5 quando si ordina per price_change_24h_pct.

Example:1

min_net_bullish_posts integer QUERY

Mantiene i risultati con almeno questo numero di post rialzisti in più rispetto a quelli ribassisti; i valori negativi ammettono risultati ribassisti.

Example:1

max_net_bullish_posts integer QUERY

Mantiene i risultati con al massimo questo numero di post rialzisti in più rispetto a quelli ribassisti; i valori negativi selezionano risultati ribassisti.

Example:1

min_price_change_24h_pct number QUERY

Mantiene gli asset la cui variazione di prezzo sulle 24 ore è almeno di questa percentuale.

Example:1

max_price_change_24h_pct number QUERY

Mantiene gli asset la cui variazione di prezzo sulle 24 ore è al massimo di questa percentuale.

Example:1

Esempio cURL

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

Il mercato i cui asset sono stati classificati; assente per i subject.

clusters
array<string> obbligatorio

I cluster di autori i cui post sono stati conteggiati, canonicalizzati; vuoto quando sono stati conteggiati tutti gli autori tranne i bot.

from
string (date-time) obbligatorio

Inizio UTC delle 24 ore classificate. La finestra di confronto è costituita dalle 24 ore precedenti.

kind
string obbligatorio

Che cosa è stato classificato: asset o subject, come richiesto.

Valori consentiti
assetsubject
previous_total_posts
integer (int64) obbligatorio

Tutti i post nella popolazione classificata nelle 24 ore precedenti.

results
array<object> obbligatorio

Risultati classificati, dal migliore al peggiore.
results[].asset_class
string opzionale

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
results[].asset_id
string opzionale

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.

results[].bearish_posts
integer (int64) obbligatorio

Post classificati come bearish.

results[].bullish_posts
integer (int64) obbligatorio

Post classificati come bullish.

results[].kind
string obbligatorio

Che cosa rappresenta il risultato: asset (da interrogare con asset_id e asset_class) o subject (da interrogare con subject_id).

Valori consentiti
assetsubject
results[].name
string obbligatorio

Nome leggibile.

results[].neutral_posts
integer (int64) obbligatorio

Post classificati come neutral.

results[].posts
integer (int64) obbligatorio

I post di questo risultato nelle 24 ore classificate.

results[].previous_posts
integer (int64) obbligatorio

I post di questo risultato nella finestra immediatamente precedente di uguale durata.

results[].price_change_24h_pct
number (double) opzionale

Variazione grezza del prezzo di mercato su 24 ore, in punti percentuali.

results[].share
number (double) obbligatorio

I post di questo risultato come frazione di tutti i post nella popolazione classificata nello stesso intervallo di 24 ore, da 0 a 1.

results[].share_change
number (double) opzionale

Variazione della quota rispetto alla finestra precedente, come frazione decimale: 0,01 equivale a un punto percentuale. Assente solo quando la popolazione non aveva post nella finestra precedente.

results[].share_change_pct
number (double) opzionale

La variazione della quota rispetto alla quota della finestra precedente, in percentuale. Assente quando il risultato non aveva post nella finestra precedente.

results[].subject_id
string opzionale

Identificatore canonico per una persona, un account o un argomento non riconducibile a un asset.

results[].symbol
string opzionale

Ticker o simbolo di mercato visualizzato.

to
string (date-time) obbligatorio

Fine UTC delle 24 ore classificate: il momento in cui è stata calcolata la classifica.

total_posts
integer (int64) obbligatorio

Tutti i post nella popolazione classificata nelle 24 ore: il denominatore della quota.

{
  "asset_class": "equity",
  "clusters": [],
  "from": "2026-08-06T15:00:00Z",
  "kind": "asset",
  "previous_total_posts": 17205,
  "results": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "bearish_posts": 61,
      "bullish_posts": 214,
      "kind": "asset",
      "name": "NVIDIA Corporation",
      "neutral_posts": 111,
      "posts": 386,
      "previous_posts": 273,
      "price_change_24h_pct": -2.48,
      "share": 0.025255,
      "share_change": 0.009388,
      "share_change_pct": 59.16,
      "symbol": "NVDA"
    },
    {
      "asset_class": "equity",
      "asset_id": "AMZN",
      "bearish_posts": 30,
      "bullish_posts": 92,
      "kind": "asset",
      "name": "Amazon.com, Inc.",
      "neutral_posts": 63,
      "posts": 185,
      "previous_posts": 165,
      "price_change_24h_pct": -0.32,
      "share": 0.012104,
      "share_change": 0.002516,
      "share_change_pct": 26.24,
      "symbol": "AMZN"
    }
  ],
  "to": "2026-08-07T15:00:00Z",
  "total_posts": 15284
}