Як створити Telegram-бота для моніторингу розблокувань криптотокенів

Чому відстежувати події розблокування токенів?

Деякі токени "заблоковані" на деякий час після їх створення. Це означає, що вони не можуть бути відразу продані. Ці блокування зазвичай існують, щоб запобігти продажу з боку членів команди або інвесторів занадто рано. Але коли блокування закінчується, ці токени можуть одночасно вийти на ринок.

Коли багато токенів розблоковуються одночасно, загальна пропозиція швидко зростає. Це може призвести до падіння ціни, оскільки більше людей можуть почати продавати. Такі події розблокування можуть дійсно вплинути на те, як токен поводиться на ринку.

Відстеження розблокувань — це не лише про спостереження за зворотним відліком, а й про розуміння того, як заблокована пропозиція підтримує ціну і що відбувається, коли ця підтримка зникає. Як @digitalartchick висловлюється:

“Контроль пропозиції є бичачим, але коли ці монети входять в обіг, це назавжди обтяжує монету.”

Це підкреслює, чому розблокування токенів не є просто подіями, які потрібно «пережити» — вони фундаментально змінюють ринкову динаміку токена.

Якщо ви знаєте про майбутнє розблокування заздалегідь, ви можете бути готові. Припустимо, проект збирається розблокувати 20% від загальної пропозиції завтра — люди, які зайшли раніше, можуть продати. Надсилання сповіщення в Telegram до того, як це станеться, дає вашій спільноті попередження.

Цінові графіки не завжди показують повну картину. Вони показують, коли щось сталося, але не чому. Відстеження розблокування токенів дає вам "чому".

Проблема відстеження графіків надання прав

Хоча розблокування токенів є важливими, їх важко відстежити. Популярні API, такі як CoinGecko або CoinMarketCap, показують дані про ціну та обсяг, але не включають інформацію про події розблокування токенів або графіки надання прав. Ці платформи зосереджуються на тому, що відбувається зараз або в минулому, а не на тому, що буде далі.

Інструменти аналітики на блокчейні, такі як Nansen, можуть показувати рухи гаманців або активність китів, але вони також не пропонують простий спосіб побачити майбутні розблокування. Ви не можете просто викликати функцію на кшталт getUpcomingUnlocks() і отримати те, що вам потрібно.

Через це багато розробників намагаються збирати дані вручну: читаючи whitepapers, стежачи за блогами або аналізуючи транзакції контрактів блокчейну. Інші звертаються до інструментів, таких як Dune або Bitquery, пишучи SQL або GraphQL запити для виявлення подій розблокування. Ці методи працюють, але вони займають багато часу, складні і їх потрібно створювати окремо для кожного токена.

Немає стандартного способу доступу до всіх даних про розблокування в одному місці. Вони розкидані, їх важко оновлювати, і вони не в реальному часі. Ось чому розробникам потрібен уніфікований API, який робить відстеження вестингу токенів простим, точним і масштабованим.

API DropsTab – Подолання розриву в даних

API DropsTab значно спрощує роботу з криптоданими. Він не лише показує ціни та графіки — він також надає важливі деталі, такі як графіки розблокування токенів, раунди фінансування та які інвестори що тримають. Ви отримуєте як звичайну ринкову інформацію, так і глибші дані про токени в одному місці.

Це як поєднання CoinGecko та Nansen в одному API, але з додатковою функцією, яку більшість інших не пропонують: відстеження розблокування. Тож замість перемикання між різними платформами, ви можете використовувати DropsTab, щоб отримати повний огляд будь-якого токен-проекту.

Коли справа доходить до розблокувань, ці два виклики API є ключовими:

• GET /api/v1/tokenUnlocks – показує всі токени з подіями розблокування, що наближаються або вже відбуваються. Ви побачите, скільки ще заблоковано і що збирається бути випущено.

• GET /api/v1/tokenUnlocks/{coinSlug} – надає детальний графік розблокування для одного конкретного токена. Він показує дати, скільки токенів розблоковується, і для кого вони призначені (наприклад, для команди або ранніх інвесторів).

Існують також інші корисні кінцеві точки:

• supportedCoins – показує всі токени з даними про розблокування

• chart/{coin} – дозволяє відображати активність розблокування з часом

Оскільки ці дані доступні через API, ви можете створювати боти або інформаційні панелі, які автоматично відстежують розблокування. Більше не потрібно гадати, коли відбудуться великі релізи — ваш додаток або бот можуть заздалегідь попереджати людей.

Початок роботи: Доступ до API DropsTab

Перш ніж створити свого Telegram-бота, вам потрібно отримати API ключ від DropsTab. Цей ключ дає вам дозвіл використовувати їхні дані у вашому проєкті.

Ось хороша частина: Якщо ви студент, незалежний розробник або учасник хакатону, ви можете отримати ключ безкоштовно, приєднавшись до DropsTab Builders Program. Це дає вам доступ до важливих даних, таких як розблокування токенів, принаймні на 3 місяці — безкоштовно.

Отримавши свій API ключ (довга суміш літер і цифр), зберігайте його в безпеці і не діліться ним. Вам потрібно буде включити його у ваші запити таким чином:

Authorization: Bearer YOUR_API_KEY

Всі запити API проходять через цю базову URL-адресу: https://public-api.dropstab.com/api/v1/

Спробуйте в Терміналі

Вам не потрібно писати повну програму, щоб перевірити, чи це працює. Відкрийте свій термінал і використовуйте curl для швидкого тесту. Ось як отримати ціну Bitcoin на 1 серпня 2025 року:

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

Ця команда поверне дані про ціну у форматі JSON.

Щоб перевірити майбутні розблокування токенів, використовуйте цю команду:

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

Скільки запитів ви можете зробити?

Безкоштовний план надає вам:

• До 100 запитів на хвилину
• 100 000 запитів на місяць

Цього більш ніж достатньо для базового бота або інструменту. І якщо ваш проєкт зростає, ви можете перейти на план вищого рівня для більшої потужності — все без зміни вашого коду. API залишається тим самим.

Бажаєте більше деталей? Перегляньте повну документацію API тут: https://dropstab.com/uk/products/commercial-api

Отримання майбутніх розблокувань токенів через API

Отримавши свій API ключ, ви можете використовувати Python, щоб перевірити, які токени збираються розблокувати. Кінцева точка DropsTab /tokenUnlocks показує список токенів з майбутніми подіями розблокування. Вона повідомляє назву токена, дату розблокування, скільки буде розблоковано і який це відсоток від загальної пропозиції.

Ось простий приклад на Python, який надсилає запит до API та виводить інформацію:

import requests

API_KEY = "YOUR_API_KEY"  # Замініть це на ваш фактичний DropsTab API ключ
url = "https://public-api.dropstab.com/api/v1/tokenUnlocks"

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

# Перегляньте кожну подію розблокування та покажіть результати
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} розблоковує {percent}% постачання на {date} (близько {amount} токенів)")

Як виглядає відповідь API

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

Цей приклад означає, що Aptos розблокує 1.13% своєї пропозиції (близько 11,3 мільйона токенів) 12 серпня 2025 року.

DropsTab збирає цю інформацію з публічних джерел, таких як whitepapers або блокчейн контракти, щоб вам не довелося шукати самостійно. Якщо ви хочете отримати повний графік для одного токена, просто використовуйте /tokenUnlocks/{coinSlug} — наприклад: /tokenUnlocks/aptos.

Але якщо ваш бот стежить за багатьма токенами одночасно, загальний /tokenUnlocks endpoint є найкращим. Він надає вам усі майбутні розблокування за один раз.

Деякі розблокування можуть також показувати додаткову інформацію, наприклад, чи вони для команди, інвесторів або спільноти. Ви можете використовувати це, щоб зробити ваші сповіщення ще більш корисними.

Фільтрація значних подій розблокування

Деякі з них настільки малі (наприклад, 0,5% від загальної пропозиції), що вони насправді не впливають на ринок. Якщо ваш бот сповіщає людей про кожну дрібну подію, це просто дратуватиме їх.

Щоб це виправити, ми можемо встановити мінімальний поріг — число, яке визначає, що варто повідомляти. Звичайний вибір - 5%. Це означає, що ваш бот буде надсилати сповіщення лише якщо розблокування становить 5% або більше від загальної пропозиції токенів.

Ось як ви можете додати цей фільтр у Python:

threshold = 5.0  # Сповіщати лише якщо розблокування становить 5% або більше

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"УВАГА: {coin} розблоковує {percent}% свого запасу {date}!"
        print(alert_text)

Цей код перевіряє кожну подію та друкує сповіщення лише в тому випадку, якщо вона відповідає обраному вами порогу. Тож якщо токен розблоковує 3.2%, він не з'явиться. Але якщо інший розблоковує 10%, він з'явиться.

Деякі розблокування розроблені з урахуванням справедливості або стратегічного розподілу. Наприклад, як зазначено World Liberty Financial:

“Лише частина токенів, придбаних на публічному продажу за ціною $0.015 та $0.05, буде розблокована спочатку – це безпосередньо винагороджує наших ранніх роздрібних прихильників і нікого іншого. Крім того, казначейські токени виключно для забезпечення ліквідності. Це зберігає спільноту в центрі уваги.”

Це показує, чому справа не лише в тому, скільки розблоковується, але й для кого воно розблоковується і чому — ще одна причина ретельно контекстуалізувати сповіщення.

Ви можете змінити поріг залежно від того, які токени ви відстежуєте. Для монет з малою капіталізацією, можливо, 3% - це велика справа. Для відомих токенів вас можуть цікавити лише події понад 10%.

Крім того, оскільки дати розблокування подані у стандартному форматі, ви можете сортувати їх або додавати додаткові фільтри (наприклад, переглядати лише розблокування протягом наступних 24 годин). Ви навіть можете налаштувати свого бота перевіряти раз на день, щоб сповіщення були актуальними та корисними.

Надсилання сповіщень до Telegram у режимі реального часу

Як тільки ваш скрипт знаходить велике розблокування токенів, настав час повідомити ваших користувачів у Telegram. Найпростіший спосіб зробити це - використати python-telegram-bot library (версія 20+).

Крок 1: Створіть свого Telegram-бота

• Відкрийте Telegram і надішліть повідомлення @BotFather
• Введіть /newbot щоб створити нового бота і отримати ваш bot token
• Збережіть токен у безпечному місці
• Виберіть, куди бот буде надсилати повідомлення (ваш власний чат, група або канал)

Крок 2: Встановіть бібліотеку Python

Відкрийте свій термінал і введіть:

pip install python-telegram-bot

Крок 3: Надсилайте сповіщення з вашого коду

Додайте це до свого скрипту, щоб надіслати повідомлення, коли знайдено велике розблокування:

from telegram import Bot

BOT_TOKEN = "YOUR_TELEGRAM_BOT_TOKEN"  # ваш токен від BotFather
CHAT_ID = "YOUR_CHAT_ID"  # ваш ID користувача або ID групи/каналу

bot = Bot(token=BOT_TOKEN)

# Надіслати повідомлення, коли виявлено велике розблокування:
if percent >= threshold:
    alert_text = f"🚨 Попередження про розблокування токенів: {coin} розблокує {percent}% від загальної кількості {date}"
    bot.send_message(chat_id=CHAT_ID, text=alert_text)

Що буде робити бот

Ваш Telegram бот надішле повідомлення такого типу:

🚨 Попередження про розблокування токенів: Aptos розблокує 1.13% пропозиції 2025-08-12

Бібліотека обробляє все у фоновому режимі. Просто переконайтеся, що боту дозволено публікувати в обраному чаті.

Коли слід надсилати сповіщення?

Вам не потрібно чекати, поки відбудеться розблокування. API DropsTab надає дати розблокування заздалегідь. Це означає, що ваш бот може заздалегідь попередити користувачів. Ви можете:

• Запустіть скрипт раз на день, щоб повідомити про розблокування, які відбудуться протягом наступних 24 годин
• Або запускайте його щогодини, щоб встигнути на події, які відбудуться незабаром

Оскільки DropsTab постійно оновлює свої дані в реальному часі, ваш бот завжди матиме свіжу інформацію. Ця налаштування чудово підходить для простого бота сповіщень. Пізніше ви можете покращити його за допомогою планування або асинхронних функцій. Але для початку вам потрібен лише фільтр і виклик bot.send_message() щоб отримати сповіщення та запустити їх.

Способи запуску вашого бота

У вас є кілька простих способів підтримувати роботу вашого бота за розкладом:

1. Cron Job або Планувальник

Запускайте свій скрипт раз на годину або день. Ви можете використовувати:

• cron (для Linux/Mac)
• Планувальник завдань (для Windows)
• Цикл Python з використанням time.sleep()

Безкоштовний план DropsTab API надає вам 100 запитів на хвилину, тому виконувати це щогодини не проблема.

2. Хмарні функції

Використовуйте безсерверну платформу для автоматичного запуску вашого бота, наприклад:

• AWS Lambda
• Google Cloud Functions

Таким чином, вам не потрібно тримати комп'ютер або сервер увімкненими 24/7.

3. Завжди увімкнений бот

Якщо у вашого бота є команди (наприклад, "/nextunlock Aptos"), ви можете запускати його постійно. Використовуйте опитування або вебхуки для прослуховування повідомлень і запускайте ваш перевірник розблокування у фоновому режимі.

Розширення випадку використання

Тепер, коли ваш бот може отримувати дані про розблокування, фільтрувати їх і надсилати сповіщення, ви можете зробити його ще кориснішим, додавши більше функцій з API DropsTab.

Оскільки більше проєктів експериментують з альтернативними моделями розблокування, боти також можуть відстежувати зміни вестингу або раптові зміни TGE. Наприклад, Theoriq нещодавно здивував ринок, повністю прибравши вестинг:

“Ми видалили умови надання з продажу спільноти, і всі розподіли токенів будуть розблоковані на 100% на TGE.” (через @TheoriqAI, підкреслено @Va77ss)

Ці зміни варті уваги — особливо на ринку, що скептично ставиться до повільного розблокування та розблокування, орієнтованого на інсайдерів.

Нові типи сповіщень

DropsTab не тільки показує розблокування токенів. Він також включає:

• Раунди фінансування VC (/fundingRounds) — коли проєкт отримує нові інвестиції
• Інвесторські портфелі (/investors) — хто що володіє
• Криптоактивності (/cryptoActivities) — як лістинги на біржах або оновлення протоколів

З цим ви могли б:

• Надіслати сповіщення, коли токен додається на нову біржу
• Повідомити користувачів, коли проект отримує нове фінансування
• Слідкувати за діями великих інвесторів та надсилати оновлення

Це перетворило б вашого бота на повноцінну стрічку крипто новин.

Додати інформацію про ціну токена

Бажаєте надати користувачам більше контексту? Ви можете отримати дані про ціни, використовуючи /coins endpoint. Поєднайте це з повідомленнями про розблокування і покажіть, скільки вартості випускається.

Приклад:

Token X розблокує 10% від загальної кількості завтра — це приблизно $5 мільйонів за поточною ціною.

Додавання контексту ціни допомагає користувачам зрозуміти, чи може розблокування викликати волатильність або просто злитися з ширшими тенденціями. Як Glassnode нещодавно зазначив:

“Приватний індикатор #Altseason від Glassnode спрацював… капітал перетікає в $BTC та $ETH, і… ринкова капіталізація альткоїнів зростає – структурне середовище, сприятливе для ротації капіталу.”

У такому середовищі події розблокування можуть збігатися з підвищеним попитом, що робить деякі випуски менш ведмежими, ніж вони здаються в ізоляції.

Зберігайте простоту — один API

Все це походить з одного місця — DropsTab API. Вам не потрібно додавати додаткові сервіси чи інструменти. Просто використовуйте різні кінцеві точки з того ж API. Це зберігає ваш код чистим і все узгодженим.