arsheh/TradingView-Webhook-Bot

⚙️ This bot listens to TradingView alerts via webhooks and sends them instantly to Telegram, Discord, Twitter and/or Email.

About • Features • Installation • Images • Help

About

The TradingView Webhook Bot ⚙️ listens to TradingView alerts via webhooks using flask. All alerts can be instantly sent to Telegram, Discord, Twitter and/or Email.

🔥 You are unsure how to host the bot yourself? No problem, I can help you out with that. Just contact me directly.

Features

• Telegram Support using the Python Telegram libary
• Discord Support using webhooks
• Twitter Support using the tweepy libary
• Email Support using smtplib
• Alert channels can be enabled or disabled in config.py
• Dynamically send alerts to different Telegram and/or Discord channels
• TradingView {{close}}, {{exchange}} etc. variables support. Read more here

💡 Got a feature idea? Open an issue and I might implement it.

Installation

⚠️ Best to run the bot on a VPS. I can recommend Hetzner's CX11 VPS for 2.89€/month.

1. Clone this repository git clone https://github.com/vsnz/TradingView-Webhook-Bot.git
2. Create your virtual environment python3 -m venv TradingView-Webhook-Bot
3. Activate it source TradingView-Webhook-Bot/bin/activate && cd TradingView-Webhook-Bot
4. Install all requirements pip install -r requirements.txt
5. Edit and update config.py
6. Setup TradingView alerts. An example alert message would be:

   {"key": "9T2q394M92", "telegram": "-1001277977502", "discord": "789842341870960670/BFeBBrCt-w2Z9RJ2wlH6TWUjM5bJuC29aJaJ5OQv9sE6zCKY_AlOxxFwRURkgEl852s3", "msg": "Long #{{ticker}} at `{{close}}`"}
   

   • key is mandatory! It has to match with sec_key in config.py. It's an extra security measurement to ensure nobody else is executing your alerts
   • telegram and discord is optional. If it is not set it will fall back to the config.py settings
   • msg can be anything. Markdown for Telegram and Discord is supported as well
     • TradingViews variables like {{close}}, {{exchange}} etc. work too. More can be found here
   • Your webhook url would be http://<YOUR-IP>/webhook
7. If you use a firewall be sure to open the corresponding port
8. Run the bot with python main.py

It is recommended to run flask on a different port like 8080. It is then necessary to forward port 80 to 8080.

Images

How can I help?

All kinds of contributions are welcome 🙌! The most basic way to show your support is to ⭐️ star the project, or raise 🐞 issues.

---