> For the complete documentation index, see [llms.txt](https://tv-connector.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tv-connector.gitbook.io/docs/overview.md).

# Overview

Free and noncustodial tool for you to Integrate TradingView alert and execute automated trading for perpetual futures DEXes.

Currently, it supports dYdX [v4,](https://dydx.trade/?ref=LawfulBalletF7U) [Perpetual Protocol](https://perp.com/),  [GMX v2](https://app.gmx.io/#/trade)(Arbitrum), [Bluefin](https://trade.bluefin.io/r/v2-jn3t5p) and [Hyperliquid](https://app.hyperliquid.xyz/join/0XIBUKI).

All software is [open source](https://github.com/junta/tradingview-alert-connector), and this tool runs on users’ systems (rather than on a centralized platform). This requires that users run their bot, for which we recommend using a cloud service provider.

![Sample Built-in Supertrend strategy](/files/P6Vh8bdt6AoqL27rT80r)

**Source code:** <https://github.com/junta/tradingview-alert-connector>

**Video tutorial:**

dYdX v3: <https://www.youtube.com/watch?v=I8hB2O2-xx4>

Perpetual Protocol: <https://youtu.be/YqrOZW_mnUM>

GMX v2:  <https://www.youtube.com/watch?v=RMNHVMSDccE>

**Strategy alert Message Generator tool:** <https://alert-message-generator.vercel.app/>

### Prerequisites

* Computing machine(Cloud service, local PC, Raspberry Pi, etc...) that has a stable internet connection to host this tool
* TradingView Account at least Pro plan($12.95/month)

\*To enable Webhook notification to send alerts from Tradingview

{% embed url="<https://www.tradingview.com/gopro>" %}

* Trading account with collateral already in place

\*This tool does not include any onboarding function, so

For dYdX v3, v4 and Perpetual Protocol, deposit collateral in advance.

For GMX, the tool uses native USDC(<https://arbiscan.io/token/0xaf88d065e77c8cc2239327c5edb3a432268e5831>) as collateral token by default.

**We recommend creating and using an exclusive different account for running a trading bot.**

* My referral links to get a trading fee discount

{% embed url="<https://app.hyperliquid.xyz/join/0XIBUKI>" %}

{% embed url="<https://dydx.trade/?ref=LawfulBalletF7U>" %}

{% embed url="<https://app.perp.com/?code=0xibuki>" %}

{% embed url="<https://app.gmx.io/#/trade/?ref=tv_alert_connector>" %}

{% embed url="<https://trade.bluefin.io/r/v2-jn3t5p>" %}

### Main Features

* Receive strategy alert from Tradingview via webhook and execute a corresponding market order
* Support for running multiple strategies/markets/exchanges at the same time
* Export order history by each strategy to CSV
* Support [sentry.io](http://sentry.io) for monitoring

### Security measures

* Utilized environment variables
* Installed [Helmet ](https://www.npmjs.com/package/helmet)package
* Implemented passphrase auth between Tradingview alert and your web server

### Setup steps

Two steps are needed, which are&#x20;

1. Setting up a web server on your environment(local or cloud)
2. Setting a strategy alert on Tradingview website

If you want to test the tool on testnet, go to [Running on local PC](/docs/setup/run-on-local-pc.md) (optional).

If you don't need to do, go to [Running on cloud service page](/docs/setup/run-on-cloud-service.md) directly.

### Need help?

DM to [my Twitter](https://twitter.com/CryptoIbuki) or [raise issue on Github](https://github.com/junta/dydx-tradingview-integration/issues)

### **Disclaimer**

This project is hosted under an MIT OpenSource License. This tool does not guarantee users’ future profit and users have to use this tool on their own responsibility.
