Available translations
loading results
Telegram Announcements
Summary: Setup a Telegram bot to broadcast the activity of trading sessions to a Telegram group. You may produce plain-text or dynamic-content announcements at every event in your trading systems.
Overview
The announcements feature allows users to set up notifications tied to specific events, and triggered once each particular event becomes active while running any of the available types of trading sessions.
You may use this feature to stay informed about the actions of your strategies while trading live, or to broadcast signals over a Telegram group while paper trading, for instance.
Supported events are:
- Trigger-on event
- Trigger-off event
- Take position event
- Stop and take profit next-phase events
In addition, you can implement announcements at the level of stop and take profit phases, a particular case that shall be discussed too.
The current implementation is based on broadcasting announcements via Telegram bots. The system uses Telegram’s bots API to interact with a Telegram bot you will create. The bot will be added as a user in the Telegram group of your choice in which it will deliver the announcements as per the configuration you will set up in the system.
Setting Up a Telegram Bot and a Telegram Group
Telegram’s documentation explains the details of how to use Telegram bots:
You may choose to read Telegram’s documentation or simple follow the next few steps, which have been extracted for your convenience:
- 1. Go to Telegram and find the user @BotFather: You may use the link or simply search for the user.
- 2. Type and send /newbot: BotFather will ask you to pick a name for your bot. Once the name is set, it will respond with the token (a text string) to access the HTTP API.
Important: You will need this token at a later time.
- 3. Create a Telegram: Your bot will broadcast the announcements here.
- 4. Add your bot in the group: And add @myidbot as user in the group too.
- 5. Type and send /getgroupid in the group: IDBot will answer with the group’s ID.
Important: You will need this ID at a later time.
Setting Up the Telegram Bot in Superalgos
You will set up your bot in a backtesting session, so that you may easily test the announcements.
- 1. Go to any of your backtesting sessions and add a Social Bot node using the session’s menu: A social bot will be added along with a telegram bot.
- 2. Select Edit Telegram Bot on the telegram bot menu: Replace the placeholder text with the actual
botTokenandchatIdyou got earlier.
For example:
{
"botToken": "927642627:2B1QkNX2620C2B1ZTp9JrQUV04YKtJrQ2t4",
"chatId":-388158765
} The system now has everything it needs to communicate with your Telegram bot.
Create Your Announcements
You may create as many announcements as you wish, on any of the events listed in the Overview section above by clicking Add Announcement on the corresponding event node menu.
There are two different ways in which you may customize announcements:
- Plain text
- Dynamic content
Tip: The Weak-hands buster strategy shipping with Superalgos features a complete set of announcements. Check them out and reuse them in your setup!
Plain Text
To set a plain text announcement, click Edit Announcement on the announcement node menu and set a message on the field text.
For example:
{
"text": "WHB Triggered-on!"
} Dynamic Content
To broadcast more elaborate messages that may include dynamic values of any of the current indicators or internal variables, set the message in the formula attached to the announcement instead.
The typical set up for a dynamic message consists of building a string by alternating “text between double quotes” with variables, separating them with plus signs (+).
For example, a typical announcement formula for the take position event may look like this:
"Selling BTC at $" + candle.close.toFixed(0) + ", with stop at $" + stopLoss.toFixed(0) + " and TP target at $" + takeProfit.toFixed(0) .toFixed(0) rounds the number to zero decimal places. The above formula would result in something like:
Selling BTC at $9703, with stop at $9896 and TP target at $9115 Note: If your formula is valid, the system will ignore the plain text version you may have set up in the announcement configuration. If for any reason the formula results in an error, then the plain text version will be used.
Announcements on Stop and Take Profit Phases
We mentioned earlier that, beyond setting announcements on events, you may also implement announcements at the level of a stop or take profit phase. These are useful to broadcast the management of dynamic stop and take profit targets.
When implemented at the level of a phase, the announcement is triggered every time the value of the underlying variable (the stop or take profit target) changes. This is an important difference, as the value may change at every candle (if you are using formulas that use variables).
This could result in too many announcements in relatively short intervals.
The
valueVariation parameter introduced in the announcement configuration may be used to filter out announcements until a certain threshold is achieved. The value you enter will set the percentage of variation that needs to occur before a new announcement is broadcasted. For instance, "valueVariation": 0.5 means a new announcement will be broadcasted every time the value of the underlying variable changes by 0.5%.
{
"text": "Write here what you want to announce.",
"valueVariantion": 0.5
} Finishing the Setup
It is unlikely that you will want to use the announcements feature from within a backtesting session. A more likely scenario is you will want to use it with a paper trading session (to generate signals) or from a live trading session, to monitor the activity of your live trading.
All you need to do to finish your set up is detach the social bot node from the backtesting session and attach it to the session you wish to use it in. Make sure the corresponding tasks are stopped before detaching and attaching the social bot.
Commercial Setups
If you are settting up a signals business or require a more complex setup to broadcast announcements from multiple sessions, multiple strategies, or even to multiple groups, the following considerations may help you decide how to move forwards.
Important: Telegram does not allow running multiple instances of the same bot. Doing so may produce warnings, cause errors, delays in message delivery, lost messages, and erratic behavior in general.
The solution is quite simple. Set up multiple bots. The rule of thumb is you should use one bot for each trading session. Remember you can include as many bots as you wish in your Telegram groups. That is, you may have different bots broadcast from different sessions in the same group.
Tip: If you wish to broadcast signals from multiple sessions to the same Telegram Group, you may name each bot in a way that each references their specific session, so that group members know exactly what each message is referring to.
For example, let’s say you are broadcasting signals from different markets… you may name your bots BTC/USDT, ETH/USDT and XMR/BTC.
Or maybe you have different strategies, then simply name the bots after each strategy.
This makes it really easy for group members to know what market or strategy the bot broadcasting the signal is referring to.
Another example… let’s say you are running a trading operation for friends and family. Each person is working with a different initial capital, different assets or different exchanges. in such case, you may set up multiple Telegram groups and multiple bots, so that each person may get precise information on what the bots are doing.
Integrations — TOC
You just read page 1 in the topic.