API de CoinGecko en ESP32: límites gratis y frecuencia
El plan Demo gratis de CoinGecko: 100 llamadas/min y 10.000 al mes. Cada cuánto consultar con un ESP32, cómo enviar la clave y qué es el error 429.
- Autor
Mauro Brambilla- Publicado
- Tiempo de lectura
- 8 min
- Categoría
- Guías

En resumen
A noviembre de 2026, el plan Demo gratuito de CoinGecko da 100 llamadas por minuto y 10.000 al mes. Un ESP32 que consulta la API cada 6 minutos usa unas 7.200 en 30 días, así que un dispositivo cabe.
La API de CoinGecko es gratis para proyectos de hobby: su plan Demo cuesta 0 $, no pide tarjeta de crédito y, a noviembre de 2026, permite 100 llamadas por minuto y 10.000 al mes. Un ESP32 que consulta la API una vez cada 6 minutos hace unas 7.200 llamadas en 30 días, así que una placa cabe bajo el límite.
Quizá estés a punto de flashear un ticker y te preguntes cada cuánto puede pedir un precio antes de que CoinGecko le corte el acceso. En esta guía hacemos las cuentas del polling, leemos el firmware real del Gizmo Ticker para ver cómo envía su clave y cómo programa las llamadas, y vemos qué pasa con un 429. Los números salen de las páginas de precios y de documentación de CoinGecko, y los tiempos, del código fuente del firmware.
¿Cuáles son los límites del plan Demo de CoinGecko?
El plan Demo es el nivel gratuito de CoinGecko: una clave que pides a CoinGecko, con un límite por minuto y un presupuesto mensual de llamadas. A noviembre de 2026, la página de precios y la página de errores y límites dicen esto:
| Concepto | Plan Demo (gratis) | API pública sin clave |
|---|---|---|
| Precio | 0 $ al mes, sin tarjeta de crédito | Gratis |
| Límite por minuto | 100 llamadas por minuto | Unas 5 llamadas por minuto, basadas en la IP y compartidas |
| Presupuesto mensual | 10.000 llamadas (10k créditos) | No indicado |
| Costo de una llamada | 1 llamada = 1 crédito | No aplica |
| Atribución | Obligatoria | Obligatoria |
| Licencia comercial | No figura en la página de precios | No incluida; CoinGecko remite a un plan de pago |
| Uso en producción | Pensado para proyectos personales | No recomendado |
La columna sin clave sale de la página de la API pública sin clave de CoinGecko. Dice que el límite lo comparten todos los que usan la misma IP, que el límite real varía con la carga del servidor y que no se recomienda para entornos de producción. Un ticker que funciona todo el día sin supervisión se parece más a producción que a una prueba rápida, así que usa una clave Demo.
Muchos artículos antiguos citan 30 llamadas por minuto para el plan gratuito. No pude comprobarlo en una copia archivada de una página de CoinGecko, así que este artículo solo usa las cifras que hoy aparecen en sus páginas. Vuelve a revisarlas antes de diseñar algo alrededor de un límite.
Algo que no pude confirmar: la página de precios no dice qué pasa en el plan Demo cuando se acaban las 10.000 llamadas. Su texto sobre excedentes solo cubre los planes de pago. Lo mejor es quedarse por debajo del tope en lugar de probarlo.
¿Cuántas llamadas al mes usa un ESP32?
Un mes de 30 días tiene 43.200 minutos. Cada consulta es una llamada, así que:
llamadas al mes = 43.200 ÷ intervalo en minutos
Con eso obtienes el presupuesto para cualquier intervalo. El tope es 10.000, así que el intervalo mínimo seguro para un dispositivo es 43.200 ÷ 10.000 = 4,32 minutos. Un mes de 31 días sube el total un 3 % aproximadamente (44.640 minutos), y el límite pasa a unos 4,5 minutos. En la práctica, 5 minutos es el mínimo si quieres un margen.

| Intervalo de consulta (min) | Llamadas por hora | Llamadas en 30 días | ¿Bajo el tope de 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í |
Fíjate en que el límite por minuto nunca importa aquí. Con una llamada cada 6 minutos usas un 0,2 % de las 100 llamadas por minuto. Lo que limita a un dispositivo es el presupuesto mensual, y lo hace sin contemplaciones.
¿Cómo consulta el Gizmo Ticker a CoinGecko?
El ticker consulta la API una vez cada 6 minutos. En market_refresh.h la constante MARKET_REFRESH_INTERVAL_MS vale 360000, y una llamada fallida se reintenta tras MARKET_RETRY_INTERVAL_MS, que es 30000 (30 segundos). La lógica de programación está en market_refresh.cpp.

¿Por qué 6 minutos? El repositorio no deja constancia del motivo, así que no me lo voy a inventar. Lo que muestran las cuentas es que 6 minutos dejan unas 2.800 llamadas de margen sobre 10.000 en un mes de 30 días (unas 2.560 en uno de 31). Ese margen se lo comen todas las llamadas que no son una consulta programada:
- Una petición justo después de arrancar, porque la programación empieza con una petición ya pendiente.
- Una petición después de guardar una clave de API nueva o de cambiar la moneda en la aplicación web.
- Los reintentos cada 30 segundos mientras una llamada sigue fallando.

Cuando los datos envejecen, el firmware te avisa. Si pasan 12 minutos (MARKET_STALE_AFTER_MS, el doble del intervalo de actualización) sin un éxito, la matriz abre cada ciclo con Prices from N min ago. y el último error. Para el montaje completo, consulta cómo construir un ticker de criptomonedas con ESP32 y MAX7219.
¿Cómo se envía la clave Demo desde un ESP32?
La documentación de autenticación Demo de CoinGecko ofrece dos opciones: la cabecera x-cg-demo-api-key (recomendada) o el parámetro de consulta x_cg_demo_api_key. La URL base para una clave Demo es https://api.coingecko.com/api/v3/. El firmware de api.cpp usa la cabecera:
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;
}Con la cabecera, además, la clave queda fuera de la URL de la petición, que el firmware imprime en su registro serie (Requesting URL: ...). Ese razonamiento sobre la cabecera es mío, no una afirmación de CoinGecko. Cada consulta es una sola petición /coins/markets para una sola moneda, y por eso una consulta cuesta una llamada. El firmware también pide solo los campos que muestra mediante un filtro de ArduinoJson, para ahorrar memoria.
La clave nunca está en el código. La pegas en la página API Key de la aplicación web de la placa y se guarda en la placa en un búfer de 35 bytes, es decir, 34 caracteres como máximo. Sin clave, el firmware no llama a CoinGecko en absoluto y en su lugar desplaza el texto API key is not present.. Para introducirla primero necesitas la placa conectada a tu Wi-Fi: la comparativa de métodos de provisioning Wi-Fi explica cómo funciona el hotspot de configuración.
Antes de celebrar, prueba la clave desde una computadora:
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 significa que la clave funciona. Según la lista de errores de CoinGecko, un 401 indica una clave ausente o no válida, y el código de error 10011 significa que enviaste una clave Demo al host equivocado.
¿Qué pasa cuando el ESP32 recibe un HTTP 429?
HTTP 429 es "Too Many Requests": superaste el límite de peticiones. CoinGecko cuenta cada petición para el límite, incluidas las que devuelven errores 4xx y 5xx, así que los errores no le dan un pase libre a un dispositivo que falla. Su documentación sugiere reducir la frecuencia de las llamadas o subir de plan.
¿Y qué hace el ticker? Todo lo que no sea un 200 se trata igual: fetchMarketData devuelve false, la programación elige el reintento a los 30 segundos y la matriz sigue mostrando los últimos datos buenos. No hay un caso especial para el 429 ni backoff, y el firmware no lee ninguna cabecera de límite. Tampoco encontré descritas las cabeceras Retry-After o de límite en la página de errores de CoinGecko, así que no puedo decirte qué envía el servidor.
¿Es un problema? Con un solo dispositivo, apenas. Un reintento permanente cada 30 segundos son 2 llamadas por minuto, muy por debajo de 100. El riesgo es otro: durante una caída larga, de cualquiera de los dos lados, esos reintentos se acumulan. Una hora de fallos son unas 120 llamadas, más del 1 % del presupuesto mensual. Si modificas el firmware, lo sensato es un backoff exponencial, que la propia CoinGecko aconseja para la API sin clave. Si una llamada fallida también gasta un crédito mensual está documentado para el plan Pro (no lo gasta, según la página de autenticación Pro), pero no para el Demo, así que no contaría con ello.
Si ves un 429 en un ticker real, cambia una sola cosa a la vez:
- Comprueba cuántos dispositivos usan la clave. La cuota pertenece a la clave, así que dos placas que consultan cada 6 minutos hacen unas 14.400 llamadas en 30 días.
- Comprueba que nada más use la clave, como un script o un segundo proyecto.
- Alarga el intervalo de consulta. Con 10 minutos, una clave puede alimentar 2 placas (8.640 llamadas).
Si la clave no es tuya, pregunta primero a su dueño.
¿Qué alternativas hay cuando el plan gratuito no alcanza?
Dentro de CoinGecko hay dos caminos. La API sin clave no necesita registro, pero es compartida y está limitada a unas 5 llamadas por minuto, y CoinGecko no la recomienda para producción. Un plan de pago sube los límites y añade licencia comercial, y la página de precios lista los planes. No comparé otros proveedores de precios, así que no puedo afirmar nada sobre sus planes gratuitos.
Un truco más barato es consultar menos. Los precios de las criptomonedas se mueven todo el día, pero una pantalla decorativa no necesita precisión de minuto a minuto. Pasar de 6 a 10 minutos baja las llamadas mensuales de 7.200 a 4.320 y deja espacio para un segundo dispositivo o para los reintentos.
Una cosa más: los datos Demo exigen atribución. Si publicas un proyecto que muestra precios de CoinGecko, sigue la guía de atribución de CoinGecko, que la página de precios enlaza desde su fila Demo.
¿Qué verificamos y qué sigue abierto?
Comprobamos el plan Demo con las páginas de CoinGecko a noviembre de 2026: 100 llamadas por minuto, 10.000 llamadas al mes, 1 llamada = 1 crédito. Calculamos que una consulta cada 6 minutos cuesta unas 7.200 llamadas en 30 días, leímos el firmware para confirmar la cabecera, el endpoint y los tiempos de 6 minutos y 30 segundos, y vimos que un 429 recibe el mismo reintento fijo que cualquier otro fallo.
No probé qué pasa al llegar a 10.000 llamadas, y las cifras de CoinGecko ya han cambiado antes, así que revisa la página de precios si un ticker empieza a fallar después de meses funcionando. El firmware también usa un cliente HTTPS sin verificación de certificado, como se explica en la guía de montaje.
Y ahora, si todavía estás conectando la pantalla, lee la guía de conexiones del MAX7219 FC16. Para ver el panorama completo de la familia de proyectos, consulta qué es OpenGizmo.
Preguntas frecuentes
Encuentra respuestas rápidas a las preguntas más comunes sobre este tema.
Sí. El plan Demo de CoinGecko cuesta 0 $ al mes, sin tarjeta de crédito, y a noviembre de 2026 permite 100 llamadas por minuto y 10.000 al mes. CoinGecko exige atribución y su tabla de precios lista la licencia comercial solo en los planes de pago, así que un ticker personal es el uso previsto.
Autor
Mauro Brambilla¿Listo para montar tu propio gizmo?
Elige un proyecto open source con ESP32 y sigue su guía paso a paso, desde la lista de componentes y el cableado hasta el firmware y el primer arranque.





