2022.09.24:

1. New midnight statistics implemented including mean profit per day/month/year and ROI for single- and multibot
2. Added processing of Top10 and Top50 3cqs signals

2022.09.14:

1. Implementation of sentiment trading according to the Crypto Fear and Greed Index (FGI) with separate DCA profiles including profile specific topcoin filter settings and amount of concurrent deals. New sections [fgi_aggressive], [fgi_moderate] and [fgi_defensive] added for individual single/multi bot DCA configurations
2. Implementation of fgi_pulse trading, similar to btc_pulse however using the crossing of EMA9 to EMA20 as default values to decide for trading
3. Notification on Telegram: new deals are reported on your personal Telegram channel - no need to check your logs daily, also extended notification available for reporting every 3CQS signal
4. Config und DCA setting reporting with funds needed, max. coverage and required change
5. For Multibot: if deal_mode = signal is used, deals are triggered ONCE (no ASAP mode compared to single bot configuration)
6. For Multibot: Symrank list sorting according to trading volume and limiting to maximum active deals, e.g. when using ASAP like mode
7. List of tradeable pairs on 3Commas is updated every 6 hours to check for new or blacklisted coins
8. White-list for pairs implemented - trade only certain coins
9. Improved error handling if 3Commas, CoinGeckos or Yahoo Finance API requests are lagging
10. Backwards compatibility to v2.1.4 - use your old config

For questions contact me @M1ch43l on discord: https://discord.gg/tradealts

This python script program is addressed to users with basic linux command line experience and advanced experience for running single / multibots using the trading platform 3Commas. 3cqsbot can be used to start and stop DCA (Dollar Cost Average) bots with the help of external given 3CQS trading signals. 3CQS trading signals are developed using various market indicators and extensive technical research of the current and historical market atmosphere. They offer effective trading suggestions to purchase, trade or hold an asset. 3CQS trading signals are designed to signal the start and stop of DCA bots for optimal performance under a variety of market conditions. You can subscribe to the https://t.me/The3CQSBot to receive these signals. Enter /signals after joining and select proper signals you want to receive. It is recommended to start with 'SymRank Top 100 Quadruple tracker' as default and to switch off all other signals to avoid of being banned from receiving to much signals. If you have any questions regarding the signals, please contact the developer directly.

Note: The 3cqsbot is meant to be used for educational purposes only. The use with real funds is FULLY at your own risk and not recommended. The signal sender as well the authors of 3cqsbot cannot be held responsible for losses when using real money

Join the telegram channel https://t.me/The3CQSBot according to the official Telegram documentation

Wait for the signals. Actually the signals are in a beta phase and you have to be chosen to get them. Be patient if they not arrive after joining

In the meantime create your telegram api account and insert them into api_id and api_hash fields in the 'telegram' section of the config.ini

Create a 3commas api account too and insert the values in the key and secret fields in the 'commas' section of the config.ini

Permissions needed: BotsRead, BotsWrite, AccountsRead

• MacOS
• Linux
  • Ubuntu
• Windows
  • untested (please let me know if it works)
• Docker

Please install at least version 3.7 on your system

pip3 install -r requirements.txt

Copy the *.example* from the examples directory to config.ini in the root folder and change your settings regarding the available settings below. The value type doesn't matter, because Pythons configparser is taking care of the types. So you don't need '' or "" around the values.

To get your Telegram bot token (format is 1234567890:alphanumeric_characters) see https://www.siteguarding.com/en/how-to-get-telegram-bot-api-token. Enter in the same dialog box of @BotFather /start to enable your notification bot on Telegram.
To get your ChatID (format is 1234567890) enter @RawDataBot in the channel search function. Under search results with the section "chats" select "Telegram Bot Raw". Press the START button or type /start. On the output you see "Made by @SeanChannel". In the output look for "chat": "id". This is your ChatID to enter. See also https://www.alphr.com/find-chat-id-telegram/ for instructions.
Other notifications ways are possible. Enter one or a list of apprise notify urls, each in " " seperated with commas. See Apprise website for more information.

!!! ATTENTION - When creating multiple 3cqsbot instances by copying the 3cqsbot directory, REMOVE your telegram sessionfile (tgsession.session) with other 3cqsbot instances - otherwise this will lead to problems and misfunctional bots. For each instance you have to create a new TG sessionfile by starting the bot once manually!!!

Configure the [dcabot] and if using market sentiment trading add [fgi_aggressive], [fgi_moderate], [fgi_defensive] section in the config.ini according to your favourite bot configuration. Tip: You can use different bot names, so you know which dca setting is used by the bot or deal.

If you don't have any DCA settings, please take a look at Ribsy's site for published settings and background information and for the TA community list with all tested DCA settings

Default configuration is based on Trade Alts Safer settings: https://discord.gg/tradealts

single_count = how many singlebots can run overall

mad = how many deals can run on a singlebot pair

Examples:

single_count=1, mad=1 - Only one singlebot is started, and only one deal is started

single_count=3, mad=1 - Three singlebots are started, and only one deal per singlebot is started

single_count=3, mad=2 - Three singlebots are started, and two deals are started per singlebot

mad = how many deals per composite bot can run

Example:

mad=20 - 20 deals with different pairs can run at the same time

Condition: single=true deal_mode=signal

A single bot for a specific pair (the signal) will be created when the pair fits your configured filters and when the 3CQS signal is a "#START" signal. The deal will be started immediately. The bot will be disabled on a #STOP signal for this specific pair. If delete_single_bots is set to true, the script tries do delete the bot. This only works, when no deal is running.

Condition: single=true deal_mode="self assigned strategy"

Everything is the same as with the other single mode, but the deals are started dependent on your configured deal_mode strategy.

Condition: single=false deal_mode=signal

A multi bot will be created with the top 30 Symrank list (initical call to /symrank). A new deal will be started when a new signal is coming in.

If it is a STOP/START signal which is not from an existing pair a random pair from the initial top 30 Symrank list is used for a new deal.

If it is a START signal from an existing pair or a freshly added pair, exactly that pair is used for a new deal.

Pairs will be deleted from the list during a STOP signal and added with a START signal, if it fits the filters.

Condition: single=false deal_mode="self assigned strategy"

Everything is the same as with the other multi mode, but the deals are started dependent on your configured deal_mode strategy.

deal_mode = signal

• for single bot: 3CQS #START signal creates the single bot and deal is started ASAP (deal start condition is set to "open new trade ASAP" by the algo). After finishing the deal, a new one is started as long as the single bot is enabled.

• for multi bot: 3CQS #START signal adds the pair and deal is started manually by the program, only ONCE after adding. After the deal is closed, the deal is not started again in contrast to ASAP for single bot.
  If you want the same behaviour as for single bot you have to use a strategy for deal_mode (see below), which can be configured almost as ASAP. Deal start condition is set to "manual strategy" by the algo because "open new trade ASAP" is generally not implemented for multi bots because of security reasons - imagine you have a list of 100 pairs and all are opened simultaneously with ASAP

deal_mode = [{json coded 3commas strategy}}

• for single bot: deal is only started when RSI-7 15min < 70 preventing from buying in the overbought area
  deal_mode = [{"options":{"time_period":"7","time":"15m","trigger_condition":"less","points":"70"},"strategy":"rsi"}]

• for multi bot: If filtered symrank pairs should be started as soon as possible (ASAP) up to maximum active deals (mad) use the deal start condition such as
  [{"options":{"time_period":"7","time":"3m","trigger_condition":"less","points":"100"},"strategy":"rsi"}]
  or
  [{"options": {"time": "1m", "type": "buy_or_strong_buy"}, "strategy": "trading_view"}]
  You can also use a combination of different indicators/filters:
  [{"options": {"time": "1m", "type": "buy_or_strong_buy"}, "strategy": "trading_view"},{"options": {"time": "5m", "type": "buy_or_strong_buy"}, "strategy": "trading_view"},{"options": {"time": "15m", "type": "buy_or_strong_buy"}, "strategy": "trading_view"},{"options":{"length":14,"time":"15m","points":55},"strategy":"rsi"},{"options":{"length":14,"time":"4h","points":70},"strategy":"rsi"}]

• NOTE Not all exchanges support all deal mode strategies. Example, as of April 2022 Kucoin does NOT support the RSI strategy and will result in no deals starting. Ensure that your desired strategy is supported on your exchange before setting it in the config.

A whole list of deal start signals can be found on https://discord.com/channels/720875074806349874/835100061583015947/965743501570609172 in json coded format, alternatively get deal start with the API call GET /ver1/bots/strategy_list. More details can be found under: https://github.com/3commas-io/3commas-official-api-docs/blob/master/bots_api.md

There are different 3CQS trading signals. To decide which signal fits your needs, please take a look at the signals beneath. The description can be found on Discord too: https://discord.com/channels/720875074806349874/835100061583015947/958724423513419876 or officially on https://www.3cqs.com/home/faq/

SymRank is a proprietary symbol ranking system exclusive to 3CQS users that ranks symbols (coins) in near realtime based on multiple criteria including current trading volume, volatility and price action.

Pricing is monitored in near realtime and calculated which results in 15m, 30m, 1h, etc. volatility interval percentages. Each interval is then weighted and averaged based on the timeframe (more recent time frames are weighted higher), from which a score is calculated. Higher scores are greater volatility.

Realtime pricing is monitored and calculated using a combination of moving average formulas. Similar to volatility, more weight is given to recent pricing, from which a score is calculated.

3CQS price action and volatility take into account pricing over the last 24 hours. Scores that are marked with the red color are considered currently on a downtrend and green if on an uptrend.

Price action scores that are significantly negative are when price is moving much lower over the last 24 hours. Volatility scores can be negative as well, but are not calculated the same and won’t generally be seen with as large negative scores.

Negative scores represent the lowest of all price / volatility trend movements over 24 hours whereas the color is the current projected up / downtrend. Basically significant sells that drop price drastically will likely result in larger negative price action scores, but it could increase volatility as buys increase price. So you can have a very low negative price action score with a high volatility score in many cases. The scores are constantly recalculated, so it’s helpful to see the trends when you hover over the scores.

Signal Name: SymRank Top 100 Triple Tracker
Criteria for BOT_START: SymRank <= 100, Volatility Score >= 3, Price Action Score >= 2
These three indicators are tracked and if any fall out the starting thresholds for a period of time a BOT_STOP signal is sent

Signal Name: SymRank Top 100 Quadruple Tracker
Criteria for BOT_START: SymRank <= 100, Volatility Score >= 3, Price Action Score >= 2, RSI-14 15m <= 65
These four indicators are tracked and if any fall out the starting thresholds for a period of time a BOT_STOP signal is sent

Signal Name: SymRank Top 250 Quadruple Tracker
Criteria for BOT_START: SymRank <= 250, Volatility Score >= 3, Price Action Score >= 2, RSI-14 15m <= 65
These four indicators are tracked and if any fall out the starting thresholds for a period of time a BOT_STOP signal is sent

Signal Name: SymRank Top 10
Criteria for BOT_START: SymRank <= 10
SymRank is tracked and if the symbol falls out of the Top 10 for a period of time a BOT_STOP signal is sent

Signal Name: SymRank Top 30
Criteria for BOT_START: SymRank <= 30
SymRank is tracked and if the symbol falls out of the Top 30 for a period of time a BOT_STOP signal is sent

Signal Name: SymRank Top 50
Criteria for BOT_START: SymRank <= 50
SymRank is tracked and if the symbol falls out of the Top 50 for a period of time a BOT_STOP signal is sent

Signal Name: Super Volatility
Criteria for BOT_START: Volatility Score >= 4
Volatility scores are tracked and if the symbol falls out of the starting threshold for a period of time a BOT_STOP signal is sent

Signal Name: Super Volatility Double Tracker
Criteria for BOT_START: Volatility Score >= 4, Price Action Score >= 2
Volatility and price action scores are tracked and if the symbol falls out of the starting threshold for a period of time a BOT_STOP signal is sent

Signal Name: Hyper Volatility
Criteria for BOT_START: Volatility Score >= 6
Volatility scores are tracked and if the symbol falls out of the starting threshold for a period of time a BOT_STOP signal is sent

Signal Name: Hyper Volatility Double Tracker
Criteria for BOT_START: Volatility Score >= 6, Price Action Score >= 2
Volatility and price action scores are tracked and if the symbol falls out of the starting threshold for a period of time a BOT_STOP signal is sent

Signal Name: Ultra Volatility
Criteria for BOT_START: Volatility Score >= 8
Volatility score are tracked and if the symbol falls out of the starting threshold for a period of time a BOT_STOP signal is sent

Signal Name: X-treme Volatility
Criteria for BOT_START: Volatility Score >= 10
Volatility scores are tracked and if the symbol falls out of the starting threshold for a period of time a BOT_STOP signal is sent

Process all signals

BTC pulse is a simple strategy which monitors BTC price action to start new deals or just put the bot to sleep ( no new deals but active deals keep running) based on:

• If BTC is uptrending new deals are started
• If BTC is downtrending no new deals are started

BTC pulse hence is determined using the 2 factors:

• % price change of BTC in the last 15 minutes or Fast (9) and Slow (50) moving EMAs crossses

Please test this strategy on paper before putting real money on it. TBMoonWalker or IamtheOnewhoKnocks take no responsibility for losses occurred due to the script/strategy

Note: Please use 3cqsbot only on paper trading. Usage with real funds is at your own risk

The use of the Crypto Fear and Greed index (FGI) helps you to identify the sentiment of the corresponding market phase and to use adapted DCA profiles. The FGI is determined once a day on https://alternative.me/crypto/fear-and-greed-index/

The option fgi_trading activates FGI dependent DCA profile setting and trading.

When FGI is signaling "greed (FGI values 60-80)/very greed (80-100)" you may use aggressive DCA settings [fgi_aggressive], e.g. Mars/Banshee/69er DCA settings covering a price drop of 20-40%. You can use less maximum active deals then usual because a drop is very likely and you do not want to sit on red bags for the next 6-9 months.

In phases of fear (FGI values 0-30) over a longer time that may correspond to a beginning or consolidating bear market, the bot can switch to very defensive/conservative DCA settings [fgi_defensive], eg. TA safer, ZachTech BitMan DCA settings covering a price drop of up to 60%.

Get the excel lists from @Snurg at https://discord.com/channels/720875074806349874/829512509798219788/965771867413696532 to get the optimal DCA settings in corresdonding market phases according to your trade funds.

For sideways market (FGI values 31-60) you can define DCA settings under [fgi_moderate].

In each fgi section define the variables fgi_min and fgi_max so that the correct DCA settings are applied. If fgi_min/fgi_max are not set, then values between fgi_min = 0 and fgi_max = 30 are assumed for defensive, FGI values between 31-60 are assumed for moderate and FGI values between 61-100 are assumed for aggressive settings.

If corresponding fgi section is not found, the standard [dcabot] section is used and the FGI values are ignored.

To know: No new 3cqsbot is created when using FGI guided DCA settings, instead the new settings are applied to the existent one, so that new deals are started with the new DCA settings.

Optionally, the multi pair bot can be renamed according to the prefix, subprefix and suffix given in the corresponding fgi section, e.g. renaming from 3CQSBOT_MULTI_aggressive to 3CQSBOT_MULTI_defensive. To make sure it is always the same bot, you can additionally use the option 'botid' with the same botid number of an already created multi bot in all fgi sections.

For single bots the standard name (prefix, subprefix, suffix) defined in [dcabot] is used ensuring that the algo finds all single bots under standard name to switch them off when receiving the #STOP signal from 3CQS.

With the options fgi_trade_min = 10 and fgi_trade_max = 90 you can generally define the allowed trading range.

With the option fgi_pulse you can determine the trend direction of the market sentiment, in contrast to btc_pulse on a daily basis. When the sentiment is downtrending very fast (drop of >10% on one day or >15% on two days) trading is stopped, also if the fast (9) EMA is below the slow (20) EMA. Contrary, when fast EMA is crossing up the slow EMA line the market is uptrending and automated trading activities are started, dependent of your generally defined FGI trading range fgi_trade_min and fgi_trade_max. You can customize the EMA values with the options fgi_ema_fast and fgi_ema_slow.

If external botswitch is enabled, the 3cqsbot can be switched on/off by external TradingView signals sent to 3commas. See documentation on 3commas https://3commas.io/trading-view how to set up TradingView custom signals to manage your bot. However, external botswitch can not be run simultanously with BTC pulse, because it will interfere the behaviour of the bot with signals.

If you get signals, you can run the script with the command:

python3 3cqsbot.py

When running for the first time, you will be asked for your Telegram phonenumber and you will get a code you have to insert!

Some users had to put spaces in the phone number. It seems the number has to be the same format as in Telegram. For example type in your telephone number as +XXX XXX XXX XXX to receive the code.

docker build -t "your repo name"/3cqsbot:"version number"

docker volume create session

Copy one of the .env.*.example files from the example directory to .env in the root directory and change the settings. The same settings as in the config.ini can be used

docker run --name 3cqsbot --volume session:/App/session --env-file .env -d "your repo name"/3cqsbot:"version number"

docker logs --follow 3cqsbot

If you want to run 3cqsbot 24h/7d without running your home computer all the time and you do not have a Rasperry Pi, then PythonAnywhere might be a cheap option for you to run the script.

If you live in the EU go to https://eu.pythonanywhere.com otherwise https://www.pythonanywhere.com. The 'Hacker account' plan for 5€/5$ is sufficient enough to run 3cqsbot

Click on Dashboard. Under menue "New console" Click on $ Bash to open a Bash console in your home directory. Clone the actual version of 3cqsbot from Github and install the requirements for the bot by following commands

git clone https://github.com/TBMoonwalker/3cqsbot.git 3cqsbot
cd 3cqsbot
pip3 install -r requirements.txt
cp config.ini.example config.ini

When you want to use multiple 3cqsbots simultanously you have to clone 3cqsbot to different directories

git clone https://github.com/TBMoonwalker/3cqsbot.git 3cqsbot_TAsafe
git clone https://github.com/TBMoonwalker/3cqsbot.git 3cqsbot_Urmav6
git clone https://github.com/TBMoonwalker/3cqsbot.git 3cqsbot_Mars

Edit the config.ini with the integrated editor of PythonAnywhere in the Files menue. Paste the necessary keys of 3commas and Telegram and configure your DCA settings. Once done you can copy your config.ini to other directories of 3cqsbot and adapt the DCA settings.

Because the consoles of PythonAnywhere are frequently restarted due to maintenance you have to use scheduled task to ensure continuous work of your 3cqsbot. Before running 3cqsbot as scheduled task, make sure that you run the script once on the console to establish the Telegram security session. Enter your phone number (international format, e.g. +49xxx or 0049xxx) of your Telegram account and enter the code you receive from Telegram. Check if 3cqsbot is running without any problems under the console. Do not copy the tgsession file to other directories of 3cqsbots, because it is an individual security file and you will invalidate the established Telegram session when used with another version of 3cqsbot.

Click on Tasks menue. If you have only one python script running you can use the Always-on task (only one Always-on task allowed on the "Hacker account" plan). In case of using more scripts, e.g. for testing DCA settings, you have to use scheduled tasks on an hourly basis. Select "Hourly" and paste

cd ~/3cqsbot && python 3cqsbot.py 

If you encounter problems with this command then try this where YOUR_USERNAME has to be replaced by your chosen username on PythonAnywhere.

cd /home/YOUR_USERNAME/3cqsbot && python 3cqsbot.py

When using multiple 3cqsbots with different settings you have to add each 3cqsbot directory as seperate hourly task. Rename 3cqsbot.py according to your DCA setting configuration in the Files menue to identify the task running in the process list.

1. Hourly Task: 10min cd ~/3cqsbot_TAsafe && python 3cqsbot_TAsafe.py
2. Hourly Task: 11min cd ~/3cqsbot_Urmav6 && python 3cqsbot_Urmav6.py
3. Hourly Task: 12min cd ~/3cqsbot_Urmav6 && python 3cqsbot_Mars.py

In case you have to kill a process you can know easily identify your task to kill after fetching the process list under Running tasks Check the log files in the scheduled task under Actions for errors.

If you want to update 3cqsbot to the newest version open the Bash console. Change to your desired 3cqsbot directory with following commands

cd 3cqsbot
git pull
pip3 install -r requirements.txt

Check the config.ini.example for new config options. Make sure to update your existent config.ini for the new options with the integrated PythonAnywhere editor (Files menue).

The script can be started with

python3 3cqsbot.py -l debug

do show debug logging

Please submit bugs or problems through the Github issues page.

If you like to support this project, you can donate to the following wallet:

• USDT or BUSD (BEP20 - Binance Smart Chain): 0xB3C6DD82a203E3b6f399187DB265AdC664E2beF9