Comment créer un bot Telegram pour surveiller les déblocages de tokens crypto

Pourquoi suivre les événements de déverrouillage des tokens ?

Certains tokens sont "verrouillés" pendant un certain temps après leur création. Cela signifie qu'ils ne peuvent pas être échangés immédiatement. Ces verrouillages sont généralement là pour empêcher les membres de l'équipe ou les investisseurs de vendre trop tôt. Mais une fois le verrouillage terminé, ces tokens peuvent arriver sur le marché en une seule fois.

Lorsque de nombreux tokens se déverrouillent en même temps, l'offre totale augmente rapidement. Cela peut entraîner une baisse de prix car plus de personnes peuvent commencer à vendre. Ces événements de déverrouillage peuvent vraiment affecter la performance d'un token sur le marché.

Suivre les déblocages ne consiste pas seulement à regarder un compte à rebours — il s'agit de comprendre comment l'offre verrouillée soutient le prix et ce qui se passe lorsque ce soutien disparaît. Comme @digitalartchick le dit :

« Le contrôle de l'offre est haussier, mais lorsque ces pièces entrent en circulation, cela pèse à jamais sur la pièce. »

Cela souligne pourquoi les déblocages de tokens ne sont pas seulement des événements à « traverser » — ils modifient fondamentalement la dynamique du marché du token.

Si vous êtes au courant d'un déverrouillage à venir à l'avance, vous pouvez être prêt. Disons qu'un projet est sur le point de déverrouiller 20% de son approvisionnement total demain — les personnes qui sont entrées tôt pourraient vendre. Envoyer une alerte Telegram avant que cela ne se produise donne un avertissement à votre communauté.

Les graphiques de prix ne montrent pas toujours l'image complète. Ils vous indiquent quand quelque chose s'est produit, mais pas pourquoi. Suivre les déblocages de tokens vous donne le "pourquoi".

Le défi de suivre les calendriers d'acquisition

Même si les déblocages de tokens sont importants, ils sont étonnamment difficiles à suivre. Les API populaires comme CoinGecko ou CoinMarketCap montrent des données de prix et de volume, mais elles n'incluent pas d'informations sur les événements de déblocage de tokens ou les calendriers d'acquisition. Ces plateformes se concentrent sur ce qui se passe maintenant ou dans le passé, pas sur ce qui vient ensuite.

Les outils d'analyse on-chain comme Nansen peuvent montrer les mouvements de portefeuille ou l'activité des baleines, mais ils n'offrent pas non plus un moyen simple de voir les déblocages à venir. Vous ne pouvez pas simplement appeler une fonction comme getUpcomingUnlocks() et obtenir ce dont vous avez besoin.

Pour cette raison, de nombreux développeurs essaient de collecter les données manuellement : lire des livres blancs, suivre des articles de blog ou analyser les transactions de contrats blockchain. D'autres se tournent vers des outils comme Dune ou Bitquery, écrivant des requêtes SQL ou GraphQL pour détecter les événements de déverrouillage. Ces méthodes fonctionnent, mais elles sont chronophages, complexes et doivent être construites séparément pour chaque token.

Il n'y a pas de moyen standard pour accéder à toutes les données de déverrouillage en un seul endroit. Elles sont dispersées, difficiles à mettre à jour et ne sont pas en temps réel. C'est pourquoi les développeurs ont besoin d'une API unifiée qui rend le suivi de la maturation des tokens simple, précis et évolutif.

API DropsTab – Combler le fossé des données

L'API DropsTab facilite grandement le travail avec les données crypto. Elle ne montre pas seulement les prix et les graphiques — elle vous donne également des détails importants comme les calendriers de déverrouillage des tokens, les tours de financement, et quels investisseurs détiennent quoi. Vous obtenez à la fois des informations de marché régulières et des données plus approfondies sur les tokens en un seul endroit.

C’est comme combiner CoinGecko et Nansen en une seule API, mais avec une fonctionnalité supplémentaire que la plupart des autres n’offrent pas : suivi de déverrouillage. Donc, au lieu de passer d'une plateforme à l'autre, vous pouvez utiliser DropsTab pour obtenir une vue complète de n'importe quel projet de token.

En ce qui concerne les déblocages, ces deux appels API sont essentiels :

• GET /api/v1/tokenUnlocks – montre tous les tokens avec des événements de déverrouillage à venir ou déjà en cours. Vous verrez combien est encore verrouillé et ce qui est sur le point d'être libéré.

• GET /api/v1/tokenUnlocks/{coinSlug} – fournit un calendrier détaillé de déverrouillage pour un jeton spécifique. Il montre les dates, combien de jetons sont déverrouillés et pour qui ils sont (comme l'équipe ou les premiers investisseurs).

Il existe également d'autres points de terminaison utiles :

• supportedCoins – affiche tous les tokens avec des données de déverrouillage

• chart/{coin} – vous permet de tracer l'activité de déverrouillage au fil du temps

Étant donné que ces données sont disponibles via une API, vous pouvez créer des bots ou des tableaux de bord qui suivent les déblocages automatiquement. Plus besoin de deviner quand les grandes sorties arrivent — votre application ou bot peut alerter les gens à l'avance.

Commencer : Accéder à l'API DropsTab

Avant de créer votre bot Telegram, vous devez obtenir une clé API de DropsTab. Cette clé vous donne la permission d'utiliser leurs données dans votre projet.

Voici la bonne nouvelle: Si vous êtes étudiant, développeur indépendant ou participez à un hackathon, vous pouvez obtenir la clé gratuitement en rejoignant le DropsTab Builders Program. Cela vous donne accès à des données importantes comme les déblocages de tokens pendant au moins 3 mois — sans rien payer.

Une fois que vous recevez votre clé API (un long mélange de lettres et de chiffres), gardez-la en sécurité et ne la partagez pas. Vous devrez l'inclure dans vos requêtes comme ceci :

Authorization: Bearer YOUR_API_KEY

Toutes les requêtes API passent par cette URL de base : https://public-api.dropstab.com/api/v1/

Essayez-le dans le terminal

Vous n'avez pas besoin d'écrire un programme complet pour vérifier si cela fonctionne. Ouvrez votre terminal et utilisez curl pour faire un test rapide. Voici comment obtenir le prix du Bitcoin le 1er août 2025 :

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

Cette commande renverra les données de prix au format JSON.

Pour vérifier les déverrouillages de jetons à venir, utilisez cette commande :

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

Combien de demandes pouvez-vous faire?

Le plan gratuit vous donne :

• Jusqu'à 100 requêtes par minute
• 100 000 requêtes par mois

C'est plus que suffisant pour un bot ou un outil de base. Et si votre projet se développe, vous pouvez passer à un plan de niveau supérieur pour plus de puissance — le tout sans changer votre code. L'API reste la même.

Vous voulez plus de détails ? Consultez la documentation complète de l'API ici : https://dropstab.com/fr/products/commercial-api

Récupération des déverrouillages de jetons à venir via l'API

Une fois que vous avez votre clé API, vous pouvez utiliser Python pour vérifier quels tokens sont sur le point de se déverrouiller. Le point de terminaison DropsTab /tokenUnlocks montre une liste de tokens avec des événements de déverrouillage à venir. Il vous indique le nom du token, la date de déverrouillage, combien sera déverrouillé, et quel pourcentage de son approvisionnement total cela représente.

Voici un exemple simple en Python qui envoie une requête à l'API et affiche les informations :

import requests

API_KEY = "YOUR_API_KEY"  # Remplacez ceci par votre clé API DropsTab réelle
url = "https://public-api.dropstab.com/api/v1/tokenUnlocks"

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

# Parcourez chaque événement de déverrouillage et affichez les résultats
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} débloque {percent}% de l'offre le {date} (environ {amount} tokens)")

À quoi ressemble la réponse de l'API

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

Cet exemple signifie que Aptos débloquera 1.13% de son approvisionnement (environ 11,3 millions de tokens) le 12 août 2025.

DropsTab recueille ces informations à partir de sources publiques comme les livres blancs ou les contrats blockchain, afin que vous n'ayez pas à chercher vous-même. Si vous voulez le calendrier complet pour un token, utilisez simplement /tokenUnlocks/{coinSlug} — par exemple : /tokenUnlocks/aptos.

Mais si votre bot surveille de nombreux tokens à la fois, le point de terminaison général /tokenUnlocks est le meilleur. Il vous donne tous les déblocages à venir en une seule fois.

Certains déblocages peuvent également afficher des informations supplémentaires, comme s'ils sont destinés à l'équipe, aux investisseurs ou à la communauté. Vous pouvez utiliser cela pour rendre vos alertes encore plus utiles.

Filtrage des événements de déverrouillage significatifs

Certains sont si petits (comme 0,5 % de l'offre totale) qu'ils n'affectent pas vraiment le marché. Si votre bot alerte les gens sur chaque petit événement, cela va juste les agacer.

Pour résoudre cela, nous pouvons définir un seuil minimum — un nombre qui décide de ce qui vaut la peine d'être signalé. Un choix courant est 5%. Cela signifie que votre bot n'enverra des alertes que si le déblocage représente 5% ou plus de l'offre totale de tokens.

Voici comment vous pouvez ajouter ce filtre en Python :

seuil = 5.0  # Alerte uniquement si le déverrouillage est de 5% ou plus

pour événement dans data.get('data', []):
    pourcentage = événement.get('percentage', 0)
    pièce = événement.get('coin')
    date = événement.get('date')

    si pourcentage >= seuil:
        texte_alerte = f"ALERTE : {pièce} déverrouille {pourcentage}% de son approvisionnement le {date}!"
        print(texte_alerte)

Ce code vérifie chaque événement et affiche une alerte uniquement s'il atteint votre seuil choisi. Donc, si un token se déverrouille à 3,2 %, il n'apparaîtra pas. Mais si un autre se déverrouille à 10 %, il le fera.

Certains déblocages sont conçus avec l'équité ou la distribution stratégique à l'esprit. Par exemple, comme noté par World Liberty Financial:

“Seule une partie des tokens achetés lors de la vente publique qui ont été achetés à 0,015 $ et 0,05 $ sera débloquée initialement – cela récompense directement nos premiers croyants du commerce de détail et personne d'autre. De plus, des tokens de trésorerie purement pour semer la liquidité. Cela garde la communauté au centre de l'attention.”

Cela montre pourquoi il ne s'agit pas seulement de combien se déverrouille, mais pour qui cela se déverrouille et pourquoi—une autre raison de contextualiser les alertes avec soin.

Vous pouvez modifier le seuil en fonction du type de tokens que vous suivez. Pour les pièces à petite capitalisation, peut-être que 3% est une affaire importante. Pour les tokens de grande renommée, vous pourriez ne vous soucier que des événements supérieurs à 10%.

De plus, comme les dates de déverrouillage sont dans un format standard, vous pouvez les trier ou ajouter des filtres supplémentaires (comme ne regarder que les déverrouillages dans les prochaines 24 heures). Vous pourriez même faire en sorte que votre bot vérifie une fois par jour pour garder les alertes fraîches et utiles.

Envoi d'alertes à Telegram en temps réel

Une fois que votre script trouve un grand déverrouillage de token, il est temps d'informer vos utilisateurs Telegram. Le moyen le plus simple de le faire est d'utiliser la python-telegram-bot library (version 20+).

Étape 1 : Créez votre bot Telegram

• Ouvrez Telegram et envoyez un message à @BotFather
• Tapez /newbot pour créer un nouveau bot et obtenir votre bot token
• Enregistrez le token dans un endroit sûr
• Choisissez où le bot enverra les messages (votre propre chat, un groupe ou un canal)

Étape 2 : Installer la bibliothèque Python

Ouvrez votre terminal et tapez :

pip install python-telegram-bot

Étape 3 : Envoyer des alertes depuis votre code

Ajoutez ceci à votre script pour envoyer un message lorsqu'un grand déverrouillage est trouvé :

from telegram import Bot

BOT_TOKEN = "YOUR_TELEGRAM_BOT_TOKEN"  # votre token de BotFather
CHAT_ID = "YOUR_CHAT_ID"  # votre ID utilisateur ou un ID de groupe/chaîne

bot = Bot(token=BOT_TOKEN)

# Envoyer un message lorsqu'un grand déverrouillage est trouvé :
if percent >= threshold:
    alert_text = f"🚨 Alerte de déverrouillage de token : {coin} déverrouillera {percent}% de l'offre le {date}"
    bot.send_message(chat_id=CHAT_ID, text=alert_text)

Ce que le Bot fera

Votre bot Telegram enverra un message comme celui-ci :

🚨 Alerte de déverrouillage de jeton : Aptos déverrouillera 1,13 % de l'offre le 2025-08-12

La bibliothèque gère tout en arrière-plan. Assurez-vous simplement que le bot est autorisé à publier dans le chat choisi.

Quand devrait-il envoyer des alertes?

Vous n'avez pas besoin d'attendre que le déverrouillage se produise. L'API DropsTab vous donne les dates de déverrouillage à l'avance. Cela signifie que votre bot peut avertir les utilisateurs à l'avance. Vous pouvez :

• Exécutez le script une fois par jour pour alerter des déverrouillages à venir dans les prochaines 24 heures
• Ou exécutez-le toutes les heures pour détecter les événements à venir bientôt

Étant donné que DropsTab maintient ses données à jour en temps réel, votre bot disposera toujours d'informations fraîches. Cette configuration est idéale pour un bot d'alerte simple. Plus tard, vous pourrez l'améliorer avec des fonctionnalités de planification ou asynchrones. Mais pour commencer, tout ce dont vous avez besoin est un filtre et un appel à bot.send_message() pour que les alertes soient opérationnelles.

Façons de faire fonctionner votre bot

Vous avez quelques moyens simples de garder votre bot en fonctionnement selon un calendrier :

1. Tâche Cron ou Planificateur

Exécutez votre script une fois par heure ou par jour. Vous pouvez utiliser :

• cron (pour Linux/Mac)
• Task Scheduler (pour Windows)
• Une boucle Python utilisant time.sleep()

Le plan API gratuit de DropsTab vous offre 100 requêtes par minute, donc le faire toutes les heures ne pose aucun problème.

2. Fonctions Cloud

Utilisez une plateforme sans serveur pour exécuter votre bot automatiquement, comme :

• AWS Lambda
• Google Cloud Functions

De cette façon, vous n'avez pas besoin de garder votre ordinateur ou serveur en marche 24/7.

3. Bot Toujours Actif

Si votre bot a des commandes (comme "/nextunlock Aptos"), vous pouvez le faire fonctionner tout le temps. Utilisez le polling ou les webhooks pour écouter les messages, et exécutez votre vérificateur de déverrouillage en arrière-plan.

Élargir le cas d'utilisation

Maintenant que votre bot peut récupérer des données de déverrouillage, les filtrer et envoyer des alertes, vous pouvez le rendre encore plus utile en ajoutant plus de fonctionnalités de l'API DropsTab.

Alors que de plus en plus de projets expérimentent des modèles de déverrouillage alternatifs, les bots peuvent également suivre les changements de vesting ou les retournements soudains de TGE. Par exemple, Theoriq a récemment surpris le marché en supprimant complètement le vesting :

“Nous avons supprimé les conditions de vesting de la vente communautaire et toutes les allocations de tokens seront débloquées à 100% au TGE.” (via @TheoriqAI, mis en évidence par @Va77ss)

Ces changements valent la peine d'être signalés — surtout dans un marché sceptique vis-à-vis des déblocages progressifs et des déverrouillages lourds d'initiés.

Nouveaux types d'alertes

DropsTab ne montre pas seulement les déverrouillages de tokens. Il inclut également :

• Tours de financement VC (/fundingRounds) — lorsqu'un projet obtient un nouvel investissement
• Portefeuilles d'investisseurs (/investors) — qui possède quoi
• Activités crypto (/cryptoActivities) — comme les inscriptions sur les échanges ou les mises à niveau de protocoles

Avec cela, vous pourriez :

• Envoyer une alerte lorsqu'un token est listé sur une nouvelle bourse
• Notifier les utilisateurs lorsqu'un projet obtient un nouveau financement
• Observer ce que font les grands investisseurs et envoyer des mises à jour

Cela transformerait votre bot en un flux d'actualités crypto complet.

Ajouter des informations sur le prix du token

Vous voulez donner plus de contexte aux utilisateurs ? Vous pouvez récupérer les données de prix en utilisant l'endpoint /coins. Combinez cela avec des alertes de déverrouillage et montrez combien de valeur est libérée.

Exemple :

Token X déverrouille 10% de l'offre demain — c'est environ 5 millions de dollars au prix actuel.

Ajouter un contexte de prix aide les utilisateurs à comprendre si un déverrouillage pourrait déclencher de la volatilité ou simplement se fondre dans des tendances plus larges. Comme l'a récemment noté Glassnode :

« L'indicateur #Altseason propriétaire de Glassnode s'est déclenché… le capital afflue vers $BTC et $ETH, et… la capitalisation boursière des altcoins augmente – un environnement structurel propice à la rotation du capital. »

Dans ce type d'environnement, les événements de déverrouillage pourraient coïncider avec une demande accrue, rendant certaines sorties moins baissières qu'elles ne le paraissent isolément.

Gardez-le simple — Une API

Tout cela provient d'un seul endroit — l'API DropsTab. Vous n'avez pas besoin d'ajouter des services ou outils supplémentaires. Utilisez simplement différents points de terminaison de la même API. Cela garde votre code propre et tout cohérent.