DEV Community: Nobbi's Crypto

Connecting Hodloo With a 3Commas Bot (API Version)

Nobbi's Crypto — Wed, 10 Nov 2021 08:55:20 +0000

This is a follow up to my last article on Hodloo. While last time I explained how to receive Hodloo alerts for USDT pairs, this time I'm showing you how to send the signals to 3Commas and trade hands-free - so you can get rich relaxing on the beach (see the cover image). Just joking, we all know it doesn't work that way, but it is a step in the direction.

Recap

Let's recap what we have when following the other article. We have a Python script running 24/7 on a VPS that parses messages from the official Hodloo API and sends USDT pairs to a Discord channel.

Now, instead of sending alerts to a Discord channel, we want to send them to a bot which does the buying/selling.

FAQ

Why combining Hodloo with a bot? Why not trade manually?
I'm not doing this full-time. I have a day to day job. Also, the crypto market is running 24/7 and it happened too often in the past that a drop occured while I was asleep or not in front of my computer. By using a bot, I'm participating in the drop immidiatly.

In addition, I suck at trading. I'm FOMOing in all the time with too much size and then carry red bags for months. The bot keeps me away from the trading terminal.

Why 3Commas?
I find it intuitive and easy to work with. I'm using the bot mainly to get in a trade and then taking care of the rest manually. That means I often switch the bot's deal to a smart trade to get out when I want and not at a fixed percentage.

Why do you not use the built-in QFL algos in 3Commas
Because they suck - period. Hodloo bases are way better respected. And I need well-respected bases. I just can't take losses mentally and because of silly tax rules in my country.

Can I run this on my Windows/macOS machine?
Yes. Python is cross-platform. Remember that you need to let the machine running all the time. I don't want that hence I'm using a Linux VPS.

Why is this so complex and why can't I use a public service for this?
It's not available, unfortunately.

Preparing The QFL Bots

Head over to 3Commas and create two multi-pair bots. One for the 5% alerts and one for the 10% alerts. You choose the pairs you want to trade in the bot settings. While the script will send all Hodloo alerts to 3Commas, 3Commas will only create deals for the pairs you've selected in the bots.

You can see that I've chosen six pairs for the bot but max deals is set to four. The bot will start a deal for the first Hodloo alert it receives to a maximum of four deals. Hence not all pairs you've configured will get a deal. First-come first-serve so to say.

You can also choose USDT_ALL. Note that this will include leveraged tokens and stablecoin pairs. Typically, you don't want to trade these and put them on the 3Commas blacklist. But that is cumbersome, instead you may want to use my script to do filter out leveraged tokens and stablecoin pairs. Just read on, it will be explained later.

Your safety order should be double the size of your base order.

Set the deal start condition to manually as the bot receives the signal through the Python script.

I wrote above that I like to get out of a trade manually. But, you have to set the take profit value to something and if it bounces to a 30% profit while I'm asleep - I'm okay with that ;-)

Now the juicy part - the buy layers. The above settings make sure that you get in with a small size and double-down when it goes south.

For the 5% bot the deepest layer is around 45% under the base.
For the 10% bot the deepest layer is around 50% under the base.

Save and start the bot. On the following page scroll down to the bottom and write down the bot ID. You need that later.

Preparing The Panic Sell Bot

Panic sells are a new Hodloo signal which is not availalbe via the Telegram alerts, but only with the new API. It detects a higher than normal sell off which is often where it bounces. If you have access to the new API, the panic sells are the green arrows in the charts.

I'm currently testing these myself and do not have a best-practice bot setting for you, you have to find it out yourself. So, create a bot and write down the bot ID.

Script Requirements

Copy everything from my GitHub repository to a local folder. I'm using /opt/nobbi/hodloo.
Install required Python libraries for all users:

sudo su
cd ~
pip install -r /opt/nobbi/hodloo/requirements.txt

Rename config.py.example to config.py and change the variables. The variables are very well documented in the file itself hence I won't cover this here. For your reference the variables below:

# 3c
TC_API_KEY = ''
TC_API_SECRET = ''
BOT_ID_5 = '' # Bot to start deal for pair 5% under the base. Leave empty if not desired.
BOT_ID_10 = '' # Bot to start deal for pair 10% under the base. Leave empty if not desired.
BOT_ID_PANIC = '' # Bot to start a deal for a panic sell. Leave empty if not desired.
MODE = 'paper' # 'real' or 'paper'
TC_EXCLUDE_LEVERAGED_TOKENS = True # Set to false to trade leveraged tokens. Currently supports excluding Binance and Kucoin leveraged tokens.
TC_DENYLIST = ["USDN/USDT","USDC/USDT","USDJ/USDT","CEUR/USDT","SUSD/USDT"] # Pairs on this list will not be traded.

# Discord
DISCORD_NOTIFICATIONS = '' # Discord Webhook of channel for trade notifications. Leave empty if not desired.
DISCORD_ERRORS = '' # Discord Webhook of channel for script errors. Mandatory.

# Hodloo
HODLOO_URI = '' # Hodloo Websocket API. Request the info from Pete in the Hodloo Discussions Telegram channel as it is private.
HODLOO_EXCHANGES = ["Binance"] # Multiple exchanges -> ["Binance","Kucoin"] Note that only Binance and Kucoin are fully supported at the moment.

Saw the variables TC_EXCLUDE_LEVERAGED_TOKENS and TC_DENYLIST? By using these you don't need to click 1,000 times in 3Commas to build a blacklist. I prefer the term denylist btw, it's 2021 after all...

Running The Script

Run the script to see if everything is running as expected: python3 /opt/nobbi/hodloo/hodloo-to-3commas.py

Running the script like above will work but is not very handy because as soon as you close the terminal or the session, the script stops. So we need a way to run the script in the background and also after a server reboot. Check the next chapter on how to achieve this.

Running the Script in Background

We need a way to run the script in the background and also after a server reboot. There are multiple ways to achieve that and the easiest method for Ubuntu I found is using the tool supervisor.

Installing supervisor:

sudo apt-get install supervisor

Checking the status of supervisor:

sudo service supervisor status

Starting supervisor:

sudo service supervisor start

Stopping and restarting supervisor:

sudo service supervisor stop
sudo service supervisor restart

Create an entry for the hodloo-to-3commas.py script. The following example uses vi.

sudo vi /etc/supervisor/conf.d/hodloo-to-3commas.conf

Contents of the file (change the paths accordingly):

[program:hodloo-to-3commas]
command=python3 -u hodloo-to-3commas.py
directory=/opt/nobbi/hodloo
stdout_logfile=/opt/nobbi/hodloo/hodloo-to-3commas.log
redirect_stderr=true
autorestart=true

Configure supervisor:

sudo supervisorctl
reread
add hodloo-to-3commas
status

To check whether your python script is running use the following:

sudo ps -axs | grep python

Conclusion

Congratulations! You've automated QFL-style trading with Hodloo bases, Python, and 3Commas.

Happy Hodlooing!

Update 2021-11-18

Volume Filter

The new variable HODLOO_MIN_VOLUME allows to filter coins based on a certain amount of volume. If the volume is below the variable's threshold, the coin will be ignored. See the variable description for an example.

Multiple Config Files

Until now the script required one config file named config.py. It now supports passing the name of the config file as a parameter, which allows running multiple instances of the script with different config files. Examples below.

# Old behavior where the script uses config.py as variable source (still supported btw)
> python hodloo-to-3commas.py

# Use kucoin.py file as variable source instead.
> python hodloo-to-3commas.py kucoin.py

Filtering Hodloo Alerts (API Version)

Nobbi's Crypto — Mon, 01 Nov 2021 05:10:36 +0000

The other day I wrote an article on how to use Telegram and Python to filter Hodloo alerts for USDT pairs only (took it offline on 2021-12-27). That turned out out to be quiet popular. However, shortly after I found that there is also an API availalbe to which I got access by the founder Pete through the Hodloo Discussion Telegram channel.

Using the API is better than parsing Telegram messages as it's faster and more robust. It has a new metric called panic sells, too. It detects a higher than normal sell of.

My Setup

My setup is still the same as described in the old article:

I'm running everything on a Linux VPS for 24/7 availability. You can run this on your home PC, too, but it needs to be online all the time.
I'm parsing Hodloo messages for USDT pairs on Binance.
Results are send to a Discord server. Discord is the only notification method available at the moment, so please read my tutorial on how to set it up.

Installation

Script And Requirements

Copy everything from my GitHub repository to a local folder. I'm using /opt/nobbi/hodloo.
Install required Python libraries for all users:

sudo su
cd ~
pip install -r /opt/nobbi/hodloo/requirements.txt

Rename config.py.example to config.py and change the variables. The variables are very well documented in the file itself hence I won't cover this here. For your reference the variables below:

# Discord
DISCORD_WEBHOOK_5 = '' # Discord Webhook for alerts 5% under the base. Leavy empty if not desired.
DISCORD_WEBHOOK_10 = '' # Discord Webhook for alerts 10% under the base. Leavy empty if not desired.
DISCORD_PANIC = '' # Discord Webhook for panic sell alerts. Leave empty if not desired.
DISCORD_ERRORS = '' # Discord Webhook in case of errors. Mandatory.

# Hodloo
HODLOO_URI = '' # Hoodlo Websocket API. Request the info from Pete in the Hoodlo Discussions Telegram channel as it is private.
HODLOO_QUOTES = ["USDT"]  # Multiple quotes -> ["USDT","USDC"]
HODLOO_EXCHANGES = ["Binance"] # Multiple exchanges -> ["Binance","Kucoin"] Note that only Binance and Kucoin are fully supported at the moment.

Run the script to see if everything is running as expected: python3 /opt/nobbi/hodloo/hodloo-alerts-api.py

Running the Script in Background

We need a way to run the script in the background and also after a server reboot. There are multiple ways to achieve that and the easiest method for Ubuntu I found is using the tool supervisor.

Installing supervisor:

sudo apt-get install supervisor

Checking the status of supervisor:

sudo service supervisor status

Starting supervisor:

sudo service supervisor start

Stopping and restarting supervisor:

sudo service supervisor stop
sudo service supervisor restart

Create an entry for the hodloo-alerts-api.py script. The following example uses vi.

sudo vi /etc/supervisor/conf.d/hodloo-alerts-api.conf

Contents of the file (change the paths accordingly):

[program:hodloo-alerts-api]
command=python3 -u hodloo-alerts-api.py
directory=/opt/nobbi/hodloo
stdout_logfile=/opt/nobbi/hodloo/hodloo-alerts-api.log
redirect_stderr=true
autorestart=true

Configure supervisor:

sudo supervisorctl
reread
add hodloo-alerts-api
status

To check whether your python script is running use the following:

sudo ps -axs | grep python

Conclusion

You now get Hodloo alerts like the one below in your own Discord server:

I'd like to thank Pete for access to the API and the permission to post this script. And I like to thank lampak from the Hodloo Discussion Telegram channel for sending me his Python implementation - a lot of my work is based on his actually.

The next article will cover how to connect the alerts with a trading bot.

Update 2021-11-18

Volume Filter

Multiple Config Files

# Old behavior where the script uses config.py as variable source (still supported btw)
> python hodloo-alerts-api.py

# Use kucoin.py file as variable source instead.
> python hodloo-alerts-api.py kucoin.py

Hodloo, Telegram, and 3Commas

Nobbi's Crypto — Thu, 28 Oct 2021 09:09:52 +0000

Using Telegram to trade Hodloo bases is outdated. Please read my other article instead.

Recap

Let's recap what we have when following the other article. We have a Python script running 24/7 that parses messages from the official Hodloo alerts Telegram channels and sends USDT pairs to a Discord channel.

Now, instead of sending the alerts to a Discord channel, we want to send them to a bot which does the buying/selling.

FAQ

In addition, I suck at trading. I'm FOMOing in all the time with too much size and then carry red bags for months. The bot keeps me away from the trading terminal.

Can I run this on my Windows/macOS machine?
Yes. Python is cross-platform. Remember that you need to let the machine running all the time. I don't want that hence I'm using a Linux VPS.

Why is this so complex and why can't I use a public service for this?
It's not available, unfortunately. The Hodloo API is private.

Preparing The Bots

Your safety order should be double the size of your base order.

Set the deal start condition to manually as the bot receives the signal through the Python script.

I wrote above that I like to get out of a trade manually. But, you have to set the take profit value to something and if it bounces to a 30% profit while I'm asleep - I'm okay with that ;-)

Now the juicy part - the buy layers. The above settings make sure that you get in with a small size and double-down when it goes south.

For the 5% bot the deepest layer is around 45% under the base.
For the 10% bot the deepest layer is around 50% under the base.

Save and start the bot. On the following page scroll down to the bottom and write down the bot ID. You need that later.

Script Requirements

The script has the same requirements as in the first article. So please check that. In addition, you need to install the Python module for 3Commas -> pip install py3cw.

Configuring The Script

Go to GitHub and download hodloo-to-3commas.py and config.py.example
Rename config.py.example to config.py
Change the variables in config.py to your needs

Running The Script

Please check the section Running the Script in Background in the first article and do the same for hodloo-to-3commas.py.

As soon as the script is running it parses the Telegram channels for any USDT pairs. It then sends the pair to your Discord channel and also trys to open a deal via your bots in 3Commas.

Happy Hodlooing!

Get Alerts and Adjust TP on 3Commas Based on SOs

Nobbi's Crypto — Thu, 07 Oct 2021 09:16:18 +0000

A very unwieldy title, I know. But I couldn't think of a better one. The topic is also very specific to my requirements, but maybe it will help someone.

The Situation

I'm running several Urma v3 Lite (update 2021-10-27: apparently the creator took that site offline) bots on 3Commas. If you don't know what I'm talking about then stop here, this blog post is not for you ;-)

Anyway, if you are familiar with Urma v3 Lite bots you know that they often get stuck after the 4th safety order (SO) as the spacing between the SOs is large. And if it goes down to the 5th or even the 7th SO, a bounce is very common.

Hence I needed two things:

Alerts whenever the 4th SO is completed. So that I don't need to check 3Commas the whole time. I then can play with manual safety orders to bring the deal into profit more quickly.
Adjust the take profit (TP) value starting with the 5th SO. I usually go with 1.5% TP, but the value should be higher depending on the SO.

The Solution

I wrote a Python script which does exactly the above. You can find it in my GitHub repo. I'm not a Python expert, but the script gets the job done.

The script checks all active deals whether they have 4 or more SOs completed. If yes, you get an alert. The deal ID is then saved so that you don't get further alerts for that deal. Then, it checks if 5 or more SOs are completed and sets the TP accordingly. I'm running the script every 15 minutes via cron on a Ubuntu VPS.

You need to have Python and py3cw installed.

The alerts are send to Discord. Read here why and how.

The script has a variable section which you need to modify. There are a lot of comments in the script so I won't go over the variables here. Below the variable section for your reference.

# 3Commas API info
# BOTS_READ permissions are mandatory
# BOTS_WRITE permissions are only needed if you want to adjust the take profit value
API_Key = ''
API_Secret = ''
account_id = ''

# Discord webhook for notifications
DiscordWebhook = ''

# Adjust TP, too?
adjust_TP = True # Can be True or False

# Adjust TP percentages when SO is completed
TPSO5 = 3 # Safety order 5
TPSO6 = 7 # Safety order 6
TPSO7 = 10 # Safety order 7

# Trailing settings
trailing_enabled = False
trailing_deviation = 0

Filtering Hodloo Alerts

Nobbi's Crypto — Wed, 22 Sep 2021 18:01:30 +0000

Using Telegram to filter Hodloo alerts is outdated. Please read my other article instead.

QFL is a popular crypto trading strategy. In a nutshell, you mark strong buying action as a base, buy when the price falls under that base and sell when it reaches the base again.

While the founder of QFL marked bases manually, many services were created that can draw bases automatically. You can find some indicators on TradingView (search for QFL) or use something like 3commas which has several algorithms built-in.

The best service, in my opinion, is Hodloo. Its bases are very well respected hence the winning rate is very high. You even get Telegram alerts for free! But, the alerts can get quite spammy when BTC drops. Also, you get alerts for BTC and ETH pairs while I only care about USDT pairs. So I needed a way to filter the Hodloo alerts. Luckily that's possible with Python.

This article outlines how to filter Hodloo alerts and forward them to a Discord server. The latter is what I'm using as my personal notification system as I prefer it over a flooded mailbox. A second blog post will cover how you can forward the alerts to a bot for automated trading.

My Setup

VPS

The alerts need to be monitored constantly, hence a normal computer is not the ideal place to run this as it is not always on. I'm using an Ubuntu VPS for stuff like this. More precisely a CX11 Cloud server from Hetzner. But you can go with whatever you like, of course.

Anyway, I can't teach you Linux here. You need some basic knowledge to follow this article.

Discord

Discord is what I use as my notification system. I created a server just for me where I collect all kinds of notifications. The script currently supports only Discord as its notification system.

Binance

Hodloo alerts are available for multiple exchanges. I use Binance hence the script is optimized for it. If you use other exchanges please change the script accordingly.

Obviously, you need to have a Telegram account and must be a member of the Hoodlo alert groups to be able to parse and filter the alerts.

Script Requirements

The script is written in Python and uses a public Python library to interact with Telegram. The following things must be present on your machine for everything to work. Installation instructions can be found via Google.

Python, should be installed by default on Ubuntu
Telethon, the library to interact with Telegram

Customizing and Running the Script

The script hodloo-alerts.py is available on GitHub. The variable section needs to be customized.

###
### Variables
###
api_id = 
api_hash = ''
binance_10_webhook = ''
binance_5_webhook = ''

# Only include USDT pairs but exclude anything with "DOWN/" or "UP/" in the name aka Binance Leveraged Tokens.
# Valid pair examples: ADA/USDT, LINK/USDT and so on
# Non-valid pairs: ADADOWN/USDT, ADA/BUSD, LINK/ETH, LINK/BTC and so on
pattern = '(?i)^(?!.*DOWN\/)(?!.*UP\/).*\/USDT.*'

Let's go over each.

api_id and api_hash - Telegram API information. You need to get yours from my.telegram.org.
binance_5_webhook and binance_10_webhook - The webhooks for the notification channels in Discord. Read this post on how to get the webhooks.
pattern - See description in the script. If you are trading only USDT pairs like me you don't need to change anything.

Save the script somewhere on your Linux box. I like to create a folder in /opt for these kinds of scripts. Then run it with Python, like:

python3 /opt/nobbi/hodloo/hodloo-alerts.py

The script will ask you to verify your phone number. You only need to do this once.

Running the Script in Background

We need a way to run the script in the background and also after a server reboot. There are multiple ways to achieve that and the easiest method for Ubuntu I found is using the tool supervisor.

Installing supervisor:

sudo apt-get install supervisor

Checking the status of supervisor:

sudo service supervisor status

Starting supervisor:

sudo service supervisor start

Stopping and restarting supervisor:

sudo service supervisor stop
sudo service supervisor restart

Create an entry for the hodloo-alerts.py script. The following example uses vi.

sudo vi /etc/supervisor/conf.d/hodloo-alerts.conf

Contents of the file (change the paths accordingly):

[program:hodloo-alerts]
command=python3 -u hodloo-alerts.py
directory=/opt/nobbi/hodloo
stdout_logfile=/opt/nobbi/hodloo/hodloo-alerts.log
redirect_stderr=true

Configure supervisor:

sudo supervisorctl
reread
add hodloo-alerts
status

To check whether your python script is running use the following:

sudo ps -axs | grep python

Conclusion

That's it! You're successfully filtering the Hodloo telegram alerts for USDT pairs. I know the setup is quite cumbersome and I would love to pay a monthly fee to the creator of Hodloo for the filtered alerts, but sadly that service is not available.

Send Exchange Updates to Discord

Nobbi's Crypto — Wed, 22 Sep 2021 17:48:43 +0000

I’m using Binance as my main exchange. They add new symbols frequently and I want to be notified if there is something new I could trade.

Also, I set up my own Discord server, mainly to receive TradingView alerts so that my inbox is not flooded with emails.

To connect both pieces, I wrote a PowerShell script that checks for new symbols on a daily basis and sends the result to my Discord server. No worries, you need next to zero PowerShell knowledge to use this script.

Creating a Discord Webhook

The first step is to sign-up on Discord and create a server. That’s pretty straightforward - if you need assistance, though, there are hundreds of tutorials on the Internet.

Next, create a new text channel and give it a name like exchange-updates or similar.

Edit your channel, click on Integrations and create a webhook.

Give it a name and copy/paste the webhook URL somewhere safe.

Modifying The Parameters

The script Update-TickerListToDiscord.ps1 is available on GitHub. Go there and download it.

Paste the webhook URL from above between the '' in the following line:

$DiscordWebhook = ''

As you can see in the script, I’m checking three lists:

USDT
Futures
EUR

You can also see that the script gets the lists from the website edgesforledges.com. If you trade other pairs than I, check the website for other lists, download them into the same folder as the script, copy the download URL, and change the variable $Inputs accordingly. sandwich.finance is another site to get lists.

Running The Script

To run the script manually, right-click it and choose Execute with PowerShell.

To run it periodically on Windows, create a scheduled task and set the action as follows:

Script: powershell.exe
Argument: -executionpolicy bypass -file "Full path to the script"

I'm running this every day at 8 AM via cron on an Ubuntu VPS box.