Metodologia

StockVS è prodotto da un flusso automatizzato: raccolta dei dati, una compilazione notturna, controlli automatizzati e pubblicazione, ciascuna descritta di seguito.

I dati di mercato provengono da Yahoo Finance tramite la libreria open source yfinance: prezzi e volumi giornalieri, dividendi, profili di società e fondi con statistiche principali, conti economici annuali per le azioni e principali partecipazioni per gli ETF. I titoli coperti provengono dai listini pubblici delle borse di Stati Uniti e Canada; i titoli delle notizie provengono dal servizio di notizie Finnhub. Per le ricevute di deposito (ADR), la capitalizzazione di mercato è il prezzo dell'ADR moltiplicato per il numero di azioni equivalenti dell'ADR, come riportato da Yahoo Finance; può differire dal valore della società sul suo mercato nazionale quando l'ADR viene scambiato a premio (ad esempio TSM e SKHY).

Le attività di raccolta scrivono i prezzi e il profilo di ogni titolo, e i titoli di notizie per le azioni, in un database PostgreSQL. Ogni notte una compilazione del sito statico genera tutte le pagine a partire da quel database, e controlli automatizzati ne verificano il risultato; se un controllo non viene superato, non viene caricato nulla e la versione precedente resta online. Una compilazione che supera i controlli viene caricata su un hosting statico dietro la rete di Cloudflare, e viene quindi caricato un campione casuale delle nuove pagine per confermare che rispondano.

I prezzi vengono raccolti in ogni giornata di negoziazione dopo la chiusura del mercato, e la compilazione notturna inizia non appena la raccolta termina, quindi le pagine mostrano normalmente il prezzo di chiusura di quel giorno la stessa sera; le compilazioni del fine settimana usano i dati dell'ultima sessione. I profili aziendali e le statistiche principali vengono aggiornati ogni giorno lavorativo, le partecipazioni degli ETF e gli storici completi dei prezzi degli ETF settimanalmente, e i conti economici di ogni società circa una volta al trimestre, e quelli di una società di nuova quotazione entro la prima settimana. I titoli di notizie delle azioni vengono aggiornati ogni giorno per le società più grandi, ogni pochi giorni per quelle più piccole. Se la raccolta di un giorno lavorativo non riesce, la compilazione di quella notte non viene eseguita, la versione precedente resta online e un monitor genera un avviso.

I rendimenti per periodi mobili, anni di calendario e mesi sono calcolati a partire dalle chiusure giornaliere memorizzate, rettificate da Yahoo Finance per frazionamenti e dividendi al momento in cui ciascuna è stata scaricata; la volatilità è la deviazione standard annualizzata dei rendimenti giornalieri. Capitalizzazione di mercato, indici di valutazione, margini, utile per azione e rendimenti da dividendo sono mostrati come riportati da Yahoo Finance, e un valore fuori da un intervallo plausibile non viene mostrato. Le cifre mantengono la loro valuta di riferimento, dollari statunitensi o canadesi, e non vengono mai convertite; i totali che comprendono entrambe sono indicati per valuta. I confronti con l'industria usano la mediana dell'industria, e le differenze tra percentuali sono espresse in punti percentuali.

L'analisi nelle pagine di azioni ed ETF è assemblata a partire da modelli di frasi predefiniti in ciascuna lingua supportata, completati con i dati del database. Quando i dati mancano, la frase viene omessa invece di lasciare un segnaposto. I modelli descrivono i dati e il loro confronto con le mediane dell'industria, senza valutazioni, raccomandazioni o previsioni. Nessun modello linguistico viene eseguito quando il sito viene generato, e nessun modello scrive testo su una singola azione o un singolo fondo. Le illustrazioni astratte accanto ad alcuni titoli di notizie sono state generate una sola volta da un modello di immagini e non rappresentano le notizie.

Durante la raccolta, i prezzi vengono memorizzati solo per i giorni in cui il mercato del singolo titolo era aperto, un prezzo della giornata in corso solo dopo la chiusura della sessione, e l'aggiornamento giornaliero non può sovrascrivere una chiusura memorizzata con una quotazione in tempo reale. Un nome troncato proveniente dalla fonte dei dati non può sostituire un nome completo già memorizzato, e i titoli che smettono di restituire prezzi vengono segnalati nel rapporto di esecuzione. Sulle pagine, un prezzo non più attuale mostra la data della sua ultima negoziazione, e le società con doppia quotazione vengono contate una sola volta.

Prima di ogni pubblicazione notturna, controlli automatizzati leggono il sito completato, pagina per pagina o a campione. La compilazione deve avere una dimensione vicina a quella dell'ultima versione pubblicata, contenere almeno tante pagine quante ne elencano le sue sitemap, e portare prezzi aggiornati come richiesto dal calendario. I dati strutturati devono essere ben formati, le date dei prezzi devono cadere in giorni di negoziazione e mai nel futuro, ogni pagina deve portare un'unica data dei dati, e conteggi e totali devono coincidere tra le pagine. Nessuna tabella può elencare due volte una società né sommare valute diverse. L'analisi e i riepiloghi degli elenchi devono usare il sistema di scrittura della lingua della pagina.

StockVS non offre quotazioni in tempo reale: i dati sono di fine giornata, e alcune pagine possono restare indietro di una sessione o più quando Yahoo Finance pubblica una chiusura in ritardo o un'esecuzione della raccolta non riesce. Le cifre sono precise solo quanto i dati di Yahoo Finance. Non tutte le metriche finanziarie sono disponibili per ogni azione o ETF. La disponibilità dei dati storici varia in base al ticker. La maggior parte degli storici viene estesa giorno per giorno, quindi una rettifica successiva per frazionamento o dividendo potrebbe non raggiungere i prezzi più vecchi, e i rendimenti a lungo termine possono differire da quelli di altre fonti. I titoli che cessano di essere negoziati mantengono le loro pagine, con l'ultimo prezzo contrassegnato come non più attuale, e le descrizioni aziendali compaiono solo nelle pagine di azioni in inglese.

Gli errori vengono individuati dai controlli automatizzati descritti sopra e dalle revisioni delle pagine pubblicate. Ciascuno viene corretto all'origine, nei dati, in un calcolo o in un modello, e la successiva ricompilazione notturna porta la correzione a tutte le pagine interessate; le correzioni vengono registrate nel sistema interno di tracciamento dei problemi del progetto. Al momento non esiste un canale pubblico per segnalare errori.