https://github.com/soranoo/TradingView-Free-Webhook-Alerts
Free TradingView webhook alert for basic plan users.
https://github.com/soranoo/TradingView-Free-Webhook-Alerts
email imap pipedream python tradingview tradingview-alert webhook
Last synced: 6 months ago
JSON representation
Free TradingView webhook alert for basic plan users.
- Host: GitHub
- URL: https://github.com/soranoo/TradingView-Free-Webhook-Alerts
- Owner: soranoo
- License: gpl-3.0
- Created: 2022-02-07T16:12:26.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-08-17T04:44:57.000Z (about 1 year ago)
- Last Synced: 2024-08-17T08:30:05.828Z (about 1 year ago)
- Topics: email, imap, pipedream, python, tradingview, tradingview-alert, webhook
- Language: Python
- Homepage:
- Size: 3.71 MB
- Stars: 171
- Watchers: 8
- Forks: 65
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# TradingView-Free-Webhook-Alerts
The project starts on 01-02-2022.
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://github.com/soranoo/Donation)
Providing the free webhook service to the basic plan users in TradingView.
Give me a ⭐ if you like it.
### Portal ↠ [Installation](docs/gettingstarted.md#installing-python-package) · [Usage](docs/gettingstarted.md#setting-up-tradingview-alert) · [Cloud Versions](docs/cloud-versions/cloud-versions.md) · [Videos](https://www.youtube.com/playlist?list=PLOHaKcov3Nkt0LIK1joPYgFnZY24zf_Wo) ↞
## :newspaper: NEWS
###### <<< - [Mar 02, 2025] - >>>
- Removed `Google App Script` as a cloud provider. See [issue #94](https://github.com/soranoo/TradingView-Free-Webhook-Alerts/issues/94) for more details.
- Not longer recommend using `Pipedream` as a cloud provider. See [issue #94](https://github.com/soranoo/TradingView-Free-Webhook-Alerts/issues/94) for more details.
- Added `Zapier` as a cloud provider. ([Read Docs](docs/cloud-versions/zapier/zapier.md))
###### <<< - 🎄 [Dec 25, 2024] 🎁 - >>>
Support broadcast to [Telegram](#-support-broadcast-methods)
2 new fields added to the [config file](/config.example.toml). Don't forget to update your existing [config file](/config.example.toml).
```toml
# ---------------* Telegram (Broadcast) *---------------
tg_bot_token = ""
tg_chat_id = ""
```
Fill these fields with your Telegram Bot Token and Chat ID to enable the Telegram broadcast feature.
## 🗝️ Features
* No Pro/Pro+/Premium TradingView account requested.
* Supported [Dicord](https://discord.com/) monitoring.
## 🚩 How it works ?
Listen to the email inbox and transfer the TradingView alert email into the webhook message.
## ⚓ Requirements
* Python 3.8.1 or latest (*Developed in Python 3.8.1 & 3.10.11 & 3.11.6)
* A TradingView account
* See the installation guide for more details.
## 👾 Getting Started
- To install locally or on Docker, check out the [Getting Started guide](docs/gettingstarted.md).
- To install on the cloud, check out the [Cloud Versions](docs/cloud-versions/cloud-versions.md).
##### Comparison - Local vs Docker vs Cloud
| | Local (traditional) | Local (ngrok) | Docker (ngrok) | Cloud |
| --- | --- | --- |--- | --- |
| **Uptime** | Depends on running the environment | Depends on running the environment | Depends on running the environment | 24/7 |
| **Cost** | Free | Free | Free | Free / Paid |
| **Setup** | 💀💀 | 💀💀💀 | 💀💀💀 | 💀 |
| **Limitation** | None? | None? | None? | Depends on the service provider |
| **Speed** | ⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| **Stability** | ⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| **Scalability** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐ |
| **Portability** | ⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ | N/A |
| **Recommendation** | 🚫 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| **Tutorial Video** | 🚫 | [Youtube](https://youtu.be/_ZN_rbH1OuM) | 🚫 | [Youtube](https://youtu.be/kTEcJhz0M98) |
| **Setup Docs** | [DOCS](docs/gettingstarted.md#3-traditional-version) | [DOCS](docs/gettingstarted.md#2-ngrok-version) | [DOCS](docs/gettingstarted.md#2-ngrok-version) | [DOCS](docs/cloud-versions/cloud-versions.md) |
> The ngrok Docker version setup is similar to the ngrok local version so I am not going to make a tutorial video for it.
## 📺 Support Broadcast Methods
> The term "Broadcast" means sending your TradingView alerts to multiple destinations.
| | Webhook1 | Telegram |
| --- | --- | --- |
| **Local (traditional)** | Supported | Supported |
| **Local (ngrok)** | Supported | Supported |
| **Docker (ngrok)** | Supported | Supported |
| **Cloud** | Supported | Supported2 |
1. All applications support Webhook, for example, Discord, 3commas, etc.
2. See the dedicated provider docs for more details.
## 📬 Notice
#### Local (traditional)
* The program will read the incoming email and mark it as read.
* It is suggested to create a new email account for the best performance and risk management.
* The webhook message will not be sent immediately due to the latency of the email service provider & TradingView. It will normally take about **2-8 seconds** before the webhook message is sent. (**mainly depends on the network traffic between TradingView and your email service provider**) Please consider carefully before using the program for fast-moving markets.
## 🦔 Potential Risk
#### Local (traditional)
* Email accounts may be locked because of high-frequency IMAP action.
- Reports have been received that some user was locked by Outlook.
## 🗯️ Combination
You can combine the program with other services.
For example,
* You may use [TradingView-Webhook-Bot](https://github.com/fabston/TradingView-Webhook-Bot) to spread the webhook message.
* You may send a webhook to [3commas](https://3commas.io/) for auto trading.
* You may send a webhook to [Discord](https://discord.com/) for sharing the signal.
## :question: FAQ
* **Q: Some exchnage banned my IP. What should I do?**
- A: You may use a proxy to bypass the IP ban. You should see there is a proxy option in the config file. Related issue: [#69](https://github.com/soranoo/TradingView-Free-Webhook-Alerts/issues/69)
## ⭐ TODO
* N/A
## 🐛 Known Issues
* N/A
## 🤖 Useful Links
* Update TradingView `Email-To-SMS`: [LINK](https://www.tradingview.com/support/solutions/43000474398-how-to-change-the-email-to-sms-address-used-for-alert-notifications/)
## 💣 Disclaimer
I as the author assume no responsibility for errors or omissions in the contents of the Service.
In no event shall I be liable for any special, direct, indirect, consequential, or incidental damages or any damages whatsoever, whether in an action of contract, negligence or other torts, arising out of or in connection with the use of the Service or the contents of the Service. I reserve the right to make additions, deletions, or modifications to the contents of the Service at any time without prior notice.
(Service refers to the **TradingView-Free-Webhook-Alerts**.)
## ⭐ Star History
[](https://star-history.com/#soranoo/TradingView-Free-Webhook-Alerts&Date)
## ☕ Donation
Love the program? Consider a donation to support my work.
[](https://github.com/soranoo/Donation) <- click me~