API pubblica di Nebula
Indice di riferimento
Ogni endpoint elencato di seguito ha una pagina HTML stabile e una versione Markdown gemella. Questo indice è statico, indicizzabile e sicuro da leggere per gli agenti AI senza eseguire JavaScript.
Discovery
3 endpoint/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.
/top-momentum
Top momentum
Gli asset o i soggetti che guadagnano share di conversazione più rapidamente: la share di queste 24 ore meno quella delle 24 ore precedenti. share_change_pct è la stessa variazione rispetto alla share di ieri.
/top-trending
Top trending
Gli asset o soggetti con la quota maggiore della conversazione nelle ultime 24 ore, in ordine decrescente, con la variazione rispetto alle 24 ore precedenti.
Lookup
3 endpoint/assets
Da testo ad asset ID
Cerca azioni (titoli ed ETF), materie prime, indici e criptovalute per nome o ticker e ottieni asset_id e asset_class accettati da ogni endpoint degli asset. Invia query per cercare, asset_id per una corrispondenza esatta, oppure nessuno dei due per sfogliare gli asset più attivi.
/search
Ricerca
Una sola ricerca su asset, persone, account e argomenti. Il campo kind di ogni risultato indica di che tipo si tratta: gli asset riportano asset_id e asset_class, i soggetti riportano subject_id. Invia kind per cercare solo da un lato.
/subjects
Da testo a subject ID
Cerca persone, account e argomenti, inclusi quelli AI, e ottieni subject_id accettati dagli endpoint dei soggetti. Gli asset non sono inclusi; usa /assets o /search per quelli.
Social & Sentiment
6 endpoint/emotions
Distribuzione delle emozioni
Quali delle 15 emozioni dominano la conversazione su un asset o un soggetto nel tempo. proportion è la share di ciascuna emozione rispetto alle emozioni del bucket (la loro somma è 1); post_count conta i post che la mostrano. Un post può mostrarne diverse.
/mindshare
Mindshare
La quota di conversazione di un asset o di un soggetto: i suoi post nelle ultime 24 ore come frazione di tutti i post nel suo mercato (azioni, crypto, oppure persone e argomenti), da 0 a 1. Invia clusters per misurare la quota all'interno di uno o più gruppi di autori.
/related-subjects
Soggetti correlati
Le persone, gli account e gli argomenti di cui si parla più spesso negli stessi post di un asset o di un soggetto. share indica i post condivisi come frazione dei post dell'anchor; i campi di sentiment sono il sentiment dell'anchor all'interno di quei post condivisi.
/sentiment
Sentiment
Quanto è rialzista o ribassista la conversazione su un asset, un soggetto o un intero mercato, nel tempo. sentiment_signal è il numero di post rialzisti meno quelli ribassisti nelle ultime 24 ore, con i post recenti ponderati maggiormente: un valore positivo indica un sentiment netto rialzista. Cresce con il volume, quindi confronta un asset con il suo stesso storico.
/sentiment/timeframes
Sentiment per intervallo temporale
Sentiment suddiviso per l'orizzonte temporale di cui si parla: breve termine (fino a una settimana), medio termine (da settimane a mesi) e lungo termine (tre mesi o più), ciascuno sulla scala di /sentiment. Distingue una massa che è ribassista questa settimana ma rialzista sull'anno da una che è ribassista su tutto l'arco temporale.
/social-momentum
Momentum social
Post, autori unici e sentiment all'interno di ciascun cluster di autori, affiancati, per un asset, un soggetto o un intero mercato: quali gruppi guidano la conversazione e come il loro tono differisce. I cluster si sovrappongono, quindi non sommarli. Invia clusters per restituire solo quelli che indichi.
Previsioni
3 endpoint/forecasts/assets
Asset prevedibili
Tutti gli asset con una previsione al momento. L'elenco copre sia /forecasts/mindshare sia /forecasts/sentiment, che prevedono gli stessi asset: passa asset_id e asset_class di un asset a uno dei due. Azioni, materie prime e indici vengono prima, poi le criptovalute, dal più discusso. L'elenco si aggiorna ogni cinque minuti.
/forecasts/mindshare
Previsione di mindshare
Dove è probabile che si trovi il mindshare di un asset nelle prossime 72 ore, come intervallo di esiti con le relative probabilità. series fornisce la distribuzione ogni 4 ore; chance_higher_72h e likely_low_share a likely_high_share riassumono dove si colloca; takeoff_chance_72h è la probabilità di un'improvvisa impennata dell'attenzione.
/forecasts/sentiment
Previsione del sentiment
Dove è probabile che vada il sentiment di un asset nelle prossime 72 ore, come intervallo di esiti con le relative probabilità. series fornisce, ogni 4 ore, i post bullish, bearish, neutral e totali attesi in quel passo e il sentiment_signal alla sua fine, sulla scala /sentiment. chance_higher_24h e chance_higher_72h forniscono la probabilità che il segnale chiuda sopra current_sentiment_signal; i loro flag _confident indicano quando tale probabilità pende chiaramente da una parte.
Sentiment di mercato
7 endpoint/calls
Chiamate long/short
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.
/calls/returns
Distribuzione degli esiti delle chiamate
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.
/conviction-index
Indice di convinzione
Una lettura da 0 a 100 di quanto le persone credono in un asset. Combina il rapporto bullish dell'asset rispetto a quello del mercato, quanto il sentiment tiene mentre il prezzo scende, l'ultimo rapporto bullish e le emozioni di tipo greed. Un valore intorno a 50 è tipico; confronta un asset con la sua stessa storia.
/fear-greed-index
Indice Fear and Greed
Una lettura giornaliera da 0 a 100 di paura e avidità per un asset, che combina prezzo, volatilità, momentum, volume di scambi e umore social: fino a 20 Extreme Fear, 40 Fear, 60 Neutral, 80 Greed, oltre 80 Extreme Greed. metadata elenca i componenti.
/price-levels
Livelli di prezzo menzionati sui social
I prezzi che le persone indicano per un asset (target, supporti e livelli quotati), raggruppati per prezzo e tempo: dove la folla ancora le proprie aspettative. mentions conta i livelli dichiarati, quindi un singolo post può aggiungerne diversi.
/social-volume-index
Volume social vs volume di trading
Se per un asset il trading o la conversazione sono più caldi, ciascuno misurato rispetto alla propria norma a 90 giorni. volume_index va da 0 a 100: 50 significa che entrambi sono ugualmente elevati, sopra 50 il trading è in vantaggio sulla conversazione, sotto 50 la conversazione è in vantaggio sul trading. Su base giornaliera, fino a 90 giorni.
/social-volume-profile
Profilo del volume social
Un profilo di volume fatto di post invece che di scambi: dove, sull'asse dei prezzi, si è svolta la conversazione su un asset. Ogni bin ha il numero di post, le quote bullish e bearish e directional_imbalance da −1 (tutto bearish) a +1 (tutto bullish); significance_score ordina i bin da 0 a 1 in base a post, equilibrio, quanto spesso il prezzo li rivisita e compressione; il point of control è il bin più attivo. Invia clusters per profilare un singolo gruppo.
Market Data
1 endpointIntelligence
3 endpoint/calendar-events
Eventi del calendario
Eventi di mercato futuri e passati (utili, dati economici, IPO, quotazioni, votazioni, udienze), a livello globale o per un singolo asset o soggetto, con tipo, stato, importanza da 1 a 3 e le entità coinvolte. Per impostazione predefinita parte da oggi in avanti, dal più vicino; invia min_importance_score=2 per quelli rilevanti.
/insights
Intelligence
Notizie brevi su ciò che accade sui mercati, a livello globale o per un singolo asset o soggetto, ciascuna con titolo, riassunto, sentiment (−1, 0 o +1), tag, importanza da 1 a 3 e le entità coinvolte. Prima le più recenti per aggiornamento; invia order_by=start_time_desc per avere prima gli eventi più recenti.
/insights/attention
Attenzione degli insight
La conversazione attorno a un elemento di intelligence: la finestra di attenzione di 24 ore, i conteggi di autori e sentiment, i bucket orari, la composizione dei cluster, i vettori di impatto e le reazioni di prezzo per ogni entità collegata con prezzo disponibile. Usalo dopo /insights quando un lettore apre un elemento e necessita del contesto completo a livello di drawer.
Cluster
10 endpoint/clusters
Cluster di autori
Attività e sentiment di ogni cluster di autori in un mercato: post, autori unici, variazione rispetto alla finestra precedente e sentiment netto (post rialzisti meno ribassisti) con una serie oraria. asset_class è equity (il valore predefinito) o crypto.
/clusters/comparison
Confronto tra cluster
Ogni cluster di autori a confronto sulla finestra: post e relativa variazione, quanto è rialzista rispetto al mercato (cluster_bullish_share contro market_bullish_share), l'attività su cui si è orientato di più negli ultimi 7 giorni (trending_asset) e i post giornalieri.
/clusters/comparison/divisive-assets
Asset divisivi
Gli asset ampiamente discussi su cui i cluster sono più in disaccordo. minority_share è la quota dei cluster dello schieramento più piccolo che pendono chiaramente verso il rialzo o il ribasso, quindi 0,5 indica una divisione paritaria. Misura una conversazione divisa, non un movimento imminente.
/clusters/comparison/hype-cycles
Arrivi del ciclo di hype
I maggiori cicli di hype della finestra e l'ordine in cui i cluster sono arrivati in ciascuno, rispetto all'ora di picco del mercato, con i post orari del mercato intorno al picco.
/clusters/comparison/traits
Confronto dei tratti dei cluster
Ogni trait di /clusters/profile su tutti i cluster, dal valore più alto, per vedere quali gruppi sono in testa o in coda su ciascuno.
/clusters/hype-cycles
Cicli di hype dei cluster
Quanto in anticipo un cluster arriva sui cicli di hype rispetto al mercato. curve è la quota cumulativa dei post di ciascuna parte da 7 giorni prima di un picco a 7 giorni dopo, quindi la linea più a sinistra è la più anticipata; lead_days è il lead del cluster (positivo significa in anticipo), e clusters classifica il lead di ogni cluster.
/clusters/overlap
Sovrapposizione dei cluster
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.
/clusters/profile
Profilo del cluster
I trait comportamentali di un cluster, ciascuno classificato rispetto a ogni altro cluster (rank 1 è il più alto):
/clusters/rotation
Rotazione dei cluster
Dove si sta spostando l'attenzione di un cluster: gli asset che guadagnano e perdono quota dei suoi post rispetto alla finestra precedente, in punti base, e come i suoi post si distribuiscono tra mercati, persone ed eventi.
/clusters/stances
Posizioni dei cluster
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.