Jak stworzyć bota Telegram do monitorowania odblokowań tokenów kryptowalut

Dlaczego śledzić wydarzenia odblokowania tokenów?

Niektóre tokeny są "zablokowane" na jakiś czas po ich stworzeniu. Oznacza to, że nie mogą być od razu handlowane. Te blokady są zazwyczaj po to, aby zapobiec zbyt wczesnej sprzedaży przez członków zespołu lub inwestorów. Jednak po zakończeniu blokady, te tokeny mogą trafić na rynek jednocześnie.

Kiedy wiele tokenów odblokowuje się jednocześnie, całkowita podaż szybko rośnie. Może to prowadzić do spadku ceny, ponieważ więcej osób może zacząć sprzedawać. Te wydarzenia odblokowania mogą naprawdę wpłynąć na to, jak token zachowuje się na rynku.

Śledzenie odblokowań to nie tylko obserwowanie odliczania — to zrozumienie, jak zablokowana podaż wspiera cenę i co się dzieje, gdy to wsparcie znika. Jak to ujmuje @digitalartchick:

„Kontrola podaży jest bycza, ale kiedy te monety wchodzą do obiegu, na zawsze obciążają monetę.”

To podkreśla, dlaczego odblokowania tokenów nie są tylko wydarzeniami do „przetrwania” — one fundamentalnie zmieniają dynamikę rynku tokenów.

Jeśli wiesz o nadchodzącym odblokowaniu z wyprzedzeniem, możesz być gotowy. Powiedzmy, że projekt ma odblokować 20% swojej całkowitej podaży jutro — osoby, które weszły wcześnie, mogą sprzedawać. Wysłanie alertu na Telegramie przed tym wydarzeniem daje Twojej społeczności ostrzeżenie.

Wykresy cenowe nie zawsze pokazują pełny obraz. Informują, kiedy coś się wydarzyło, ale nie dlaczego. Śledzenie odblokowań tokenów daje ci "dlaczego".

Wyzwanie śledzenia harmonogramów nabywania uprawnień

Chociaż odblokowania tokenów są ważne, są zaskakująco trudne do śledzenia. Popularne API, takie jak CoinGecko czy CoinMarketCap, pokazują dane dotyczące cen i wolumenu, ale nie zawierają informacji o wydarzeniach związanych z odblokowaniem tokenów lub harmonogramach vestingu. Te platformy koncentrują się na tym, co dzieje się teraz lub w przeszłości, a nie na tym, co nadchodzi.

Narzędzia do analizy on-chain, takie jak Nansen, mogą pokazywać ruchy portfela lub aktywność wielorybów, ale nie oferują prostego sposobu na zobaczenie nadchodzących odblokowań. Nie możesz po prostu wywołać funkcji takiej jak getUpcomingUnlocks() i otrzymać to, czego potrzebujesz.

Z tego powodu wielu deweloperów próbuje zbierać dane ręcznie: czytając whitepapers, śledząc posty na blogach lub analizując transakcje kontraktów blockchain. Inni sięgają po narzędzia takie jak Dune lub Bitquery, pisząc zapytania SQL lub GraphQL, aby wykryć zdarzenia odblokowania. Te metody działają, ale są czasochłonne, skomplikowane i muszą być budowane osobno dla każdego tokena.

Nie ma standardowego sposobu dostępu do wszystkich danych odblokowania w jednym miejscu. Są rozproszone, trudne do zaktualizowania i nie w czasie rzeczywistym. Dlatego deweloperzy potrzebują zunifikowanego API, które sprawia, że śledzenie vestingu tokenów jest proste, dokładne i skalowalne.

API DropsTab – Most do Luki Danych

API DropsTab znacznie ułatwia pracę z danymi kryptowalutowymi. Nie tylko pokazuje ceny i wykresy — dostarcza również ważne szczegóły, takie jak harmonogramy odblokowywania tokenów, rundy finansowania oraz informacje, którzy inwestorzy co posiadają. Otrzymujesz zarówno regularne informacje rynkowe, jak i głębsze dane o tokenach w jednym miejscu.

To jak połączenie CoinGecko i Nansen w jedno API, ale z dodatkową funkcją, której większość innych nie oferuje: śledzenie odblokowań. Zamiast przełączać się między różnymi platformami, możesz użyć DropsTab, aby uzyskać pełny widok dowolnego projektu tokena.

Jeśli chodzi o odblokowania, te dwa wywołania API są kluczowe:

• GET /api/v1/tokenUnlocks – pokazuje wszystkie tokeny z nadchodzącymi lub już trwającymi wydarzeniami odblokowania. Zobaczysz, ile jest jeszcze zablokowane i co ma zostać wydane.

• GET /api/v1/tokenUnlocks/{coinSlug} – daje szczegółowy harmonogram odblokowania dla jednego konkretnego tokena. Pokazuje daty, ile tokenów jest odblokowywanych i dla kogo są przeznaczone (np. zespół lub wczesni inwestorzy).

Są również inne przydatne punkty końcowe:

• supportedCoins – pokazuje wszystkie tokeny z danymi odblokowania

• chart/{coin} – pozwala na wykreślenie aktywności odblokowywania w czasie

Ponieważ te dane są dostępne przez API, możesz tworzyć boty lub pulpity nawigacyjne, które automatycznie śledzą odblokowania. Koniec z domysłami, kiedy nadejdą duże wydania — Twoja aplikacja lub bot mogą wcześniej ostrzegać ludzi.

Zaczynamy: Uzyskiwanie dostępu do API DropsTab

Przed zbudowaniem swojego bota na Telegramie musisz uzyskać klucz API od DropsTab. Ten klucz daje ci pozwolenie na użycie ich danych w twoim projekcie.

Oto dobra część: Jeśli jesteś studentem, niezależnym deweloperem lub uczestniczysz w hackathonie, możesz otrzymać klucz za darmo, dołączając do DropsTab Builders Program. To daje ci dostęp do ważnych danych, takich jak odblokowania tokenów, przez co najmniej 3 miesiące — bez żadnych opłat.

Po otrzymaniu klucza API (długiej kombinacji liter i cyfr), zachowaj go w bezpiecznym miejscu i nie udostępniaj go. Będziesz musiał dołączyć go do swoich żądań w ten sposób:

Autoryzacja: Bearer YOUR_API_KEY

Wszystkie żądania API przechodzą przez ten podstawowy URL: https://public-api.dropstab.com/api/v1/

Wypróbuj w terminalu

Nie musisz pisać pełnego programu, aby sprawdzić, czy działa. Otwórz terminal i użyj curl, aby przeprowadzić szybki test. Oto jak uzyskać cenę Bitcoina na 1 sierpnia 2025 roku:

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

To polecenie zwróci dane o cenach w formacie JSON.

Aby sprawdzić nadchodzące odblokowania tokenów, użyj tego polecenia:

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

Ile żądań możesz złożyć?

Darmowy plan daje ci:

• Do 100 żądań na minutę
• 100 000 żądań miesięcznie

To więcej niż wystarczająco dla podstawowego bota lub narzędzia. A jeśli Twój projekt się rozwinie, możesz przejść na wyższy plan dla większej mocy — wszystko bez zmiany kodu. API pozostaje takie samo.

Chcesz więcej szczegółów? Sprawdź pełną dokumentację API tutaj: https://dropstab.com/pl/products/commercial-api

Pobieranie nadchodzących odblokowań tokenów za pomocą API

Gdy już masz swój klucz API, możesz użyć Pythona, aby sprawdzić, które tokeny są na skraju odblokowania. Endpoint DropsTab /tokenUnlocks pokazuje listę tokenów z nadchodzącymi wydarzeniami odblokowania. Informuje o nazwie tokena, dacie odblokowania, ile zostanie odblokowane i jaki to procent jego całkowitej podaży.

Oto prosty przykład w Pythonie, który wysyła żądanie do API i wypisuje informacje:

import requests

API_KEY = "YOUR_API_KEY"  # Zamień to na swój rzeczywisty klucz API 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()

# Przejdź przez każde wydarzenie odblokowania i pokaż wyniki
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} odblokowuje {percent}% podaży w dniu {date} (około {amount} tokenów)")

Jak wygląda odpowiedź API

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

Ten przykład oznacza, że Aptos odblokuje 1.13% swojej podaży (około 11,3 miliona tokenów) dnia 12 sierpnia 2025.

DropsTab zbiera te informacje z publicznych źródeł, takich jak whitepapers lub kontrakty blockchain, więc nie musisz samodzielnie szukać. Jeśli chcesz pełny harmonogram dla jednego tokena, po prostu użyj /tokenUnlocks/{coinSlug} — na przykład: /tokenUnlocks/aptos.

Ale jeśli Twój bot obserwuje wiele tokenów jednocześnie, ogólny endpoint /tokenUnlocks jest najlepszy. Daje Ci wszystkie nadchodzące odblokowania za jednym razem.

Niektóre odblokowania mogą również pokazywać dodatkowe informacje, takie jak to, czy są przeznaczone dla zespołu, inwestorów czy społeczności. Możesz to wykorzystać, aby uczynić swoje alerty jeszcze bardziej pomocnymi.

Filtrowanie Znaczących Wydarzeń Odblokowania

Niektóre są tak małe (jak 0,5% całkowitej podaży), że nie wpływają naprawdę na rynek. Jeśli Twój bot alarmuje ludzi o każdym drobnym wydarzeniu, to tylko ich zirytuje.

Aby to naprawić, możemy ustawić minimalny próg — liczbę, która decyduje, co jest warte powiadomienia. Powszechnym wyborem jest 5%. Oznacza to, że twój bot wyśle powiadomienia tylko wtedy, gdy odblokowanie wynosi 5% lub więcej całkowitej podaży tokenów.

Oto jak możesz dodać ten filtr w Pythonie:

threshold = 5.0  # Alarmuj tylko, jeśli odblokowanie wynosi 5% lub więcej

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"ALERT: {coin} odblokowuje {percent}% swojej podaży dnia {date}!"
        print(alert_text)

Ten kod sprawdza każde zdarzenie i drukuje alert tylko wtedy, gdy spełnia wybrany przez ciebie próg. Więc jeśli token odblokowuje 3,2%, nie pojawi się. Ale jeśli inny odblokowuje 10%, to się pojawi.

Niektóre odblokowania są zaprojektowane z myślą o sprawiedliwości lub strategicznej dystrybucji. Na przykład, jak zauważył World Liberty Financial:

„Tylko część tokenów zakupionych podczas sprzedaży publicznej, które zostały kupione po $0.015 i $0.05, zostanie początkowo odblokowana – to bezpośrednio nagradza naszych wczesnych detalicznych wierzących i nikogo innego. Dodatkowo, tokeny skarbca wyłącznie do zasiewania płynności. To utrzymuje społeczność w centrum uwagi.”

To pokazuje, dlaczego nie chodzi tylko o to, ile się odblokowuje, ale dla kogo się odblokowuje i dlaczego—kolejny powód, aby ostrożnie kontekstualizować alerty.

Możesz zmienić próg w zależności od tego, jakie tokeny śledzisz. Dla monet o małej kapitalizacji może 3% to duża sprawa. Dla tokenów o dużej renomie możesz interesować się tylko wydarzeniami powyżej 10%.

Ponadto, ponieważ daty odblokowania są w standardowym formacie, możesz je sortować lub dodawać dodatkowe filtry (na przykład patrząc tylko na odblokowania w ciągu następnych 24 godzin). Możesz nawet sprawić, że twój bot będzie sprawdzał raz dziennie, aby utrzymać alerty świeże i użyteczne.

Wysyłanie alertów do Telegramu w czasie rzeczywistym

Gdy twój skrypt znajdzie duże odblokowanie tokena, czas poinformować użytkowników Telegrama. Najłatwiejszym sposobem na to jest użycie python-telegram-bot library (wersja 20+).

Krok 1: Utwórz swojego bota Telegram

• Otwórz Telegram i wyślij wiadomość do @BotFather
• Wpisz /newbot aby utworzyć nowego bota i uzyskać swój bot token
• Zapisz token w bezpiecznym miejscu
• Wybierz, gdzie bot będzie wysyłał wiadomości (twój własny czat, grupa lub kanał)

Krok 2: Zainstaluj bibliotekę Python

Otwórz terminal i wpisz:

pip install python-telegram-bot

Krok 3: Wysyłaj alerty z Twojego kodu

Dodaj to do swojego skryptu, aby wysłać wiadomość, gdy zostanie znalezione duże odblokowanie:

from telegram import Bot

BOT_TOKEN = "YOUR_TELEGRAM_BOT_TOKEN"  # twój token z BotFather
CHAT_ID = "YOUR_CHAT_ID"  # twój identyfikator użytkownika lub identyfikator grupy/kanalu

bot = Bot(token=BOT_TOKEN)

# Wyślij wiadomość, gdy zostanie znalezione duże odblokowanie:
if percent >= threshold:
    alert_text = f"🚨 Alert odblokowania tokena: {coin} odblokuje {percent}% podaży w dniu {date}"
    bot.send_message(chat_id=CHAT_ID, text=alert_text)

Co zrobi Bot

Twój bot Telegram wyśle wiadomość taką jak ta:

🚨 Alert odblokowania tokenów: Aptos odblokuje 1,13% podaży w dniu 2025-08-12

Biblioteka obsługuje wszystko w tle. Upewnij się tylko, że bot ma pozwolenie na publikowanie w wybranym czacie.

Kiedy powinno wysyłać alerty?

Nie musisz czekać, aż nastąpi odblokowanie. API DropsTab podaje daty odblokowania z wyprzedzeniem. Oznacza to, że twój bot może wcześniej ostrzec użytkowników. Możesz:

• Uruchom skrypt raz dziennie, aby ostrzec o odblokowaniach w ciągu następnych 24 godzin
• Lub uruchamiaj go co godzinę, aby wychwycić wydarzenia, które wkrótce się odbędą

Ponieważ DropsTab aktualizuje swoje dane w czasie rzeczywistym, Twój bot zawsze będzie miał świeże informacje. To ustawienie jest świetne dla prostego bota alertów. Później możesz go ulepszyć o funkcje harmonogramowania lub asynchroniczne. Ale na początek, wszystko czego potrzebujesz to filtr i wywołanie bot.send_message() aby uruchomić alerty.

Sposoby uruchamiania swojego bota

Masz kilka prostych sposobów, aby utrzymać działanie swojego bota według harmonogramu:

1. Cron Job lub Harmonogram

Uruchom swój skrypt raz na godzinę lub dzień. Możesz użyć:

• cron (dla Linux/Mac)
• Harmonogram zadań (dla Windows)
• Pętla w Pythonie używając time.sleep()

Darmowy plan DropsTab API daje ci 100 żądań na minutę, więc robienie tego co godzinę nie stanowi problemu.

2. Funkcje Chmurowe

Użyj platformy bezserwerowej, aby uruchomić swojego bota automatycznie, takie jak:

• AWS Lambda
• Google Cloud Functions

W ten sposób nie musisz utrzymywać komputera lub serwera włączonego 24/7.

3. Zawsze włączony bot

Jeśli Twój bot ma komendy (jak "/nextunlock Aptos"), możesz go uruchamiać cały czas. Używaj ankiet lub webhooków, aby nasłuchiwać wiadomości i uruchamiaj swój sprawdzacz odblokowań w tle.

Rozszerzanie przypadku użycia

Teraz, gdy Twój bot może pobierać dane o odblokowaniach, filtrować je i wysyłać alerty, możesz uczynić go jeszcze bardziej użytecznym, dodając więcej funkcji z DropsTab API.

W miarę jak coraz więcej projektów eksperymentuje z alternatywnymi modelami odblokowywania, boty mogą również śledzić zmiany w vestingu lub nagłe zmiany TGE. Na przykład, Theoriq niedawno zaskoczył rynek, całkowicie usuwając vesting:

„Usunęliśmy warunki nabywania z sprzedaży społecznościowej i wszystkie alokacje tokenów będą w 100% odblokowane przy TGE.” (via @TheoriqAI, podkreślone przez @Va77ss)

Te zmiany są warte uwagi — zwłaszcza na rynku sceptycznym wobec powolnego uwalniania i odblokowań z dużym udziałem insiderów.

Nowe rodzaje alertów

DropsTab nie tylko pokazuje odblokowania tokenów. Zawiera również:

• Rundy finansowania VC (/fundingRounds) — kiedy projekt otrzymuje nową inwestycję
• Portfele inwestorów (/investors) — kto jest właścicielem czego
• Aktywności kryptowalutowe (/cryptoActivities) — takie jak notowania na giełdach lub aktualizacje protokołu

Dzięki temu możesz:

• Wyślij alert, gdy token zostanie notowany na nowej giełdzie
• Powiadom użytkowników, gdy projekt otrzyma nowe finansowanie
• Obserwuj, co robią duzi inwestorzy i wysyłaj aktualizacje

To zamieniłoby twojego bota w pełnoprawny kanał wiadomości o kryptowalutach.

Dodaj informacje o cenie tokena

Chcesz dać użytkownikom więcej kontekstu? Możesz pobrać dane o cenach, używając endpointu /coins. Połącz to z alertami odblokowania i pokaż, ile wartości jest uwalniane.

Przykład:

Token X odblokowuje 10% podaży jutro — to około 5 milionów dolarów po obecnej cenie.

Dodanie kontekstu cenowego pomaga użytkownikom zrozumieć, czy odblokowanie może wywołać zmienność, czy po prostu wtopić się w szersze trendy. Jak niedawno zauważył Glassnode:

„Wskaźnik #Altseason firmy Glassnode zadziałał… kapitał przepływa do $BTC i $ETH, a… kapitalizacja rynku altcoinów rośnie – strukturalne środowisko sprzyjające rotacji kapitału.”

W takim środowisku wydarzenia odblokowania mogą zbiegać się ze zwiększonym popytem — co sprawia, że niektóre wydania są mniej niedźwiedzie, niż wydają się w izolacji.

Zachowaj prostotę — jedno API

Wszystko to pochodzi z jednego miejsca — API DropsTab. Nie musisz dodawać dodatkowych usług ani narzędzi. Wystarczy użyć różnych punktów końcowych z tego samego API. To utrzymuje twój kod w czystości i wszystko jest spójne.