Cómo crear un bot de Telegram para monitorear desbloqueos de tokens cripto

¿Por qué seguir los eventos de desbloqueo de tokens?

Algunos tokens están "bloqueados" por un tiempo después de que se crean. Esto significa que no pueden ser comercializados de inmediato. Estos bloqueos generalmente están ahí para evitar que los miembros del equipo o los inversores vendan demasiado pronto. Pero una vez que el bloqueo termina, esos tokens pueden llegar al mercado de una vez.

Cuando muchos tokens se desbloquean al mismo tiempo, la oferta total sube rápidamente. Eso puede llevar a una caída en el precio porque más personas pueden comenzar a vender. Estos eventos de desbloqueo pueden afectar realmente cómo un token se desempeña en el mercado.

Rastrear desbloqueos no es solo observar una cuenta regresiva, es entender cómo la oferta bloqueada sostiene el precio y qué sucede cuando ese soporte desaparece. Como @digitalartchick lo expresa:

“El control de suministro es optimista, pero cuando esas monedas entran en circulación, pesa para siempre sobre la moneda.”

Esto subraya por qué los desbloqueos de tokens no son solo eventos para "superar", sino que cambian fundamentalmente la dinámica del mercado del token.

Si sabes sobre un desbloqueo próximo con anticipación, puedes estar preparado. Supongamos que un proyecto está a punto de desbloquear el 20% de su suministro total mañana: las personas que entraron temprano podrían vender. Enviar una alerta de Telegram antes de que eso suceda le da a tu comunidad una advertencia.

Los gráficos de precios no siempre muestran el panorama completo. Te dicen cuándo sucedió algo, pero no por qué. Rastrear los desbloqueos de tokens te da el "por qué".

El desafío de rastrear los calendarios de adquisición

Aunque los desbloqueos de tokens son importantes, son sorprendentemente difíciles de rastrear. Las API populares como CoinGecko o CoinMarketCap muestran datos de precios y volumen, pero no incluyen información sobre eventos de desbloqueo de tokens o cronogramas de adquisición. Estas plataformas se centran en lo que está sucediendo ahora o en el pasado, no en lo que viene a continuación.

Las herramientas de análisis en cadena como Nansen pueden mostrar movimientos de billeteras o actividad de ballenas, pero tampoco ofrecen una forma sencilla de ver los desbloqueos próximos. No puedes simplemente llamar a una función como getUpcomingUnlocks() y obtener lo que necesitas.

Debido a eso, muchos desarrolladores intentan recopilar los datos manualmente: leyendo whitepapers, siguiendo publicaciones de blog o analizando transacciones de contratos en blockchain. Otros recurren a herramientas como Dune o Bitquery, escribiendo consultas SQL o GraphQL para detectar eventos de desbloqueo. Estos métodos funcionan, pero consumen mucho tiempo, son complejos y deben construirse por separado para cada token.

No hay una forma estándar de acceder a todos los datos de desbloqueo en un solo lugar. Está disperso, es difícil de actualizar y no es en tiempo real. Por eso los desarrolladores necesitan una API unificada que haga el seguimiento del vesting de tokens simple, preciso y escalable.

API de DropsTab: Cerrando la Brecha de Datos

La API de DropsTab facilita mucho el trabajo con datos de criptomonedas. No solo muestra precios y gráficos, sino que también te proporciona detalles importantes como los horarios de desbloqueo de tokens, rondas de financiación y qué inversores poseen qué. Obtienes tanto información regular del mercado como datos más profundos de tokens en un solo lugar.

Es como combinar CoinGecko y Nansen en una sola API, pero con una característica adicional que la mayoría de los demás no ofrecen: seguimiento de desbloqueo. Así que en lugar de cambiar entre diferentes plataformas, puedes usar DropsTab para obtener una vista completa de cualquier proyecto de token.

Cuando se trata de desbloqueos, estas dos llamadas de API son clave:

• GET /api/v1/tokenUnlocks – muestra todos los tokens con eventos de desbloqueo próximos o que ya están ocurriendo. Verás cuánto sigue bloqueado y qué está a punto de ser liberado.

• GET /api/v1/tokenUnlocks/{coinSlug} – proporciona un calendario detallado de desbloqueo para un token específico. Muestra fechas, cuántos tokens se están desbloqueando y para quién son (como el equipo o los primeros inversores).

También hay otros puntos finales útiles:

• supportedCoins – muestra todos los tokens con datos de desbloqueo

• chart/{coin} – te permite trazar la actividad de desbloqueo a lo largo del tiempo

Dado que estos datos están disponibles a través de una API, puedes crear bots o paneles que rastreen desbloqueos automáticamente. No más adivinanzas sobre cuándo vienen grandes lanzamientos: tu aplicación o bot puede alertar a las personas con anticipación.

Comenzando: Accediendo a la API de DropsTab

Antes de construir tu bot de Telegram, necesitas obtener una clave API de DropsTab. Esta clave te da permiso para usar sus datos en tu proyecto.

Aquí está la parte buena: Si eres estudiante, desarrollador independiente o parte de un hackathon, puedes obtener la clave de forma gratuita uniéndote al DropsTab Builders Program. Esto te da acceso a datos importantes como desbloqueos de tokens durante al menos 3 meses, sin pagar nada.

Una vez que recibas tu clave API (una larga combinación de letras y números), mantenla segura y no la compartas. Necesitarás incluirla en tus solicitudes de esta manera:

Autorización: Bearer YOUR_API_KEY

Todas las solicitudes de API pasan por esta URL base: https://public-api.dropstab.com/api/v1/

Pruébalo en Terminal

No necesitas escribir un programa completo para verificar si funciona. Abre tu terminal y usa curl para hacer una prueba rápida. Aquí está cómo obtener el precio de Bitcoin el 1 de agosto de 2025:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://public-api.dropstab.com/api/v1/coins/history/price/bitcoin?date=2025-08-01"

Este comando devolverá los datos de precios en formato JSON.

Para verificar los próximos desbloqueos de tokens, usa este comando:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://public-api.dropstab.com/api/v1/tokenUnlocks"

¿Cuántas solicitudes puedes hacer?

El plan gratuito te ofrece:

• Hasta 100 solicitudes por minuto
• 100,000 solicitudes por mes

Eso es más que suficiente para un bot o herramienta básica. Y si tu proyecto crece, puedes cambiar a un plan de nivel superior para obtener más potencia, todo sin cambiar tu código. La API permanece igual.

¿Quieres más detalles? Consulta la documentación completa de la API aquí: https://dropstab.com/es/products/commercial-api

Obteniendo desbloqueos de tokens próximos a través de la API

Una vez que tengas tu clave API, puedes usar Python para verificar qué tokens están a punto de desbloquearse. El endpoint de DropsTab /tokenUnlocks muestra una lista de tokens con eventos de desbloqueo próximos. Te dice el nombre del token, la fecha de desbloqueo, cuánto se desbloqueará y qué porcentaje de su suministro total es.

Aquí tienes un ejemplo simple de Python que envía una solicitud a la API y muestra la información:

import requests

API_KEY = "YOUR_API_KEY"  # Reemplaza esto con tu clave API real de DropsTab
url = "https://public-api.dropstab.com/api/v1/tokenUnlocks"

headers = {"Authorization": f"Bearer {API_KEY}"}
response = requests.get(url, headers=headers)
data = response.json()

# Recorre cada evento de desbloqueo y muestra los resultados
for event in data.get('data', []):
    coin = event.get('coin')
    date = event.get('date')
    percent = event.get('percentage')
    amount = event.get('amount')
    print(f"{coin} desbloquea {percent}% del suministro el {date} (aproximadamente {amount} tokens)")

Cómo se ve la respuesta de la API

{
  "coin": "Aptos",
  "date": "2025-08-12",
  "percentage": 1.13,
  "amount": 11300000
}

Este ejemplo significa que Aptos desbloqueará 1.13% de su suministro (aproximadamente 11,3 millones de tokens) el 12 de agosto de 2025.

DropsTab recopila esta información de fuentes públicas como whitepapers o contratos de blockchain, para que no tengas que buscar por tu cuenta. Si deseas el calendario completo para un token, simplemente usa /tokenUnlocks/{coinSlug} — por ejemplo: /tokenUnlocks/aptos.

Pero si tu bot está observando muchos tokens a la vez, el endpoint general /tokenUnlocks es el mejor. Te da todos los desbloqueos próximos de una sola vez.

Algunos desbloqueos también pueden mostrar información adicional, como si son para el equipo, inversores o la comunidad. Puedes usar esto para que tus alertas sean aún más útiles.

Filtrando eventos de desbloqueo significativos

Algunos son tan pequeños (como el 0.5% del suministro total) que realmente no afectan al mercado. Si tu bot alerta a las personas sobre cada pequeño evento, solo los molestará.

Para solucionar esto, podemos establecer un umbral mínimo — un número que decide qué vale la pena alertar. Una elección común es el 5%. Eso significa que tu bot solo enviará alertas si el desbloqueo es del 5% o más del suministro total de tokens.

Aquí tienes cómo puedes añadir ese filtro en Python:

threshold = 5.0  # Alerta solo si el desbloqueo es del 5% o más

for event in data.get('data', []):
    percent = event.get('percentage', 0)
    coin = event.get('coin')
    date = event.get('date')

    if percent >= threshold:
        alert_text = f"ALERTA: {coin} desbloquea el {percent}% de su suministro el {date}!"
        print(alert_text)

Este código verifica cada evento e imprime una alerta solo si cumple con el umbral elegido. Así que si un token desbloquea el 3.2%, no aparecerá. Pero si otro desbloquea el 10%, sí lo hará.

Algunos desbloqueos están diseñados con equidad o distribución estratégica en mente. Por ejemplo, como señaló World Liberty Financial:

“Solo una parte de los tokens comprados en la venta pública que se adquirieron a $0.015 y $0.05 se desbloquearán inicialmente; esto recompensa directamente a nuestros primeros creyentes minoristas y a nadie más. Además, tokens del tesoro únicamente para sembrar liquidez. Esto mantiene a la comunidad como el enfoque principal.”

Esto muestra por qué no se trata solo de cuánto se desbloquea, sino para quién se desbloquea y por qué, otra razón para contextualizar las alertas cuidadosamente.

Puedes cambiar el umbral según el tipo de tokens que estés rastreando. Para monedas de pequeña capitalización, tal vez un 3% sea importante. Para tokens de renombre, quizás solo te importen los eventos por encima del 10%.

Además, dado que las fechas de desbloqueo vienen en un formato estándar, puedes ordenarlas o agregar filtros adicionales (como solo mirar los desbloqueos dentro de las próximas 24 horas). Incluso podrías hacer que tu bot revise una vez al día para mantener las alertas frescas y útiles.

Enviando alertas a Telegram en tiempo real

Una vez que tu script encuentre un gran desbloqueo de tokens, es hora de informar a tus usuarios de Telegram. La forma más fácil de hacerlo es utilizando la python-telegram-bot library (versión 20+).

Paso 1: Crea tu bot de Telegram

• Abre Telegram y envía un mensaje a @BotFather
• Escribe /newbot para crear un nuevo bot y obtener tu bot token
• Guarda el token en un lugar seguro
• Elige dónde el bot enviará mensajes (tu propio chat, un grupo o un canal)

Paso 2: Instalar la biblioteca de Python

Abre tu terminal y escribe:

pip install python-telegram-bot

Paso 3: Envía alertas desde tu código

Agrega esto a tu script para enviar un mensaje cuando se encuentre un gran desbloqueo:

from telegram import Bot

BOT_TOKEN = "YOUR_TELEGRAM_BOT_TOKEN"  # tu token de BotFather
CHAT_ID = "YOUR_CHAT_ID"  # tu ID de usuario o un ID de grupo/canal

bot = Bot(token=BOT_TOKEN)

# Envía un mensaje cuando se encuentra un gran desbloqueo:
if percent >= threshold:
    alert_text = f"🚨 Alerta de Desbloqueo de Token: {coin} desbloqueará {percent}% del suministro el {date}"
    bot.send_message(chat_id=CHAT_ID, text=alert_text)

Qué hará el Bot

Tu bot de Telegram enviará un mensaje como este:

🚨 Alerta de Desbloqueo de Token: Aptos desbloqueará el 1.13% del suministro el 2025-08-12

La biblioteca maneja todo en segundo plano. Solo asegúrate de que el bot tenga permiso para publicar en el chat elegido.

¿Cuándo debería enviar alertas?

No necesitas esperar hasta que ocurra el desbloqueo. La API de DropsTab te da las fechas de desbloqueo con anticipación. Eso significa que tu bot puede advertir a los usuarios con antelación. Puedes:

• Ejecuta el script una vez al día para alertar sobre desbloqueos que vienen en las próximas 24 horas
• O ejecútalo cada hora para captar eventos que ocurren pronto

Dado que DropsTab mantiene sus datos actualizados en tiempo real, tu bot siempre tendrá información fresca. Esta configuración es ideal para un bot de alertas simple. Más tarde, puedes mejorarlo con funciones de programación o asincrónicas. Pero para empezar, todo lo que necesitas es un filtro y una llamada a bot.send_message() para que las alertas estén en funcionamiento.

Formas de ejecutar tu bot

Tienes algunas formas fáciles de mantener tu bot funcionando según un horario:

1. Tarea programada o planificador

Ejecuta tu script una vez cada hora o día. Puedes usar:

• cron (para Linux/Mac)
• Task Scheduler (para Windows)
• Un bucle de Python usando time.sleep()

El plan gratuito de la API de DropsTab te da 100 solicitudes por minuto, por lo que hacer esto cada hora no es problema.

2. Funciones en la Nube

Utiliza una plataforma sin servidor para ejecutar tu bot automáticamente, como:

• AWS Lambda
• Google Cloud Functions

De esta manera, no necesitas mantener tu computadora o servidor funcionando 24/7.

3. Bot Siempre Activo

Si tu bot tiene comandos (como "/nextunlock Aptos"), puedes ejecutarlo todo el tiempo. Usa sondeo o webhooks para escuchar mensajes y ejecuta tu verificador de desbloqueo en segundo plano.

Expandiendo el caso de uso

Ahora que tu bot puede obtener datos de desbloqueo, filtrarlos y enviar alertas, puedes hacerlo aún más útil añadiendo más funciones de la API de DropsTab.

A medida que más proyectos experimentan con modelos de desbloqueo alternativos, los bots también pueden rastrear cambios en la consolidación o giros repentinos de TGE. Por ejemplo, Theoriq sorprendió recientemente al mercado al eliminar por completo la consolidación:

“Hemos eliminado los términos de adquisición de la venta comunitaria y todas las asignaciones de tokens estarán 100% desbloqueadas en TGE.” (via @TheoriqAI, destacado por @Va77ss)

Estos cambios merecen ser alertados, especialmente en un mercado escéptico de la adjudicación gradual lenta y desbloqueos con muchos insiders.

Nuevos Tipos de Alertas

DropsTab no solo muestra desbloqueos de tokens. También incluye:

• Rondas de financiación de VC (/fundingRounds) — cuando un proyecto recibe nueva inversión
• Portafolios de inversores (/investors) — quién posee qué
• Actividades cripto (/cryptoActivities) — como listados en intercambios o actualizaciones de protocolos

Con esto, podrías:

• Enviar una alerta cuando un token se liste en un nuevo intercambio
• Notificar a los usuarios cuando un proyecto reciba nuevos fondos
• Observar lo que hacen los grandes inversores y enviar actualizaciones

Esto convertiría tu bot en un feed completo de noticias de criptomonedas.

Agregar información de precio del token

¿Quieres dar a los usuarios más contexto? Puedes obtener datos de precios utilizando el endpoint /coins. Combina eso con alertas de desbloqueo y muestra cuánto valor se está liberando.

Ejemplo:

Token X desbloquea el 10% del suministro mañana, eso es aproximadamente $5 millones al precio actual.

Agregar contexto de precios ayuda a los usuarios a entender si un desbloqueo podría desencadenar volatilidad o simplemente integrarse en tendencias más amplias. Como Glassnode señaló recientemente:

“El indicador propietario de #Altseason de Glassnode se activó… el capital está fluyendo hacia $BTC y $ETH, y… la capitalización del mercado de altcoins está aumentando – un entorno estructural propicio para la rotación de capital.”

En este tipo de entorno, los eventos de desbloqueo podrían coincidir con una mayor demanda, haciendo que algunos lanzamientos sean menos bajistas de lo que parecen en aislamiento.

Manténlo simple — Una API

Todo esto proviene de un solo lugar: la API de DropsTab. No necesitas agregar servicios o herramientas adicionales. Solo usa diferentes endpoints de la misma API. Mantiene tu código limpio y todo consistente.