Come monitorare i prezzi crypto di CoinGecko in Google Sheets
1. Definisci cosa vuoi monitorare prima di creare il foglio
Prima di scrivere una formula, prepara una breve specifica. Elenca le criptovalute, le valute di quotazione, la frequenza degli aggiornamenti e indica se ti servono i prezzi correnti, i dati storici o entrambi. Un foglio per seguire BTC ed ETH in USD ha uno scopo diverso da uno che registra un portafoglio misto in EUR e GBP.
Per la prima versione, mantieni il progetto semplice. Per esempio, monitora tre criptovalute in un’unica valuta e aggiorna i dati una volta all’ora. Aggiungi altre righe o valute solo dopo aver verificato che i risultati corrispondano a quelli mostrati da CoinGecko. Il numero di richieste necessario e le opzioni di aggiornamento disponibili dipendono dal metodo di accesso scelto e dalle condizioni del tuo account: controlla i limiti aggiornati prima di impostare una pianificazione.
Stabilisci cosa intendi per «prezzo» nel foglio. Una quotazione corrente è un valore riferito a un preciso momento, non il prezzo garantito a cui verrà eseguito un ordine. Se vuoi confrontarla con un’operazione, registra l’ora della quotazione e non considerare in tempo reale un dato ritardato o memorizzato nella cache.
2. Scegli il metodo di accesso all’API più adatto alla tua configurazione
Esistono tre modi comuni per collegare i dati di CoinGecko a Google Sheets: un componente aggiuntivo per Sheets, un semplice script Apps Script oppure un connettore di terze parti. Per chi non ha competenze tecniche, un componente aggiuntivo è spesso la soluzione più rapida. Uno script offre maggiore controllo sul formato delle richieste e sulla modalità di archiviazione dei dati. Un connettore riduce la necessità di scrivere codice, ma aggiunge un altro servizio da controllare se gli aggiornamenti smettono di funzionare. Scegliere il metodo dipende anche da quanto controllo vuoi avere su come importare prezzi crypto da CoinGecko su Google Sheets.
Prima di scegliere, confronta i requisiti di autenticazione, i limiti di richieste e la manutenzione necessaria. Verifica se il metodo richiede una chiave API, dove viene archiviata, quale frequenza di aggiornamento supporta e se i relativi limiti sono compatibili con il numero di criptovalute e valute che intendi monitorare. Le opzioni e le condizioni di accesso all’API di CoinGecko possono cambiare: consulta la documentazione per conoscere i requisiti aggiornati.
Se usi Apps Script, apri l’editor di script del foglio e crea una funzione che richieda i dati a CoinGecko, analizzi la risposta e inserisca i campi selezionati in un foglio. Uno script semplice è più facile da correggere se svolge un’unica funzione e restituisce messaggi di errore chiari. Non inserire una chiave API privata in una cella visibile a chiunque possa consultare il foglio.
Se stai ancora valutando gli strumenti, la guida su come scegliere il miglior exchange di criptovalute tratta una decisione diversa: scegliere una piattaforma di trading, non una fonte di dati. Tenere separate queste due scelte evita di confondere un flusso di dati API con un account di exchange.
3. Crea una tabella di riferimento per criptovalute e valute
Nelle richieste usa gli ID delle criptovalute di CoinGecko, non soltanto i ticker. Ticker identici possono appartenere a progetti diversi, mentre un ID consente all’API di individuare un asset specifico. Crea una scheda chiamata “Lookup” con colonne per nome visualizzato, ID CoinGecko, ticker e valuta di destinazione.
| Nome visualizzato | ID CoinGecko | Ticker | Valuta |
|---|---|---|---|
| Bitcoin | bitcoin | BTC | usd |
| Ethereum | ethereum | ETH | usd |
| Asset di esempio | [verifica l’ID] | [verifica il ticker] | eur |
Le prime due righe mostrano il tipo di identificatore da registrare; verifica ogni ID su CoinGecko prima di usarlo. Il ticker è utile come etichetta, ma non deve sostituire l’ID nella richiesta. È particolarmente importante quando il portafoglio include un piccolo token con un simbolo simile a quello di un altro progetto.
Inserisci i codici valuta in un formato coerente, per esempio usd o eur in minuscolo, se è questo il formato previsto dall’endpoint scelto. In Google Sheets puoi applicare una regola di convalida per limitare la colonna delle valute a quelle supportate dalla tua configurazione. In questo modo eviti che un errore di battitura, come usdd, venga inviato all’API.
4. Recupera i prezzi correnti in una tabella ordinata
Tieni i dati grezzi restituiti dall’API separati dal foglio usato per consultare i prezzi. Una scheda “Raw” può contenere la risposta o gli ultimi valori importati; una scheda “Prices” può mostrare nome della criptovaluta, ticker, valuta, prezzo e timestamp. Questa separazione permette di modificare la formattazione più facilmente, senza rischiare di compromettere la logica delle richieste.
In genere, una richiesta di prezzi correnti invia all’endpoint dei prezzi di CoinGecko gli ID selezionati e la valuta di quotazione. URL, parametri, metodo di autenticazione e campi restituiti dipendono dal prodotto API e dal metodo di accesso: consulta la documentazione di CoinGecko per i dettagli sugli endpoint. Nella tabella risultante, associa ogni valore restituito al relativo ID, senza dare per scontato che l’ordine della risposta corrisponda sempre a quello delle righe inserite.
Per esempio, la tabella visibile potrebbe mostrare «Bitcoin | BTC | USD | prezzo | aggiornato alle». Formatta la colonna dei prezzi come numero, con un numero di decimali adeguato, ma conserva precisione sufficiente per gli asset monitorati. Arrotondare il valore visualizzato è una scelta di presentazione; arrotondare quello archiviato può falsare i calcoli successivi.
Chi vuole capire come monitorare i prezzi delle criptovalute in Google Sheets con l’API CoinGecko dovrebbe partire da una criptovaluta e una valuta, quindi verificare che ID, valuta e quotazione restituiti corrispondano alla fonte. Questo approccio permette di monitorare criptovalute in Google Sheets con API verificando ogni passaggio prima di ampliare la tabella di riferimento e provare nuove righe. Creare subito una dashboard ricca di funzioni può essere più entusiasmante, ma verificare prima gli ID aiuta a individuare eventuali errori.
Usa le formule per eseguire calcoli, non per nascondere i dati mancanti. Se una richiesta non va a buon fine, mostra un avviso chiaro come «Errore nella richiesta» oppure lascia visibile lo stato di errore, invece di visualizzare uno zero come se l’asset avesse perso tutto il suo valore. Uno zero può influire sui totali del portafoglio e portare a decisioni che non hanno nulla a che fare con il mercato.
5. Pianifica gli aggiornamenti e gestisci i limiti delle richieste
L’aggiornamento automatico è utile solo se la frequenza impostata è consentita dal tuo accesso all’API. I controlli di aggiornamento dei componenti aggiuntivi, i trigger di Apps Script e le pianificazioni dei connettori funzionano in modo diverso. Prima di impostare una frequenza, verifica i limiti aggiornati e le regole di aggiornamento del metodo scelto: i limiti esatti possono variare in base al piano e cambiare nel tempo.
Inizia con una pianificazione prudente e poche richieste. Se monitori cinque asset, evita di inviare una richiesta distinta per ogni cella quando una sola può restituire tutti i valori necessari. Ridurre il numero di chiamate può semplificare la gestione del foglio, ma verifica che l’endpoint supporti gli ID e le valute che invii insieme.
Prevedi possibili problemi: l’API può restituire un errore, il servizio può essere indisponibile oppure potresti raggiungere il limite di richieste. Mostra l’ora dell’ultimo aggiornamento riuscito e non sostituire i dati validi precedenti con una risposta vuota, a meno che tu non voglia cancellarli. Una quotazione non aggiornata resta tale: segnalala invece di presentarla come corrente.
I trigger di Apps Script possono essere eseguiti secondo una pianificazione, ma sono soggetti ai limiti di esecuzione e ai requisiti di autorizzazione di Google. Dopo la configurazione, controlla lo stato dei trigger e consulta il registro delle esecuzioni se gli aggiornamenti si interrompono. I limiti di Google e quelli di CoinGecko sono distinti: rispettare gli uni non garantisce che tutte le richieste vengano accettate dall’altro servizio. Se il foglio serve soprattutto ad aggiornare prezzi Bitcoin ed Ethereum in Google Sheets, verifica con attenzione che la pianificazione sia compatibile con i limiti di entrambi i servizi.
6. Aggiungi i timestamp e conserva le rilevazioni dei prezzi
Una tabella che sostituisce il prezzo di ieri con quello di oggi non permette di vedere cosa è cambiato. Aggiungi una scheda “History” in cui registrare una riga per ogni criptovaluta e aggiornamento, con colonne per timestamp, ID, valuta e prezzo. Salva ogni risposta riuscita su una nuova riga anziché sovrascrivere i dati precedenti.
Per esempio, una rilevazione potrebbe apparire così: «2026-11-12 10:00 | bitcoin | usd | [valore restituito]». Usa l’ora effettivamente riportata dalla connessione o dallo script e specifica se si tratta dell’ora UTC o locale. Il prezzo visualizzato deve essere associato al timestamp dello stesso aggiornamento, non all’ora dell’ultima apertura del foglio.
Decidi per quanto tempo conservare i dati prima che la scheda dello storico diventi troppo grande. In base allo scopo e ai limiti delle richieste, puoi mantenere una rilevazione giornaliera per un monitoraggio personale di lungo periodo oppure registrare i dati più spesso per un controllo a breve termine. Non presumere che la risposta dell’API includa dati storici solo perché il foglio ha accumulato diverse rilevazioni: sono due fonti di dati distinte.
Con righe datate puoi calcolare la variazione tra due rilevazioni, a condizione che ID e valuta di quotazione coincidano. Confrontare una riga BTC/USD con una BTC/EUR significa considerare anche l’effetto del cambio, oltre alla variazione del prezzo: prima di creare un grafico, identifica chiaramente le due serie.
7. Convalida i risultati e mantieni il collegamento
Prima di affidarti a una dashboard, esegui alcuni controlli. Verifica che l’ID sia corretto, che l’etichetta della valuta corrisponda a quella della richiesta, che il prezzo restituito sia numerico e che il timestamp si riferisca a quell’aggiornamento. Confronta poi un risultato di esempio con il sito di CoinGecko, tenendo presente che le due visualizzazioni potrebbero aggiornarsi in momenti diversi.
Durante i test, lascia visibili le risposte di errore. Una richiesta non riuscita può indicare una chiave non valida, un parametro formattato male, un problema con i limiti o un disservizio temporaneo. Registra il messaggio e l’ora in cui si è verificato: modificare più impostazioni contemporaneamente rende più difficile individuare la causa. Se l’errore si ripete, controlla la documentazione dell’endpoint e il tuo piano di accesso.
Annota chi è responsabile dello script o del connettore, dove sono conservate le credenziali e quali schede del foglio possono essere modificate senza rischi. Se qualcuno rinomina una colonna prevista dallo script, il collegamento può interrompersi anche se CoinGecko non è cambiato. Proteggere la tabella di riferimento e le schede con i dati grezzi da modifiche accidentali può evitare questo tipo di problema.
Quando CoinGecko modifica le condizioni dell’API, l’autenticazione, gli endpoint disponibili o i limiti, ricontrolla la configurazione e verifica i dettagli aggiornati prima di intervenire su un foglio in uso. Dopo ogni modifica, basta in genere provare una sola criptovaluta per individuare un parametro errato prima che interessi tutte le righe. Mantieni questo test nel file, così anche chi lo userà in seguito potrà ripeterlo.