1.1 Trade Interface

• 1.) The trading pair
• 2.) The trade type (on leverage exchanges buy = long, sell = short). "Close" will exit your position, no matter if long or short. If there is no open position nothing will happens.
• 3.) Absolute value means you have to specify a fixed amount for the trade. "Percent available balance" means you use a percentage of your available balance. With "percent wallet" you trade the entire balance, even if some of it is locked up in a trade. Be careful with this option because under some circumstances the trades may not open. General recommendation if you use one of the percent options: It is safer to use 95% instead of 100%. This will let room for fees and slippage.
• 4.) The trade size (amount of coins you want to buy or sell)
• 5.) The order type
• 6.) The price in case you use a limit order
• 7.) The total amount (order size x price)
• 8.) On leverage exchanges you can set your leverage. On bitmex you have to drag the slider to 0 to use cross. On binance futures & bybit you can set this with a radion button.
• 9.) You can activate a stop-loss and choose if you want to use a percent value below your entry or a fixed value
• 10.) The stop-loss value. In case you use "percent" this will be filled in automatically
• 11.) With the slider you can change the percent value
• 12.) Trailing SL is explained in detail in this video: click
• 13.) The trailing percentage value.
• 14.) You can activate (multiple) take profit targets and choose if you want to use a percent value or a fixed value for the target price.
• 15.) In the amount field you need to specify the amount you want to exit at this take profit target. In case you trade a percent value of your wallet, you need to specify a percent value you want to exit.
• 16.) You can add more take profit targets with this button or delete the last one
• 17.) If you choose this option and you have an open position of the opposite direction it will be closed. This is useful if you want to flip a position (e.g from LONG to SHORT).
• 18.) With this button you can generate the trade command
• 19.) This button copies the trade command to the clipboard
• 20.) You can execute the trade directly on the exchange. This is useful for testing if you want to check if everything is working correctly.

1.2 Webhook URL

The webhook endpoint for tradingview is:

If you want need really fast execution you can use this endpoint. This one will not go through our queue system. But for most users we recommend the default webhook:

The IP list for this endpoint could be found here

IMPORTANT: Binance Futures users should use this endpoint:

For faster execution on Binance Futures you can use this endpoint. This one will not go through our queue system. But for most users we recommend the webhook above:

The IP list for this endpoint could be found here

1.3 TradingView Alert Setup

Go to tradingview.com to setup the alert. Wherever you can create an alert at TV you are able to trigger a trade. In this example we are using the BUY alters of the MarketGod Indicator.

Create an alert like this:

The create alert form looks like this:

1. ) Choose your alert condition
2. ) Choose the alert option. "Once Per Bar Close" is recommended to avoid indicator repainting. "Once Per Bar" could work for other conditions as well.
3. ) Activate the checkbox "Webhook URL" and paste this URL: https://alerts.tv-hub.org
4. ) Paste your alert message that you created with the tv-hub exchange interface. For more details on this topic take a look at the trade examples.
5. ) Hit the create button

1.4 Set Stop-loss

To set a stop-loss you need to tick the checkbox "Stop-Loss"

1. ) Activate the stop-loss (1)
2. ) If you choose the option "Use percent" (2) the SL will always be placed relative to your current entry price. If you are LONG 4% below your entry or if you are SHORT 4% above your entry.
3. ) The option "Use absolute value" (3) will always place the SL at the value you provided.

1.5 Set Take-Profit

To set a take-profit you need to click the button "Add Take-Profit-Step"

If you want to set the price for your take profit you have two options. 1.) use a precent value. In this example 10% above (for LONGS) or below (for SHORTS) from your average entry. The TP will always be placed relative to your current entry price.

Example:

Or 2.) you define a fixed price where the take profit should be placed.

For the order size of your take profit you are able to define the amount as a fixed value like $100 or 0.1 BTC

Or you use a percent value. For example exit 30% at target 1.

In this case all amount values must be combined equal or less than 100. For example if you have 4 take-profit steps you can set each TP to 25.

1.6 Set Trailing Take-Profit

To submit a trailing take profit order you have two options:

1.) Define a trailing take-profit when you open a position by clicking on the button "Add Take-Profit-Step":

NOTE: On Binance-Futures you can set multiple trailing TP orders. On Bybit just one.

2.) Send a separate trade command which only submits a trailing TP order. For example when you already have an open position:

1.7 DCA / scaling orders

To activate the DCA (dollar cost average) orders you need to tick the checkbox "Use DCA (Order-Mesh)". With this option you are able to scale into a position.

1. ) Choose the range in percent. In this range the system will place the orders based on your entry price.
2. ) Choose the number of orders. You can define up to 10 scaling orders.
3. ) The system will split the order size evenly between the initial order and the dca orders.
4. ) For example you define a trade command to open a $100 position. And you define 4 DCA orders 5% below the entry. The system will now generate 5 orders (the initial order + 4 DCA orders). Each order with the size of $20.
5. ) You can use it with a market order. In this case the first order will enter immediately and the DCA orders will be placed as limit orders below the entry.
6. ) Or you can define all orders as limit orders.
7. ) This will also work with a percent value of your balance.

1.8 Close Position

If you want to exit a postion you can use the close command. The system will execute a market order to exit the position as soon as possible. Additionally all open orders of the current pair are cancled (limit orders, SL)

If you activate the order type "Close position" you have the following options:

1. ) "Close All" will close the current position no matter if it's long or short.
2. ) "Close Long" will only close a long position.
3. ) "Close Short" will only close a short position.
4. ) "Partial close" allows you to exit just a percentage of your position.

1.9 Limit Order Chasing

The limit order chasing option can move your limit order to the front of the orderbook as long as it remains unfilled. By default, this repositioning will occur every 20 seconds, up to 180 times (in total for one hour). It's possible to modify the delay interval.

1. ) You must select the option "Use best price (Best Bid/Ask price)" in order to insert the limit order at the current best price on top of the order book
2. ) Activate "Use order chasing". The system will attempt to update your order 180 times. If the order remains unfilled after these attempts, you can choose to either enter a market order or cancel your current limit order.
3. ) Activate the option "Change update intervall" if you want to adjust the default settings. By default, the order updates occur every 20 seconds, up to a maximum of 180 times (in total for one hour). You can adjust this interval to be as short as 1 second or as long as 300 seconds. However, keep in mind that the total number of update attempts remains unchanged. With a 1-second interval, the order chasing period will be only 3 minutes. Additionally, be aware that setting a very low delay may lead to rate limiting issues with the exchange.

1.10 Binance-Futures Hedge Mode

On Binance-Futures you can use the "Hedge Mode". This allows you to open long and short positions at the same time. The prerequisite for this is to change the position mode on Binance-Futures to "Hedge Mode"

If you want to use the hedge mode with your trade commands you have to activate the checkbox "Hedge Mode":

If you use the close command with the hedge mode "close all" would close long & short while the other options close only one side:

1.11 Save trade setup

You can save your trade setup to load and edit it at a later time.

1.) Create the trade command by clicking the "generate" button

2.) Then click on the "save" button and give the trade command a name.

1.12 Load trade setup

You can load your trade setups:

1.) Click on the "open" button" in the left upper corner:

2.) Then click on one of your trade setups:

1.13 Paste trade command

For example if you have a running TradingView alert and you want to modify the trade command a bit. You can do it like this:

1.) Go to your alert and click edit. Then copy the trade command.

2.) In tv-hub click on the "paste" button" in the left upper corner:

3.) Paste the command in the textbox and click OK. The UI will parse the trade command and displays it accordingly

Here is a complete walk through video:

1.14 How to automate strategy alerts

If you have control over the pine code of your strategy you can paste your trade commands directly into your pinescript code. If you have no access to the pinecode watch the video tutorial for another option to use the strategy alerts.

Now you need to create the alert and use the "strategy.order.comment" variable to execute the trade like this:

Close position with a strategy alert

If you have no control over the pine code you need to use the option "Enable strategy alerts". If the value of the "strategyComment" variable contains the string "exit" or "close" tv-hub will execute a close command.

Sometimes the dev of the strategy uses a different "strategyComment" value. For example something like "Ex Short". Now you are able to define this value within the variable "strategyCloseValue" in your trade command. And when the "strategyComment" variable contains your defined value tv-hub will execute a close command. It would look like this:

You can also define multiple strategyCloseValues by using this separator char: |

1.15 Multiple alerts at once

You can send multiple alerts at once by putting them in square brackets and separate them by comma like this:

Example:

1.16 For developers: Use TV-Hub's alert endpoint

You are a developer and you want to execute trades through TV-Hub? No problem, just send a POST request with the trade command in the body to the alert endpoint: https://alerts.tv-hub.org

Here is a postman example:

2.1 Long (market)

Let's say we want to go immediately LONG on XBT with 100 contracts market order on 10x, a stop-loss of 5% and a take-profit of 10%.

• Choose your trading pair: XBTUSD
• Choose BUY for a LONG position.
• Set the trade size. In this example 100
• Set order type to market
• The price is set automatically because it is a market order.
• Total shows you the value of the trade in XBT.
• Set the leverage to 10.
• Activate the stop-loss and set it to -5%. The exact value will be calculated. Or you choose a fixed value.
• Hit the button "Add Take-Profit-Step" and set it to 10%. The exact price will be calculated. Or you choose a fixed value. Then choose the take profit size. In this case 100.
• You can choose multiple profit targets by clicking the "Add Take-Profit-Step" button again.

Now the setup is finished and you can hit the "Generate" Button:

After that you can hit the "Copy" Button to copy the trade command to your clipboard:

The trade window should look like this:

Now you have to go to tradingview.com to setup the alert. Wherever you can create an alert at TV you are able to trigger this pre-build trade above. In this example we are using the BUY alters of the MarketGod Indicator.

Create an alert like this:

The create alter form looks like this:

1. ) Choose your alert condition
2. ) Choose the alert option. "Once Per Bar Close" is recommended to avoid indicator repainting. "Once Per Bar" could work for other conditions as well.
3. ) Activate the checkbox "Webhook URL" and paste this URL: https://alerts.tv-hub.org
4. ) Paste your alert message from above
5. ) Hit the create button

2.2 Short (market)

Let's say we want to go immediately SHORT on XBT with 100 contracts market order on 10x, a stop-loss of 5% and a take-profit of 10%.

• Choose your trading pair: XBTUSD
• Choose SELL for a SHORT position.
• Set the trade size. In this example 100
• Set order type to market
• The price is set automatically because it is a market order.
• Total shows you the value of the trade in XBT.
• Set the leverage to 10.
• Activate the stop-loss and set it to -5%. The exact value will be calculated. Or you choose a fixed value.
• Hit the button "Add Take-Profit-Step" and set it to 10%. The exact price will be calculated. Or you choose a fixed value. Then choose the take profit size. In this case 100.
• You can choose multiple profit targets by clicking the "Add Take-Profit-Step" button again.

Now the setup is finished and you can hit the "Generate" Button:

After that you can hit the "Copy" Button to copy the trade command to your clipboard:

The trade window should look like this:

Now you have to go to tradingview.com to setup the alert. Wherever you can create an alert at TV you are able to trigger this pre-build trade above. In this example we are using the SELL alters of the MarketGod Indicator.

Create an alert like this:

The create alter form looks like this:

1. ) Choose your alert condition
2. ) Choose the alert option. "Once Per Bar Close" is recommended to avoid indicator repainting. "Once Per Bar" could work for other conditions as well.
3. ) Activate the checkbox "Webhook URL" and paste this URL: https://alerts.tv-hub.org
4. ) Paste your alert message from above
5. ) Hit the create button

2.3 Binance - BUY (market)

Let's say if an alert occurs we want to BUY immediately 0.1 BTC with a market order, a stop-loss of 4% and a take-profit of 10%.

• Choose your trading pair: BTCUSDT
• Choose BUY.
• Set the trade size. In this example 0.1 BTC
• Set order type to market
• The price is set automatically because it is a market order.
• Total shows you the value of the trade in USDT.
• Activate the stop-loss and set it to -4%. The exact value will be calculated. Or you choose a fixed value.
• Hit the button "Add Take-Profit-Step" and set it to 10%. The exact price will be calculated. Or you choose a fixed value. Then choose the take profit size. In this case 0.1.
• You can choose multiple profit targets by clicking the "Add Take-Profit-Step" button again.

Now the setup is finished and you can hit the "Generate" Button:

After that you can hit the "Copy" Button to copy the trade command to your clipboard:

The trade window should look like this:

Now you have to go to tradingview.com to setup the alert. Wherever you can create an alert at TV you are able to trigger this pre-build trade above. In this example we are using the BUY alters of the MarketGod Indicator.

Create an alert like this:

The create alter form looks like this:

1. ) Choose your alert condition
2. ) Choose the alert option. "Once Per Bar Close" is recommended to avoid indicator repainting. "Once Per Bar" could work for other conditions as well.
3. ) Activate the checkbox "Webhook URL" and paste this URL: https://alerts.tv-hub.org
4. ) Paste your alert message from above
5. ) Hit the create button

2.4 Binance - BUY (limit)

Assume if an alert occurs we want to BUY 0.15 BTC with a limit order.

• Choose your trading pair: BTCUSDT
• Choose BUY.
• Set the trade size. In this example 0.15 BTC
• Set order type to limit
• Choose the price you want to buy. In this example $8100.
• Total shows you the value of the trade in USDT.

Now the setup is finished and you can hit the "Generate" Button:

After that you can hit the "Copy" Button to copy the trade command to your clipboard:

The trade window should look like this:

Now you have to go to tradingview.com to setup the alert. Wherever you can create an alert at TV you are able to trigger this pre-build trade above. In this example we are using the BUY alters of the MarketGod Indicator.

Create an alert like this:

The create alter form looks like this:

1. ) Choose your alert condition
2. ) Choose the alert option. "Once Per Bar Close" is recommended to avoid indicator repainting. "Once Per Bar" could work for other conditions as well.
3. ) Activate the checkbox "Webhook URL" and paste this URL: https://alerts.tv-hub.org
4. ) Paste your alert message from above
5. ) Hit the create button

Close position (For SL or TP)

This example shows how to use alerts to exit a position. It could be used as a stop-loss or a take-profit. If this signal is executed it will check if there is an open position (in this example BTCUSDT), it will remove all current limit SELL orders on this pair (OCO-, SL- or TP-orders) and execute a market SELL against the quote asset. In this case it will sell all BTC to USDT.

We use this BTCUSDT chart as an example. We are in a BTC position, the orange line is our stop-loss and the blue line our take-profit.

Set a stop-loss

Right click on the orange line and choose add alert:

1. ) Choose the alert condition "Crossing Down"
2. ) Choose the alert option. "Only Once".
3. ) Activate the checkbox "Webhook URL" and paste this URL: https://alerts.tv-hub.org
4. ) Paste your alert message from above
5. ) Hit the create button

Set a take-profit

Right click on the blue line and choose add alert:

1. ) Choose the alert condition "Crossing Up"
2. ) Choose the alert option. "Only Once".
3. ) Activate the checkbox "Webhook URL" and paste this URL: https://alerts.tv-hub.org
4. ) Paste your alert message from above
5. ) Hit the create button

2.6 Switch position (From long to short)

This example shows how to switch a position from long to short. Imagine we are in a long position with 1 BTC. With our next signal we want to sell our 1 BTC and open a short position of 1 BTC. Make sure you enable the checkbox "Close current position". This will check the current position size and add this to the order. In this example 1 BTC long + 1 BTC short = 2 BTC sell order. Of course this also works in the other direction from short to long.

Now your can hit create and setup the tradingview alert.

3.1 Bitmex

Log into your Bitmex account and open the account settings:

Open the API Keys:

Create an API key:

• choose a name for the API key. For example "tv-hub"
• Set the key permission to "order"
• If it's enabled: Confirm with your 2-FA key
• Hit Create API Key

Copy the created API key + secret:

Paste the API key + secret into your tv-hub settings:

After you confirm with the save button the API key should appear in the table below:

Now your key is valid for 7 days or until the end of your subscription and you can start trading immediately. If you used our referral link for Bitmex you will see a green check mark and no expiration:

You can always delete your API keys with the trash icon and replace it with a new one.

3.2 Bitmex Testnet

Log into your Bitmex testnet account and open the account settings:

Open the API Keys:

Create an API key:

• choose a name for the API key. For example "tv-hub"
• Set the key permission to "order"
• If it's enabled: Confirm with your 2-FA key
• Hit Create API Key

Copy the created API key + secret:

Paste the API key + secret into your tv-hub settings:

After you confirm with the save button the API key should appear in the API key table.

You can always delete your API keys with the trash icon and replace it with a new one.

3.3 Binance

Log into your Binance account and open the account settings:

• choose a name for the API key. For example "tv-hub"
• Hit the create button
• If it's enabled: Confirm with your 2-FA key

Then you should see a email confirm page. Confirm the Binance mail by clicking the link.

After that you should see the new created key. Now it's time to edit the restrictions:

• Enable the checkbox Spot & Margin Trading
• Optional: enable futures trading
• To avoid that your API key expires bind it to our IP list. Copy & paste the tvhub IP list:

52.178.43.209 13.81.120.121 23.101.74.176 104.40.189.59 23.101.70.119 52.178.46.226 52.166.118.167 13.69.68.7 20.82.83.137 20.82.84.106 20.82.84.161 20.82.85.24 20.82.85.156 20.82.86.9 20.82.86.122 20.82.87.61 20.101.240.10 20.101.240.38 20.101.241.140 52.174.236.207 52.174.236.246 52.174.236.136 52.232.16.136 52.232.23.166 52.174.236.251 52.174.236.214

Hit the save button:

Now paste the API key + secret into your tv-hub settings:

Your options to use our service:

• Test-Period for each exchange: 7 days
• Use a subscription here
• Use our service for FREE by using our referral links:

1.) Create a binance account with our referral link here

2.) Generate the API key & submit the key together with your account UID (see screenshot below)

3.) We will review the provided UID & if it's part of our referral list we will approve the key and you can use it without expiration. As soon as the key is approved you see a green check mark instead of the expire date.
Remark: You can open new binance accounts without any issues. You don't have to do a new KYC. The only limitation you have in this case is the daily withdraw limit.

After you signed up you need to login into your profile settings, copy your UID and paste it here. We will review your provided UID and if you are part of our referrals you can use this key without expiration.

After you confirm with the save button the API key should appear in the table below:

Now your key is valid for 7 days or until the end of your subscription and you can start trading immediately. If you provided an user ID and we confirmed that (within the next few days). You will see a green check mark:

You can always delete your API keys with the trash icon and replace it with a new one.

3.4 Binance Futures

Log into your Binance account and open the account settings:

• Choose a name for the API key. For example "tvhub"
• Hit the create button
• If it's enabled: Confirm with your 2-FA key

Then you should see a email confirm page. Confirm the Binance mail by clicking the link.

After that you should see the new created key. Now it's time to edit the restrictions:

• Enable the checkbox Spot & Margin Trading
• Enable futures trading
• To avoid that your API key expires bind it to our IP list. Copy & paste the tvhub IP list:

20.194.185.150 20.191.169.179 20.191.172.69 20.48.71.250 20.191.172.206 20.191.173.63 20.191.174.156 20.191.175.88 20.78.104.150 20.78.105.3 20.78.105.95 20.78.105.134 20.78.105.150 20.191.175.195 20.78.105.154 20.78.105.162 20.78.105.172 20.78.105.244 20.78.106.67 20.78.106.119 20.78.106.130 20.48.71.143 20.78.106.137 20.78.106.149 20.78.106.151 20.191.173.152 20.78.106.157 20.78.106.166 20.46.190.72 20.78.106.172 20.43.67.38 13.69.68.7 52.174.236.207 52.174.236.246 52.174.236.136 52.232.16.136

Hit the save button:

Paste the API key + secret into your tv-hub settings:

Your options to use our service:

• Test-Period for each exchange: 7 days
• Use a subscription here
• Use our service for FREE by using our referral links:

1.) Create a binance account with our referral link here

2.) Generate the API key & submit the key together with your account UID (see screenshot below)

3.) We will review the provided UID & if it's part of our referral list we will approve the key and you can use it without expiration. As soon as the key is approved you see a green check mark instead of the expire date.
Remark: You can open new binance accounts without any issues. You don't have to do a new KYC. The only limitation you have in this case is the daily withdraw limit.

After you signed up you need to login into your profile settings, copy your UID and paste it here. We will review your provided UID and if you are part of our referrals you can use this key without expiration.

After you confirm with the save button the API key should appear in the table below:

Now your key is valid for 7 days or until the end of your subscription and you can start trading immediately. If you provided an user ID and we confirmed that (within the next few days). You will see a green check mark:

You can always delete your API keys with the trash icon and replace it with a new one.

3.5 Binance Futures Testnet

Log into your Binance Futures Testnet account and open the API key section:

Paste the API key + secret into your tv-hub settings:

After you confirm with the save button the API key should appear in the table below:

You can always delete your API keys with the trash icon and replace it with a new one.

3.6 Bybit

Log into your Bybit account and open the API section:

On the next page:

• Click on API Management
• Create new key

On the next page:

• Click on System-generated API Keys

On the API key page:

• Choose "Connect to Third-Party Application"
• Choose "tv-hub.org"
• Set the API key permissions
• Click submit

• Pass the security check
• Hit Confirm

Paste the API key + secret into your tv-hub settings and hit save:

After you confirm with the save button the API key should appear in the table below:

Now your key is valid for 7 days or until the end of your subscription and you can start trading immediately. If you used our referral link for Bybit you will see a green check mark and no expiration:

You can always delete your API keys with the trash icon and replace it with a new one.

3.7 Bybit Testnet

Log into your Bybit account and open the Account & Security section:

On the next page:

• Click on API Management
• Create new key

• Choose a name for the API key. For example "tvhub"
• Select "Active Order and Positions" as the key permissions
• Enter your 2-FA code
• Hit Confirm

Paste the API key + secret into your tv-hub settings and hit save:

3.8 OKX

Log into your OKX account and open the API keys creation page here

Or from the top right menu:

1.) Select "Linking third-party apps"

2.) From the dropdown menu select "tv-hub.org"

2.) Give the key a name

4.) Enter a passphrase

5.) Set the permissions to "trade"

Then hit the button "Confirm"

Paste the API key + secret + the passphrase you set on OKX into your tv-hub settings:

After you confirm with the save button the API key should appear in the table below:

Now your key is valid for 7 days or until the end of your subscription and you can start trading immediately. If you used our referral link we will approve your key (within the next few days). You will see a green check mark:

You can always delete your API keys with the trash icon and replace it with a new one.