Cómo conectar CoinGecko a Google Sheets
1. Define qué necesitas seguir antes de crear la hoja
Empieza con una breve especificación, no con una fórmula. Enumera las monedas, las divisas de cotización, la frecuencia de actualización y si necesitas el precio actual, registros históricos o ambos. Una hoja para consultar BTC y ETH en USD tiene una función distinta a otra que registra una cartera diversificada en EUR y GBP.
Mantén pequeña la primera versión. Por ejemplo, sigue tres monedas en una divisa y actualiza los datos una vez por hora. Añade más filas o divisas solo después de confirmar que los resultados coinciden con los datos que muestra CoinGecko. El volumen de solicitudes necesario y las opciones de actualización disponibles dependen del método de acceso y las condiciones de tu cuenta, así que consulta los límites vigentes antes de establecer un horario.
Decide qué significa «precio» en tu hoja. Una cotización actual es un valor en un momento determinado, no un precio de ejecución garantizado. Si piensas compararla con una operación, registra la hora de la cotización y no trates como actual un resultado retrasado o almacenado en caché.
2. Elige un método de acceso a la API que se adapte a tu configuración
Hay tres formas habituales de conectar los datos de CoinGecko con Google Sheets: un complemento de Sheets, un pequeño script de Apps Script o un conector de terceros. Para alguien sin conocimientos técnicos, el complemento suele ser la opción más rápida. Un script ofrece más control sobre el formato de las solicitudes y el almacenamiento de los datos. Un conector puede evitarte programar, pero añade otro servicio que tendrás que revisar si deja de actualizarse. Si estás buscando cómo conectar CoinGecko a Google Sheets, compara estas opciones según tu experiencia y tus necesidades.
Antes de elegir, compara la autenticación, los límites de solicitudes y el mantenimiento. Averigua si el método necesita una clave de API, dónde se guarda, qué frecuencia de actualización admite y si sus límites se ajustan al número previsto de monedas y divisas. Las opciones y condiciones de acceso a la API de CoinGecko pueden cambiar; consulta su documentación para conocer los requisitos vigentes y comprobar si la API de CoinGecko para Google Sheets requiere una herramienta o integración específica.
Si usas Apps Script, abre el editor de scripts de la hoja de cálculo y crea una función que solicite los datos a CoinGecko, analice la respuesta y escriba los campos seleccionados en una hoja. Un script básico es más fácil de depurar cuando tiene una sola tarea y muestra un mensaje de error claro. No guardes una clave de API privada en una celda que puedan ver todas las personas con acceso a la hoja de cálculo.
Si todavía estás comparando herramientas, la guía sobre qué hace que una plataforma de intercambio de criptomonedas sea la mejor aborda una decisión distinta: elegir una plataforma de trading, no una fuente de datos. Separar ambas decisiones ayuda a evitar que se confunda un flujo de datos de una API con una cuenta de exchange.
3. Crea una tabla de consulta de monedas y divisas
Usa los ID de monedas de CoinGecko en las solicitudes, no solo los símbolos bursátiles. Varios proyectos sin relación pueden compartir un símbolo, mientras que un ID permite a la API consultar un activo concreto. Crea una pestaña llamada «Consulta» con columnas para el nombre visible, el ID de CoinGecko, el símbolo y la divisa de destino.
| Nombre visible | ID de CoinGecko | Símbolo | Divisa |
|---|---|---|---|
| Bitcoin | bitcoin | BTC | usd |
| Ethereum | ethereum | ETH | usd |
| Activo de ejemplo | [confirmar ID] | [confirmar símbolo] | eur |
Las dos primeras filas muestran el tipo de identificador que debes registrar; verifica cada ID en CoinGecko antes de usarlo. El símbolo es útil como etiqueta, pero no debe sustituir al ID en una solicitud. Esto es especialmente importante si tu cartera incluye un token poco conocido cuyo símbolo se parece al de otro proyecto.
Guarda los códigos de divisa en un formato uniforme, por ejemplo, en minúsculas (`usd` o `eur`), si eso es lo que espera el endpoint elegido. Una regla de validación en Google Sheets puede limitar la columna de divisas a las que admite tu configuración. Así evitarás que un error tipográfico como `usdd` llegue a la API.
4. Obtén los precios actuales en una tabla de datos ordenada
Mantén la respuesta sin procesar de la API separada de la hoja que se usa para consultar los precios. Una pestaña «Datos sin procesar» puede contener la respuesta o los últimos valores importados; otra pestaña «Precios» puede mostrar el nombre de la moneda, el símbolo, la divisa, el precio y la hora. Esta separación facilita cambiar el formato sin alterar accidentalmente la lógica de las solicitudes.
Una solicitud habitual de precios actuales envía los ID de monedas seleccionados y la divisa de cotización al endpoint de precios de CoinGecko. La URL exacta, los parámetros, el método de autenticación y los campos de la respuesta dependen del producto de API y del método de acceso, así que consulta la documentación de CoinGecko para conocer los detalles del endpoint. En la tabla resultante, asocia el valor devuelto con el ID correspondiente, en lugar de dar por sentado que el orden de la respuesta siempre coincidirá con el de las filas que escribiste.
Por ejemplo, la tabla visible podría mostrar «Bitcoin | BTC | USD | precio | actualizado el». Da formato a la columna de precios como número y con una cantidad adecuada de decimales, pero conserva suficiente precisión para los activos que sigues. Redondear el valor que se muestra es una decisión de presentación; redondear el valor almacenado puede distorsionar los cálculos posteriores.
Quien quiera consultar precios de criptomonedas en Google Sheets con la API de CoinGecko debería empezar con una moneda y una divisa, y luego confirmar que el ID, la divisa y la cotización devueltos coinciden con la fuente. Una vez comprobado, amplía la tabla de consulta y prueba cada fila nueva. No es tan llamativo como crear un panel grande, pero permite detectar pronto los ID incorrectos.
Usa fórmulas para hacer cálculos, no para ocultar datos que faltan. Si falla una solicitud, muestra una indicación clara, como «Error en la solicitud», o deja visible el estado de error, en lugar de mostrar un cero como si el activo hubiera perdido todo su valor. Un cero puede afectar los totales de la cartera y llevar a tomar decisiones que no tienen nada que ver con el mercado.
5. Programa las actualizaciones y gestiona los límites de solicitudes
La actualización automática solo resulta útil si se ejecuta con una frecuencia permitida por tu acceso a la API. Los controles de actualización de los complementos, los activadores de Apps Script y los horarios de los conectores funcionan de manera distinta. Consulta la cuota y las reglas de actualización vigentes para el método elegido antes de establecer un intervalo; los límites exactos pueden variar según el plan y cambiar con el tiempo.
Empieza con un horario prudente y una solicitud pequeña. Si sigues cinco activos, evita enviar una solicitud independiente por cada celda cuando una sola pueda devolver los valores necesarios. Reducir las llamadas puede facilitar el mantenimiento de la hoja, pero confirma que el endpoint admite los ID y las divisas que envías juntos.
Prepárate para los fallos. La API puede devolver un error, un servicio puede dejar de estar disponible o puedes alcanzar el límite de solicitudes. Deja visible la hora de la última actualización correcta y no sustituyas datos anteriores válidos por una respuesta vacía, a menos que quieras borrarlos. Una cotización desactualizada sigue estando desactualizada: indícalo en vez de presentarla como actual.
Los activadores de Apps Script pueden ejecutarse según un horario, pero están sujetos a los límites de ejecución y requisitos de autorización de Google. Después de configurarlos, comprueba su estado y revisa el registro de ejecuciones si dejan de actualizarse. Los límites de Google y CoinGecko son independientes; respetar los de uno no garantiza que el otro acepte todas las solicitudes.
6. Añade marcas de tiempo y conserva registros históricos de precios
Una tabla que sustituye el precio de ayer por el de hoy no permite ver qué ha cambiado. Añade una pestaña «Historial» que guarde una fila por moneda y actualización, con columnas para la marca de tiempo, el ID de la moneda, la divisa y el precio. Escribe cada respuesta correcta en una fila nueva, en lugar de reemplazar el registro anterior.
Por ejemplo, una fila histórica podría decir «2026-11-12 10:00 | bitcoin | usd | [valor devuelto]». Usa la hora real que indique tu conexión o script y especifica si corresponde a UTC o a la hora local. El precio mostrado debe ir acompañado de la marca de tiempo de esa misma actualización, no de la hora en que alguien abrió la hoja por última vez.
Decide cuánto tiempo conservar los datos antes de que crezca demasiado la pestaña del historial. Según el objetivo y el límite de solicitudes, podrías guardar una instantánea diaria para un registro personal de largo plazo o registros más frecuentes para un seguimiento a corto plazo. No des por sentado que la respuesta de la API incluye datos históricos solo porque la hoja haya acumulado instantáneas; se trata de fuentes de datos distintas.
Con filas fechadas, puedes calcular el cambio entre dos observaciones registradas, siempre que coincidan el ID de la moneda y la divisa de cotización. Comparar una fila de BTC/USD con otra de BTC/EUR introduce también el efecto del tipo de cambio, además del cambio en el precio; por eso, etiqueta claramente cada serie antes de crear gráficos.
7. Valida los resultados y mantén la conexión
Haz algunas comprobaciones antes de confiar en un panel. Confirma que el ID de la moneda es correcto, que la divisa indicada coincide con la solicitud, que el precio devuelto es numérico y que la marca de tiempo corresponde a esa actualización. Luego, compara un resultado de muestra con el sitio de CoinGecko, teniendo en cuenta que ambas vistas podrían actualizarse en momentos distintos.
Durante las pruebas, deja visibles los mensajes de error. Una solicitud fallida puede indicar una clave no válida, un parámetro mal formado, un problema con la cuota o un fallo temporal del servicio. Anota el mensaje y la hora en que apareció; si cambias varios ajustes a la vez, será más difícil identificar la causa. Si el mismo error se repite, consulta la documentación del endpoint y las condiciones de tu plan de acceso.
Documenta quién es responsable del script o el conector, dónde se guardan las credenciales y qué pestañas se pueden editar sin riesgo. Si alguien cambia el nombre de una columna que el script necesita, la conexión puede fallar aunque CoinGecko no haya cambiado nada. Proteger las pestañas de consulta y de datos sin procesar frente a cambios accidentales puede evitar este tipo de problemas.
Revisa la configuración si CoinGecko modifica las condiciones de la API, la autenticación, los endpoints disponibles o las cuotas, y consulta la información vigente antes de cambiar una hoja de producción. Tras cada cambio, suele bastar con probar una moneda para detectar un parámetro incorrecto antes de que afecte a todas las filas. Deja esa prueba en el libro para que la siguiente persona pueda repetirla.