Flask | Binance API | Telegram API | TradingView Webhook | JSON
An automated trading bot connecting TradingView alerts via webhook to the Binance API, and sending order confirmations or errors to a Telegram user. The user can also send commands to the bot to make new trades, download trade history, cancel open trades, and a variety of other options!
This bot is operated by Flask.
Local Server: After installing the requirements from requirements.txt, open your preferred terminal, navigate into the main directory and type the command "flask run"
Remote Server: After installing Python and the requirements from requirements.txt, configure your server using WSGI. This ensures that your bot is always running. The command "flask run" is not needed for remote servers, unless you want to test the bot in debug mode.
There are four parts to this trading bot:
- Receives TradingView alerts via webhook, at the endpoint "/botwebhook" (found in file app.py)
- Send order to Binance API (found in file app.py)
- A Telegram messaging bot sends order confirmations from Binance API and error messages to the Telegram bot admin (found in file bot.py)
- Send Telegram commands to a Telegram bot connected to the main application.
The user of this trading bot must make a config.py (or a .json file) that holds the desired Binance API keys and the Telegram bot keys. The user must also create a Telegram bot in order to receive notifications from the trading bot.
Set up your TradingView alert to send a JSON message like this:
{ "passphrase": "Your passphrase here", "time": "{{timenow}}", "exchange": "{{exchange}}", "symbol": "{{ticker}}", "quantity": 1.0, "side": "{{strategy.order.action}}", "type": "LIMIT", "timeInForce": "GTC", "currentPrice": {{close}} }
You can change and add any variable you want, as long as it's in JSON format. Any additions, however, must be added to the Binance API call in app.py as well, because the code in app.py will read directly from this alert message.
On TradingView, make sure to include the desired url you would like to send in the 'Webhook URL' input (ex: http://your.server.address/botwebhook)
- /start - Saves Chat Id and Username
- /help - Receive a notification of all valid commands the bot will process.
- /account - Check current account on Binance
- /orderhistory {symbol} - Receive a CSV file of all orders made for a specific token (ex. /orderhistory btc)
- /openorders {symbol} - Checks all open orders for a specific token (ex. /openorders xrp)
- /market {side} {amount} {symbol} - Place a market order on Binance (ex. /market buy 0.01 eth)
- /limit {timeInForce} {side} {amount} {symbol} at {price} - Place a limit order on Binance (ex. /limit gtc sell 0.01 eth at 1800)
- /stoploss {timeInForce} {side} {amount} {symbol} at {price} stop at {stopLoss} - Place a stoploss limit order on Binance (ex. /stoploss gtc sell 0.1 btc at 55000 stop at 54900)
- /ticker {symbol} - Checks the current price of a given token (ex. /ticker btc)
- /cancel {symbol} {orderId} - Cancels an open order. It is recommended to call the command /openorders first, so that the user can copy and paste the order ID of a trade they would like to cancel. (ex. /cancel btc 6963)
- /block - Temporarily blocks automated TradingView orders. This does not block orders made via Telegram command.
- /unblock - Unblocks automated TradingView orders.
