Setup your Telegram bot¶
Below we explain how to create your Telegram Bot, and how to get your Telegram user id.
1. Create your Telegram bot¶
Start a chat with the Telegram BotFather
Send the message
Alright, a new bot. How are we going to call it? Please choose a name for your bot.
Choose the public name of your bot (e.x.
Good. Now let's choose a username for your bot. It must end in
bot. Like this, for example: TetrisBot or tetris_bot.
Choose the name id of your bot and send it to the BotFather (e.g. "
Done! Congratulations on your new bot. You will find it at
t.me/yourbots_name_bot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands. By the way, when you've finished creating your cool bot, ping our Bot Support if you want a better username for it. Just make sure the bot is fully operational before you do this.
Use this token to access the HTTP API:
For a description of the Bot API, see this page: https://core.telegram.org/bots/api Father bot will return you the token (API key)
Copy the API Token (
22222222:APITOKEN in the above example) and keep use it for the config parameter
Don't forget to start the conversation with your bot, by clicking
2. Get your user id¶
Talk to the userinfobot
Get your "Id", you will use it for the config parameter
Per default, the Telegram bot shows predefined commands. Some commands
are only available by sending them to the bot. The table below list the
official commands. You can ask at any moment for help with
||Starts the trader|
||Stops the trader|
||Stops the trader from opening new trades. Gracefully closes open trades according to their rules.|
||Reloads the configuration file|
||Shows part of the current configuration with relevant settings to operation|
||Show last log messages.|
||Lists all open trades|
||List all open trades in a table format. Pending buy orders are marked with an asterisk () Pending sell orders are marked with a double asterisk (*)|
||List all recently closed trades in a table format.|
||Delete a specific trade from the Database. Tries to close open orders. Requires manual handling of this trade on the exchange.|
||Displays number of trades used and available|
||Display a summary of your profit/loss from close trades and some stats about your performance|
||Instantly sells the given trade (Ignoring
||Instantly sells all open trades (Ignoring
||Instantly buys the given pair. Rate is optional. (
||Show performance of each finished trade grouped by pair|
||Show account balance per currency|
||Shows profit or loss per day, over the last n days (n defaults to 7)|
||Show the current whitelist|
||Show the current blacklist, or adds a pair to the blacklist.|
||Show validated pairs by Edge if it is enabled.|
||Show help message|
Telegram commands in action¶
Below, example of Telegram message you will receive for each command.
Stopping trader ...Status:
Setting max_open_trades to 0. Run /reload_config to reset.
Prevents the bot from opening new trades by temporarily setting "max_open_trades" to 0. Open trades will be handled via their regular rules (ROI / Sell-signal, stoploss, ...).
After this, give the bot time to close off open trades (can be checked via
Once all positions are sold, run
/stop to completely stop the bot.
/reload_config resets "max_open_trades" to the value set in the configuration and resets this command.
The stop-buy signal is ONLY active while the bot is running, and is not persisted anyway, so restarting the bot will cause this to reset.
For each open trade, the bot will send you the following message.
(since 1 days ago)
Current Pair: CVC/BTC
1 days ago
Return the status of all open trades in a table format.
ID Pair Since Profit ---- -------- ------- -------- 67 SC/BTC 1 d 13.33% 123 CVC/BTC 1 h 12.95%
Return the number of trades used and available.
current max --------- ----- 2 10
Return a summary of your profit/loss and performance.
ROI: Close trades
0.00485701 BTC (258.45%)
ROI: All trades
0.00255280 BTC (143.43%)
Total Trade Count:
First Trade opened:
3 days ago
Latest Trade opened:
2 minutes ago
BITTREX: Selling BTC/LTC with limit
0.01650000 (profit: ~-4.07%, -0.00008168)
BITTREX: Buying ETH/BTC with limit
Note that for this to work,
forcebuy_enable needs to be set to true.
Return the performance of each crypto-currency the bot has sold.
Return the balance of all crypto-currency your have on the exchange.
/daily will return the 7 last days.
The example below if for
Daily Profit over the last 3 days:
Day Profit BTC Profit USD ---------- -------------- ------------ 2018-01-03 0.00224175 BTC 29,142 USD 2018-01-02 0.00033131 BTC 4,307 USD 2018-01-01 0.00269130 BTC 34.986 USD
Shows the current whitelist
StaticPairListwith 22 pairs
IOTA/BTC, NEO/BTC, TRX/BTC, VET/BTC, ADA/BTC, ETC/BTC, NCASH/BTC, DASH/BTC, XRP/BTC, XVG/BTC, EOS/BTC, LTC/BTC, OMG/BTC, BTG/BTC, LSK/BTC, ZEC/BTC, HOT/BTC, IOTX/BTC, XMR/BTC, AST/BTC, XLM/BTC, NANO/BTC
Shows the current blacklist.
If Pair is set, then this pair will be added to the pairlist.
Also supports multiple pairs, separated by a space.
/reload_config to reset the blacklist.
StaticPairListwith 2 pairs
Shows pairs validated by Edge along with their corresponding win-rate, expectancy and stoploss values.
Edge only validated following pairs:
Pair Winrate Expectancy Stoploss -------- --------- ------------ ---------- DOCK/ETH 0.522727 0.881821 -0.03 PHX/ETH 0.677419 0.560488 -0.03 HOT/ETH 0.733333 0.490492 -0.03 HC/ETH 0.588235 0.280988 -0.02 ARDR/ETH 0.366667 0.143059 -0.01