API CoinGecko su ESP32: limiti gratuiti e polling
Il piano Demo gratis di CoinGecko: 100 chiamate al minuto e 10.000 al mese. Ogni quanto interrogarlo con un ESP32, come mandare la key e cosa vuol dire 429.
- Autore
Mauro Brambilla- Pubblicato
- Tempo di lettura
- 7 min
- Categoria
- Guide

In breve
A novembre 2026 il piano Demo gratuito di CoinGecko offre 100 chiamate al minuto e 10.000 al mese. Un ESP32 che interroga l'API ogni 6 minuti ne usa circa 7.200 in 30 giorni: un dispositivo ci sta.
L'API di CoinGecko è gratuita per i progetti hobby: il piano Demo costa 0 $, non richiede la carta di credito e, a novembre 2026, permette 100 chiamate al minuto e 10.000 al mese. Un ESP32 che interroga l'API una volta ogni 6 minuti fa circa 7.200 chiamate in 30 giorni, quindi una scheda sta sotto il limite.
Magari stai per flashare un ticker e ti chiedi ogni quanto puoi chiedere un prezzo prima che CoinGecko ti tagli fuori. In questa guida facciamo il calcolo del polling, leggiamo il vero firmware del Gizmo Ticker per vedere come invia la key e come pianifica le chiamate, e guardiamo cosa succede con un 429. I numeri vengono dalle pagine dei prezzi e della documentazione di CoinGecko, le tempistiche dal sorgente del firmware.
Quali sono i limiti del piano Demo di CoinGecko?
Il piano Demo è il livello gratuito di CoinGecko: una key che richiedi a CoinGecko, con un rate limit al minuto e un budget mensile di chiamate. A novembre 2026, la pagina dei prezzi e la pagina su errori e rate limit dicono questo:
| Voce | Piano Demo (gratuito) | API pubblica senza key |
|---|---|---|
| Prezzo | 0 $ al mese, senza carta di credito | Gratis |
| Rate limit | 100 chiamate al minuto | Circa 5 chiamate al minuto, basate sull'IP e condivise |
| Budget mensile | 10.000 chiamate (10k crediti) | Non indicato |
| Costo di una chiamata | 1 chiamata = 1 credito | Non applicabile |
| Attribuzione | Obbligatoria | Obbligatoria |
| Licenza commerciale | Non indicata nella pagina dei prezzi | Non inclusa; CoinGecko rimanda a un piano a pagamento |
| Uso in produzione | Pensato per progetti personali | Sconsigliato |
La colonna senza key viene dalla pagina sull'API pubblica senza key di CoinGecko. Dice che il limite è condiviso da tutti quelli che usano lo stesso IP, che il limite reale varia con il carico dei server e che non è consigliata per gli ambienti di produzione. Un ticker che resta acceso tutto il giorno è più vicino alla produzione che a una prova al volo, quindi usa una key Demo.
Molti vecchi articoli citano 30 chiamate al minuto per il piano gratuito. Non sono riuscito a verificarlo su una copia archiviata di una pagina di CoinGecko, quindi in questo articolo uso solo le cifre che si trovano oggi sulle sue pagine. Ricontrollale prima di progettare qualcosa attorno a un limite.
Una cosa che non sono riuscito a confermare: la pagina dei prezzi non dice cosa succede nel piano Demo quando le 10.000 chiamate finiscono. Il testo sugli extra riguarda solo i piani a pagamento. Meglio restare sotto il limite che andare a provare.
Quante chiamate al mese usa un ESP32?
Un mese da 30 giorni ha 43.200 minuti. Ogni richiesta è una chiamata, quindi:
chiamate al mese = 43.200 ÷ intervallo in minuti
Con questa formula ottieni il budget per qualsiasi intervallo. Il limite è 10.000, quindi l'intervallo minimo sicuro per un dispositivo è 43.200 ÷ 10.000 = 4,32 minuti. Un mese da 31 giorni alza il totale di circa il 3% (44.640 minuti), e il limite sale a circa 4,5 minuti. In pratica, 5 minuti è il minimo se vuoi un po' di margine.

| Intervallo di polling (min) | Chiamate all'ora | Chiamate in 30 giorni | Sotto il limite di 10.000? |
|---|---|---|---|
| 1 | 60 | 43.200 | No |
| 2 | 30 | 21.600 | No |
| 4 | 15 | 10.800 | No |
| 5 | 12 | 8.640 | Sì |
| 6 (Gizmo Ticker) | 10 | 7.200 | Sì |
| 10 | 6 | 4.320 | Sì |
| 15 | 4 | 2.880 | Sì |
Nota che il limite al minuto qui non conta mai. Con una chiamata ogni 6 minuti usi circa lo 0,2% delle 100 chiamate al minuto. A limitare un dispositivo è il budget mensile, e lo fa senza sconti.
Come interroga CoinGecko il Gizmo Ticker?
Il ticker interroga l'API una volta ogni 6 minuti. In market_refresh.h la costante MARKET_REFRESH_INTERVAL_MS vale 360000, e una chiamata fallita viene ripetuta dopo MARKET_RETRY_INTERVAL_MS, cioè 30000 (30 secondi). La logica di pianificazione sta in market_refresh.cpp.

Perché 6 minuti? Il repository non ne riporta il motivo, quindi non me lo invento. Quello che mostrano i conti è che 6 minuti lasciano circa 2.800 chiamate di margine su 10.000 in un mese da 30 giorni (circa 2.560 in un mese da 31). Quel margine serve a tutto ciò che non è un polling programmato:
- Una richiesta subito dopo l'avvio, perché la pianificazione parte con una richiesta già in attesa.
- Una richiesta dopo che salvi una nuova API key o cambi la moneta nella web app.
- I nuovi tentativi ogni 30 secondi finché una chiamata continua a fallire.

Quando i dati invecchiano, il firmware te lo dice. Se passano 12 minuti (MARKET_STALE_AFTER_MS, il doppio dell'intervallo di aggiornamento) senza un successo, la matrice apre ogni ciclo con Prices from N min ago. e l'ultimo errore. Per la costruzione completa, vedi come costruire un crypto ticker con ESP32 e MAX7219.
Come si invia la key Demo da un ESP32?
La documentazione sull'autenticazione Demo di CoinGecko offre due opzioni: l'header x-cg-demo-api-key (consigliato) oppure il parametro x_cg_demo_api_key nell'URL. L'URL di base per una key Demo è https://api.coingecko.com/api/v3/. Il firmware in api.cpp usa l'header:
const char marketApiUrlTemplate[] = "https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&ids=%s&price_change_percentage=24h";
const char apiKeyHeaderName[] = "x-cg-demo-api-key";
...
http.setTimeout(5000);
http.addHeader("Accept", "application/json");
http.addHeader(apiKeyHeaderName, getDeviceConfig().apiKey);
const int httpCode = http.GET();
if (httpCode != HTTP_CODE_OK) {
http.end();
return false;
}L'header tiene inoltre la key fuori dall'URL della richiesta, che il firmware stampa nel log seriale (Requesting URL: ...). Questo è un mio ragionamento sull'header, non un'affermazione di CoinGecko. Ogni poll è una sola richiesta /coins/markets per una sola moneta, ed è per questo che un poll costa una chiamata. Il firmware chiede inoltre solo i campi che mostra, tramite un filtro ArduinoJson, per risparmiare memoria.
La key non sta mai nel codice. La incolli nella pagina API Key della web app della scheda e viene salvata sulla scheda in un buffer da 35 byte, quindi al massimo 34 caratteri. Senza key il firmware non chiama proprio CoinGecko e fa scorrere API key is not present.. Per inserirla devi prima collegare la scheda al Wi-Fi: il confronto tra i metodi di provisioning Wi-Fi spiega come funziona l'hotspot di configurazione.
Prima di festeggiare, prova la key da un computer:
curl -s -o /dev/null -w "%{http_code}\n" -H "x-cg-demo-api-key: YOUR_KEY" "https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&ids=bitcoin"Un 200 vuol dire che la key funziona. Secondo l'elenco errori di CoinGecko, un 401 indica una key mancante o non valida, e il codice errore 10011 significa che hai mandato una key Demo all'host sbagliato.
Cosa succede quando l'ESP32 riceve un HTTP 429?
HTTP 429 è "Too Many Requests": hai superato il rate limit. CoinGecko conta ogni richiesta nel limite, comprese quelle che restituiscono errori 4xx e 5xx, quindi gli errori non fanno sconti a un dispositivo che continua a fallire. La sua documentazione suggerisce di ridurre la frequenza delle chiamate o di passare a un piano superiore.
E il ticker cosa fa? Tutto ciò che non è un 200 viene trattato allo stesso modo: fetchMarketData restituisce false, la pianificazione sceglie il nuovo tentativo dopo 30 secondi e la matrice continua a mostrare gli ultimi dati validi. Non c'è un caso speciale per il 429 e non c'è backoff, e il firmware non legge nessun header sul rate limit. Neanche nella pagina errori di CoinGecko ho trovato descritti Retry-After o header sul rate limit, quindi non so dirti cosa mandi il server.
È un problema? Con un solo dispositivo, quasi mai. Un nuovo tentativo fisso ogni 30 secondi sono 2 chiamate al minuto, ben sotto 100. Il rischio è un altro: durante un lungo disservizio, da una parte o dall'altra, quei tentativi si accumulano. Un'ora di fallimenti fa circa 120 chiamate, oltre l'1% del budget mensile. Se modifichi il firmware, la scelta sensata è un backoff esponenziale, che CoinGecko stessa consiglia per l'API senza key. Per il piano Pro è documentato che una chiamata fallita non consuma un credito mensile (lo dice la pagina di autenticazione Pro), ma per il Demo no, quindi non ci farei affidamento.
Se vedi un 429 su un ticker vero, cambia una cosa alla volta:
- Controlla quanti dispositivi usano la key. La quota appartiene alla key, quindi due schede che interrogano l'API ogni 6 minuti fanno circa 14.400 chiamate in 30 giorni.
- Controlla che nient'altro usi la key, come uno script o un secondo progetto.
- Allunga l'intervallo di polling. A 10 minuti, una key può alimentare 2 schede (8.640 chiamate).
Se la key non è tua, chiedi prima al proprietario.
Quali alternative ci sono quando il piano gratuito non basta?
Dentro CoinGecko ci sono due strade. L'API senza key non richiede registrazione ma è condivisa e limitata a circa 5 chiamate al minuto, e CoinGecko non la consiglia per la produzione. Un piano a pagamento alza i limiti e aggiunge la licenza commerciale, e la pagina dei prezzi elenca i piani. Non ho confrontato altri fornitori di prezzi, quindi non posso dire nulla sui loro piani gratuiti.
Un trucco più economico è interrogare meno spesso. I prezzi delle crypto si muovono tutto il giorno, ma un display decorativo non ha bisogno della precisione al minuto. Passare da 6 a 10 minuti porta le chiamate mensili da 7.200 a 4.320 e lascia spazio per un secondo dispositivo o per i nuovi tentativi.
Un'ultima cosa: i dati Demo richiedono l'attribuzione. Se pubblichi un progetto che mostra prezzi di CoinGecko, segui la guida all'attribuzione di CoinGecko, che la pagina dei prezzi linka dalla riga Demo.
Cosa abbiamo verificato e cosa resta aperto?
Abbiamo controllato il piano Demo sulle pagine di CoinGecko a novembre 2026: 100 chiamate al minuto, 10.000 chiamate al mese, 1 chiamata = 1 credito. Abbiamo calcolato che un poll ogni 6 minuti costa circa 7.200 chiamate in 30 giorni, letto il firmware per confermare header, endpoint e le tempistiche di 6 minuti e 30 secondi, e visto che un 429 riceve lo stesso nuovo tentativo fisso di qualsiasi altro errore.
Non ho provato cosa succede a 10.000 chiamate, e i numeri di CoinGecko sono già cambiati in passato, quindi guarda la pagina dei prezzi se un ticker comincia a fallire dopo mesi di funzionamento. Il firmware usa inoltre un client HTTPS senza verifica del certificato, come scritto nella guida alla costruzione.
Ora, se stai ancora collegando il display, leggi la guida ai collegamenti del MAX7219 FC16. Per il quadro completo della famiglia di progetti, vedi cos'è OpenGizmo.
Domande frequenti
Trova risposte rapide alle domande più comuni su questo argomento.
Sì. Il piano Demo di CoinGecko costa 0 $ al mese, senza carta di credito, e a novembre 2026 permette 100 chiamate al minuto e 10.000 al mese. CoinGecko richiede l'attribuzione e nella tabella dei prezzi la licenza commerciale compare solo nei piani a pagamento, quindi un ticker personale è l'uso previsto.
Autore
Mauro BrambillaPronto a costruire il tuo gizmo?
Scegli un progetto ESP32 open source e segui la sua guida passo passo, dalla lista dei componenti e dai collegamenti fino al firmware e al primo avvio.





