Como criar um bot do Telegram para monitorar desbloqueios de tokens cripto

Por que acompanhar eventos de desbloqueio de tokens?

Alguns tokens estão "bloqueados" por um tempo depois de serem criados. Isso significa que eles não podem ser negociados imediatamente. Esses bloqueios geralmente existem para impedir que membros da equipe ou investidores vendam muito cedo. Mas, uma vez que o bloqueio termina, esses tokens podem entrar no mercado de uma só vez.

Quando muitos tokens são desbloqueados ao mesmo tempo, a oferta total aumenta rapidamente. Isso pode levar a uma queda no preço porque mais pessoas podem começar a vender. Esses eventos de desbloqueio podem realmente afetar o desempenho de um token no mercado.

Acompanhar desbloqueios não é apenas sobre assistir uma contagem regressiva — é sobre entender como a oferta bloqueada sustenta o preço e o que acontece quando esse suporte desaparece. Como @digitalartchick coloca:

“O controle de oferta é otimista, mas quando essas moedas entram em circulação, elas pesam para sempre sobre a moeda.”

Isso ressalta por que os desbloqueios de tokens não são apenas eventos para "superar" — eles mudam fundamentalmente a dinâmica do mercado do token.

Se você souber de um desbloqueio iminente com antecedência, pode estar preparado. Digamos que um projeto esteja prestes a desbloquear 20% de seu suprimento total amanhã — as pessoas que entraram cedo podem vender. Enviar um alerta no Telegram antes que isso aconteça dá um aviso à sua comunidade.

Os gráficos de preços nem sempre mostram o quadro completo. Eles dizem quando algo aconteceu, mas não o porquê. Acompanhar desbloqueios de tokens dá a você o "porquê".

O Desafio de Acompanhar Cronogramas de Vesting

Embora os desbloqueios de tokens sejam importantes, eles são surpreendentemente difíceis de rastrear. APIs populares como CoinGecko ou CoinMarketCap mostram dados de preço e volume, mas não incluem informações sobre eventos de desbloqueio de tokens ou cronogramas de aquisição. Essas plataformas se concentram no que está acontecendo agora ou no passado, não no que está por vir.

Ferramentas de análise on-chain como Nansen podem mostrar movimentos de carteiras ou atividade de baleias, mas também não oferecem uma maneira simples de ver desbloqueios futuros. Você não pode simplesmente chamar uma função como getUpcomingUnlocks() e obter o que precisa.

Por causa disso, muitos desenvolvedores tentam coletar os dados manualmente: lendo whitepapers, acompanhando postagens de blog ou analisando transações de contratos blockchain. Outros recorrem a ferramentas como Dune ou Bitquery, escrevendo consultas SQL ou GraphQL para detectar eventos de desbloqueio. Esses métodos funcionam, mas são demorados, complexos e precisam ser construídos separadamente para cada token.

Não há uma maneira padrão de acessar todos os dados de desbloqueio em um só lugar. Está disperso, difícil de atualizar e não é em tempo real. É por isso que os desenvolvedores precisam de uma API unificada que torne o rastreamento de aquisição de tokens simples, preciso e escalável.

API DropsTab – Ligando a Lacuna de Dados

A API DropsTab torna muito mais fácil trabalhar com dados de criptomoedas. Ela não apenas mostra preços e gráficos — também fornece detalhes importantes como cronogramas de desbloqueio de tokens, rodadas de financiamento e quais investidores possuem o quê. Você obtém tanto informações regulares de mercado quanto dados mais profundos de tokens em um só lugar.

É como combinar CoinGecko e Nansen em uma única API, mas com um recurso extra que a maioria dos outros não oferece: rastreamento de desbloqueio. Então, em vez de alternar entre diferentes plataformas, você pode usar DropsTab para obter uma visão completa de qualquer projeto de token.

Quando se trata de desbloqueios, essas duas chamadas de API são essenciais:

• GET /api/v1/tokenUnlocks – mostra todos os tokens com eventos de desbloqueio próximos ou já acontecendo. Você verá quanto ainda está bloqueado e o que está prestes a ser liberado.

• GET /api/v1/tokenUnlocks/{coinSlug} – fornece um cronograma detalhado de desbloqueio para um token específico. Mostra datas, quantos tokens estão sendo desbloqueados e para quem eles são (como equipe ou investidores iniciais).

Existem também outros endpoints úteis:

• supportedCoins – mostra todos os tokens com dados de desbloqueio

• chart/{coin} – permite traçar a atividade de desbloqueio ao longo do tempo

Como esses dados estão disponíveis através de uma API, você pode criar bots ou painéis que rastreiam desbloqueios automaticamente. Não é mais necessário adivinhar quando grandes lançamentos estão chegando — seu aplicativo ou bot pode alertar as pessoas com antecedência.

Começando: Acessando a API DropsTab

Antes de construir seu bot do Telegram, você precisa obter uma chave de API do DropsTab. Esta chave lhe dá permissão para usar os dados deles em seu projeto.

Aqui está a parte boa: Se você é um estudante, desenvolvedor independente ou parte de um hackathon, pode obter a chave gratuitamente ao se juntar ao DropsTab Builders Program. Isso lhe dá acesso a dados importantes como desbloqueios de tokens por pelo menos 3 meses — sem pagar nada.

Depois de receber sua chave de API (uma longa combinação de letras e números), mantenha-a segura e não a compartilhe. Você precisará incluí-la em suas solicitações assim:

Authorization: Bearer YOUR_API_KEY

Todas as solicitações de API passam por este URL base: https://public-api.dropstab.com/api/v1/

Experimente no Terminal

Você não precisa escrever um programa completo para verificar se funciona. Abra seu terminal e use curl para fazer um teste rápido. Veja como obter o preço do Bitcoin em 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 retornará os dados de preço em formato JSON.

Para verificar os próximos desbloqueios de tokens, use este comando:

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

Quantas solicitações você pode fazer?

O plano gratuito oferece a você:

• Até 100 solicitações por minuto
• 100.000 solicitações por mês

Isso é mais do que suficiente para um bot ou ferramenta básica. E se o seu projeto crescer, você pode mudar para um plano de nível superior para mais potência — tudo sem mudar seu código. A API permanece a mesma.

Quer mais detalhes? Confira a documentação completa da API aqui: https://dropstab.com/pt/products/commercial-api

Buscando desbloqueios de tokens futuros via API

Depois de obter sua chave de API, você pode usar Python para verificar quais tokens estão prestes a desbloquear. O endpoint DropsTab /tokenUnlocks mostra uma lista de tokens com eventos de desbloqueio próximos. Ele informa o nome do token, a data de desbloqueio, quanto será desbloqueado e qual porcentagem do seu suprimento total isso representa.

Aqui está um exemplo simples de Python que envia uma solicitação para a API e imprime as informações:

import requests

API_KEY = "YOUR_API_KEY"  # Substitua isso pelo seu chave API real do 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()

# Percorra cada evento de desbloqueio e mostre os 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} desbloqueia {percent}% do fornecimento em {date} (cerca de {amount} tokens)")

Como é a Resposta da API

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

Este exemplo significa que Aptos desbloqueará 1.13% de sua oferta (cerca de 11,3 milhões de tokens) em 12 de agosto de 2025.

DropsTab coleta essas informações de fontes públicas como whitepapers ou contratos blockchain, para que você não precise procurar por conta própria. Se você quiser o cronograma completo para um token, basta usar /tokenUnlocks/{coinSlug} — por exemplo: /tokenUnlocks/aptos.

Mas se o seu bot estiver monitorando muitos tokens ao mesmo tempo, o endpoint geral /tokenUnlocks é o melhor. Ele fornece todos os desbloqueios futuros de uma só vez.

Alguns desbloqueios podem também mostrar informações extras, como se são para a equipe, investidores ou a comunidade. Você pode usar isso para tornar seus alertas ainda mais úteis.

Filtrando Eventos de Desbloqueio Significativos

Alguns são tão pequenos (como 0,5% do suprimento total) que não afetam realmente o mercado. Se o seu bot alertar as pessoas sobre cada pequeno evento, isso apenas as irritará.

Para corrigir isso, podemos definir um limiar mínimo — um número que decide o que vale a pena alertar. Uma escolha comum é 5%. Isso significa que seu bot só enviará alertas se o desbloqueio for de 5% ou mais do fornecimento total de tokens.

Veja como você pode adicionar esse filtro em Python:

threshold = 5.0  # Alertar apenas se o desbloqueio for de 5% ou mais

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} desbloqueia {percent}% de sua oferta em {date}!"
        print(alert_text)

Este código verifica cada evento e imprime um alerta apenas se atender ao limite escolhido. Portanto, se um token desbloquear 3,2%, ele não aparecerá. Mas se outro desbloquear 10%, ele aparecerá.

Alguns desbloqueios são projetados com justiça ou distribuição estratégica em mente. Por exemplo, conforme observado por World Liberty Financial:

“Apenas uma parte dos tokens comprados na venda pública que foram adquiridos a $0,015 e $0,05 serão desbloqueados inicialmente – isso recompensa diretamente nossos primeiros apoiadores de varejo e ninguém mais. Além disso, tokens do tesouro puramente para fornecer liquidez. Isso mantém a comunidade como o foco principal.”

Isso mostra por que não se trata apenas de quanto é desbloqueado, mas para quem é desbloqueado e por quê—outra razão para contextualizar os alertas cuidadosamente.

Você pode alterar o limite com base no tipo de tokens que está acompanhando. Para moedas de pequena capitalização, talvez 3% seja um grande negócio. Para tokens de grandes nomes, você pode se importar apenas com eventos acima de 10%.

Além disso, como as datas de desbloqueio vêm em um formato padrão, você pode classificá-las ou adicionar filtros extras (como olhar apenas para desbloqueios nas próximas 24 horas). Você poderia até fazer seu bot verificar uma vez por dia para manter os alertas atualizados e úteis.

Enviando alertas para o Telegram em tempo real

Uma vez que seu script encontre um grande desbloqueio de token, é hora de informar seus usuários do Telegram. A maneira mais fácil de fazer isso é usando a python-telegram-bot library (versão 20+).

Passo 1: Crie seu Bot do Telegram

• Abra o Telegram e envie uma mensagem para @BotFather
• Digite /newbot para criar um novo bot e obter seu bot token
• Salve o token em algum lugar seguro
• Escolha onde o bot enviará mensagens (seu próprio chat, um grupo ou um canal)

Passo 2: Instale a Biblioteca Python

Abra seu terminal e digite:

pip install python-telegram-bot

Etapa 3: Enviar Alertas do Seu Código

Adicione isso ao seu script para enviar uma mensagem quando um grande desbloqueio for encontrado:

from telegram import Bot

BOT_TOKEN = "YOUR_TELEGRAM_BOT_TOKEN"  # seu token do BotFather
CHAT_ID = "YOUR_CHAT_ID"  # seu ID de usuário ou um ID de grupo/canal

bot = Bot(token=BOT_TOKEN)

# Enviar uma mensagem quando um grande desbloqueio for encontrado:
if percent >= threshold:
    alert_text = f"🚨 Alerta de Desbloqueio de Token: {coin} irá desbloquear {percent}% do suprimento em {date}"
    bot.send_message(chat_id=CHAT_ID, text=alert_text)

O que o Bot Fará

Seu bot do Telegram enviará uma mensagem assim:

🚨 Alerta de Desbloqueio de Token: Aptos desbloqueará 1,13% do suprimento em 2025-08-12

A biblioteca lida com tudo em segundo plano. Apenas certifique-se de que o bot está autorizado a postar no chat escolhido.

Quando Deve Enviar Alertas?

Você não precisa esperar até que o desbloqueio aconteça. A API DropsTab fornece as datas de desbloqueio com antecedência. Isso significa que seu bot pode avisar os usuários antecipadamente. Você pode:

• Execute o script uma vez por dia para alertar sobre desbloqueios que ocorrerão nas próximas 24 horas
• Ou execute-o a cada hora para capturar eventos que ocorrerão em breve

Como DropsTab mantém seus dados atualizados em tempo real, seu bot sempre terá informações frescas. Esta configuração é ótima para um bot de alerta simples. Mais tarde, você pode melhorá-lo com recursos de agendamento ou assíncronos. Mas para começar, tudo o que você precisa é de um filtro e uma chamada para bot.send_message() para que os alertas comecem a funcionar.

Maneiras de Executar Seu Bot

Você tem algumas maneiras fáceis de manter seu bot funcionando em um cronograma:

1. Tarefa Cron ou Agendador

Execute seu script uma vez a cada hora ou dia. Você pode usar:

• cron (para Linux/Mac)
• Task Scheduler (para Windows)
• Um loop em Python usando time.sleep()

O plano gratuito da API DropsTab oferece 100 solicitações por minuto, então fazer isso a cada hora não é problema.

2. Funções em Nuvem

Use uma plataforma serverless para executar seu bot automaticamente, como:

• AWS Lambda
• Google Cloud Functions

Dessa forma, você não precisa manter seu computador ou servidor funcionando 24/7.

3. Bot Sempre Ativo

Se o seu bot tiver comandos (como "/nextunlock Aptos"), você pode executá-lo o tempo todo. Use polling ou webhooks para escutar mensagens e execute seu verificador de desbloqueio em segundo plano.

Expandindo o Caso de Uso

Agora que seu bot pode capturar dados de desbloqueio, filtrá-los e enviar alertas, você pode torná-lo ainda mais útil adicionando mais recursos da API DropsTab.

À medida que mais projetos experimentam modelos alternativos de desbloqueio, bots também podem rastrear mudanças de vesting ou alterações súbitas de TGE. Por exemplo, a Theoriq recentemente surpreendeu o mercado ao remover completamente o vesting:

“Removemos os termos de aquisição da venda comunitária e todas as alocações de tokens serão 100% desbloqueadas no TGE.” (via @TheoriqAI, destacado por @Va77ss)

Essas mudanças valem a pena ser alertadas — especialmente em um mercado cético em relação a desbloqueios lentos e pesados para insiders.

Novos Tipos de Alertas

DropsTab não mostra apenas desbloqueios de tokens. Também inclui:

• Rodadas de financiamento VC (/fundingRounds) — quando um projeto recebe novo investimento
• Portfólios de investidores (/investors) — quem possui o quê
• Atividades de cripto (/cryptoActivities) — como listagens em exchanges ou atualizações de protocolo

Com isso, você poderia:

• Envie um alerta quando um token for listado em uma nova exchange
• Notifique os usuários quando um projeto receber novos financiamentos
• Observe o que grandes investidores estão fazendo e envie atualizações

Isso transformaria seu bot em um feed completo de notícias de criptomoedas.

Adicionar Informações de Preço do Token

Quer dar mais contexto aos usuários? Você pode obter dados de preços usando o endpoint /coins. Combine isso com alertas de desbloqueio e mostre quanto valor está sendo liberado.

Exemplo:

Token X desbloqueia 10% do fornecimento amanhã — isso é cerca de $5 milhões ao preço atual.

Adicionar contexto de preço ajuda os usuários a entender se um desbloqueio pode desencadear volatilidade ou simplesmente se misturar em tendências mais amplas. Como Glassnode observou recentemente:

“O indicador #Altseason proprietário da Glassnode disparou… o capital está fluindo para $BTC e $ETH, e… a capitalização de mercado das altcoins está aumentando – um ambiente estrutural propício para a rotação de capital.”

Neste tipo de ambiente, eventos de desbloqueio podem coincidir com aumento da demanda—tornando alguns lançamentos menos pessimistas do que parecem isoladamente.

Mantenha Simples — Uma API

Tudo isso vem de um lugar — a API DropsTab. Você não precisa adicionar serviços ou ferramentas extras. Basta usar diferentes endpoints da mesma API. Isso mantém seu código limpo e tudo consistente.