Tracks prices of pairs on binance and notifies when price movements based on pre-defined parameters are met.
BPA is a simple application which gets the price data from Binance Spot or Futures API and sends Telegram messages based on parameters set used to detect pumps and dumps on the Binance Exchange.
Demo Telegram Channel hosted on AWS ec2 running the 'Base Stable Version' release 24/7.
pip install -r requirements.txt
while located at folder with code.chat_id
from @get_id_bot.
channel_id
can be used as well.python pumpAlerts.py
.docker-compse.yml
file to provide your config.
entrypoint.sh
for environment variable names and the config possibilities..env
file during development.config.yml
PUMP_EMOJI="! \"\\\\U0001F4B9\""
docker-compose up -d --build
to create and run the docker image/container.telegramToken
: The token obtained from@botfather.telegramChatId
: The bot will send the messages to this chat_id
. It can be a group or channel as well.chartIntervals
: Can be modified to consider other timeframes, follow the format of 's' for seconds, 'm' for minutes, 'h' for hours.outlierIntervals
: (0.01 -> 1% , 0.1 -> 10%), modify accordingly based on needs. Avoid setting it too low to avoid noise.extractInterval
: Default is 1s
, Interval at which we retrieve the price information from Binance.pairsOfInterest
: Default is USDT. Other options include BUSD, BTC, ETH etc.topReportIntervals
: Default is 1h
,3h
and 6h
Intervals for top pump and dump reports to be sent, ensure it is in chartIntervals + outlierIntervals as well.watchlist
: Default if left empty it'll look at ALL symbols after filtering by pairs of interest. If pairs are added to the watchlist, the application will only TRACK the pairs specified. pairsOfInterest will be ignored.blacklist
: Default if left empty it'll look at ALL symbols after filtering by pairs of interest. If pairs are added to the blacklist, the application will ignore pairs specified. pairs of Interest will NOT be impacted.dumpEnabled
: If True
, the application will alert on dumps as well.topPumpEnabled
: If True
, the application will send the Top X pumps at the defined interval.topDumpEnabled
: If True
, the application will send the Top X dumps at the defined interval.
noOfReportedCoins
: Top X amount of coins shown, adjust to show more or less within the timeframe.telegramAlertChatId
: Insert the alert chat_id for top pump dump alert, if left at 0
, it'll send messages to the telegram chat_Id
.
For params not indicated above, refer to comments besides parameter for its use.debug
: Default is False
. Please, only enable for debugging purposes. Default logging set to info level.resetInterval
: Default 12h
. It clears the array used to store data price points to prevent memory issues.priceRetryInterval
: Default 5s
. In the case of get price fail, this is the time delay before re-attemptcheckNewListingEnabled
: Default True
. Enables checking and adding of new listing pairs.