A telegram bot to track whales activities on multiple blockchains.

Overview

Telegram Bot : Whale Watcher

A straightforward telegram bot written in python to track whales activity on multiple blockchains, using whale-alert API

Installation

1. Telegram Bot

First, you need to read the documentation on telegram bot, and create one : telegram bot docs. Once you own a bot and you have securely stored his token, you can go to the next step!

2. Whale-alert API key

Once you have your bot, you need to be able to connect the to whale-alert api using one of the token they provide. You will find all the required informations here to get your api key : whale-alert authentication.

There is different pricing plans, the bot is well adapted for the free one with the base config.

3. Running the bot!

To run the bot, you'll need to either have python 3.9.7 already installed, or install using a virtual environment (recommended) with pyenv & pyenv-virtualenv:

Go into the main folder, and simply run :

pyenv install 3.9.7
pyenv virtualenv 3.9.7 whale_alert_bot
pyenv activate whale_alert_bot

Go into the main folder, and simply run :

pip install -r requirements.txt

Finally, run the main script to run the bot, along with your tokens allocated to the right environment variables:

WHALE_ALERT_API_KEY=YOUR-TOKEN TELEGRAM_BOT_TOKEN=YOUR_TOKEN python src/bots/watcher_bot.py

Or add the environment variables to a .env file, within the same folder as the settings.py file (recommended). They will be imported automatically while running the bot.

4. The environment variables

As we have seen previously, the bot can be personalised thanks to a bunch of environment variables to set in your .env file:

TRANSACTION_ENDPOINT

The endpoint to fetch transactions, defaults to the current on in whale-alert.

STATUS_ENDPOINT

The endpoint to fetch connection to blockchain statuses, defaults to the current on in whale-alert.

API_KEY

Your whale-alert API key. This is required.

TELEGRAM_BOT_KEY

Your telegram bot key. This is required.

MIN_INTERVAL

Minimum interval (in seconds) for which we want to allow the transaction alerts. Defaults to 15.

HISTORY_TIME_LIMIT

Maximum interval (in seconds) for which we want to allow the transaction alerts. Defaults to 3600 (free whale alert plan).

TX_VALUE_USD_THRESHOLD

Minimum value of the transactions we want to track (USD). Defaults to 500 000.

CURRENCY_WATCHED

Currency to watch. Default to None (all of them)

TX_ROWS_LIMIT

Limit amount of transactions per alert. Defaults to 100.

Usage

1. Helpers

Once your bot is running, just like the normals bots, you can get more details about the commands with the following commands:

/help
/start

2. Status Checker

This command allows you to precisely check the status of the connection of whale-alert to the different blockchains it's monitoring.

/check_status <optional: data_keys>

The data_keys are arguments representing the specific data you want to fetch from the whale-alert blockchains status. Without this argument, all of them are returned.

Example :
/check_status status name

Will only return the status and the name of each connected blockchain, in the payload.

3. Transaction watcher

This is the main command of the bot : it's monitoring the transactions on the blockchains and gives you an alert of the statuses every dt seconds.

/watcher_timer seconds minutes <optional: data_keys>

Seconds and minutes are describing the interval between each alert sent by the bot. (Max. 1h with the free version of the whale-alert API).

data_keys, are, like previously, the data you want to filter out in the transactions payload of the response.

Example :
/watcher_timer 20 0 amount_usd symbol blockchain

Will give you an alert every 20 seconds of all the big transactions, only returning you the given arguments from the payload described here

4. Upcoming

More detailed commands and more commands in development :)

You might also like...
This is telegram bot to generate string session for using user bots. You can see live bot in https://telegram.dog/string_session_Nsbot

TG String Session Generate Pyrogram String Session Using this bot. Demo Bot: Configs: API_HASH Get from Here. API_ID Get from Here. BOT_TOKEN Telegram

A telegram bot which can show you the status of telegram bot

BotStatus-Ts-Bot An open source telegram Bot Status bot For demo you can check here The status is updated in every 1 hour About Bot This is a Bot stat

Telegram PHub Bot using ARQ Api and Pyrogram. This Bot can Download and Send PHub HQ videos in Telegram using ARQ API.

Tg_PHub_Bot Telegram PHub Bot using ARQ Api and Pyrogram. This Bot can Download and Send PHub HQ videos in Telegram using ARQ API. OS Support All linu

veez music bot is a telegram music bot project, allow you to play music on voice chat group telegram.
veez music bot is a telegram music bot project, allow you to play music on voice chat group telegram.

🎶 Veez Music Bot Music bot for playing music on telegram voice chat group. Requirements 📝 FFmpeg NodeJS nodesource.com Python 3.7+ PyTgCalls 🧪 Get

A simple telegram voting bot based on the python-telegram-bot api.

A simple telegram voting bot based on the python-telegram-bot api. *To make it more easy to use, I might make a C++ code in the future so you don't ha

An Telegram Bot By @AsmSafone To Stream Videos in Telegram Voice Chat. This is Also The Source Code of The Bot Which is Being Used In @SafoTheBot Group! ❤️

Telegram Video Player Bot (Beta) An Telegram Bot By @AsmSafone To Stream Videos in Telegram Voice Chat. Special Features Supports Live Streaming From

Telegram bot implementing Lex Arcana using python-telegram-bot library.
Telegram bot implementing Lex Arcana using python-telegram-bot library.

Lex Arcana Telegram Bot 🤖 Telegram bot implementing Lex Arcana using python-telegram-bot library. This bot was evaluated for the course "Computer Eng

A Telegram Filter Bot, Support Unlimited Filter. Also, The Bot can auto-filter telegram File | video

A Telegram Filter Bot, Support Unlimited Filter. Also, The Bot can auto-filter telegram File | video

A Powerful telegram giveawayz bot based on the python-telegram-bot API
A Powerful telegram giveawayz bot based on the python-telegram-bot API

GiveawayZ Bot A Powerful telegram giveawayz bot based on the python-telegram-bot API. Powered by Team Zyntax and Team DFX Developed by @Zycho-Dev A pr

Owner
Laurenz Bougan
Backend Developer
Laurenz Bougan
A frame to create discord bots (for myself) that uses cogs, JSON, activities, and more.

dpy-frame A frame to create discord bots (for myself) that uses cogs, JSON, activities, and more. NOTE: Documentation is incomplete, so please wait un

Apple Discord 1 Nov 6, 2021
null 1 Feb 18, 2022
Telegram bot to stream videos in telegram voicechat for both groups and channels. Supports live strams, YouTube videos and telegram media.

Telegram VCVideoPlayBot An Telegram Bot By @ZauteKm To Stream Videos in Telegram Voice Chat. NOTE: Make sure you have started a VoiceChat in your Grou

Zaute 20 Oct 21, 2022
Telegram bot to stream videos in telegram voicechat for both groups and channels. Supports live strams, YouTube videos and telegram media.

Telegram bot to stream videos in telegram voicechat for both groups and channels. Supports live strams, YouTube videos and telegram media.

SUBIN 449 Dec 27, 2022
Satoshi is a discord bot template in python using discord.py that allow you to track some live crypto prices with your own discord bot.

Satoshi ~ DiscordCryptoBot Satoshi is a simple python discord bot using discord.py that allow you to track your favorites cryptos prices with your own

Théo 2 Sep 15, 2022
Wordle-bot: A Discord bot to track you and your friends' Wordle scores.

wordle-bot A Discord bot to track you and your friends' Wordle scores, so you can see who's the best! To submit a score to wordle-bot, just paste the

Spencer Murray 8 Feb 16, 2022
Create Multiple CF entry for multiple websites

AWS-CloudFront Problem: Deploy multiple CloudFront for account with multiple domains. Functionality: Running this script in loop and deploy CloudFront

Giten Mitra 5 Nov 18, 2022
A simple telegram bot to recognize lengthy voice files to text and vice versa with multiple language support.

Voicebot A simple Telegram bot to convert lengthy voice clips to text and vice versa with supporting languages. Mandatory Variables API_HASH - Yo

Renjith Mangal 12 Oct 21, 2022
Free python/telegram bot for easy execution and surveillance of crypto trading plans on multiple exchanges.

EazeBot Introduction Have you ever traded cryptocurrencies and lost overview of your planned buys/sells? Have you encountered the experience that your

Marcel Beining 100 Dec 6, 2022