TRADINGVIEW ALERTS TO CTRADER COPIER

 This trade copier for 'TradingView Alerts -> cTreader' consists of three parts:

- Google Chrome at your computer

- 'TVBridge' - TradingView alert signal bridge app. it runs on Windows OS and seamlessly fetch TradingView alerts through Chrome browser

- 'TVToCTraderCopier' - it is a cTrader copier cbot that will sync alert messages with 'TVBridge' app and place copied trades on cTrader

OS Requirement: Windows OS (i.e. Windows 10 or 11, Windows Server 2016 or above)

The delivery package includes one zip file and one cTrader bot (.algo) file.

1. Unzip 'TVBridge.zip'.  It has to run on Windows 64-bit OS (e.g. Windows 10 or 11 or Windows Server 2016 or above)

2. Fill in your license key at 'config.ini' file inside that unzipped folder

for instance

license_key=abc@gmail.com

and then save it.

You could set chrome browser height, width, sound option at this config.ini file as well.

* If you don't have Chrome installed at your computer or VPS, please install Chrome in advance.

3. Run 'TVBridge.exe' and wait for 'Ready to start' message appears.  Then click 'Start' button.

It will print a reminder message at the bridge log window:

'Have enabled a new session of special mode of Chrome.  Please login your TradingView account at that Chrome.  To click 'Start' button again will close that Chrome'.  Please remember to close that Chrome before exiting this bridge'.

It will initiate a new session of special mode of your Chrome browser with Tradingview home page. 

Please login your Tradingview account at that Chrome window.

If you're using TradingView gmail account, please log in at the 'Email' section other than 'Google' section of TradingView page.

If you have any concern on this login method, you could enable TradingView 2FA login.

Please keep one TradingView chart opened when you receive alerts.

Enable your indicator or stragegy alert at the indicator menu by selecting 'Add alert on xxxxx'

This copier is to fetch TradingView alert popup.  Please ensure you've selected 'Show toast notification' at that alert setup window.

4. Back to cTrader side.  

open your computer's 'Documents' folder

go to '\cAlgo\Sources\Robots' path

move 'TVToCTraderCopier.algo' file to this 'Robots' folder

Please use a demo account for hands-on first.  

Select cTrader 'Trade' tab (as marked in light blue at below screenshot) and then open any chart to attach this copier bot.  Do not select 'automate' tab that is for backtest.

3. At cTrader top icon menu, click that cBot icon as marked in read at above screenshot to see whole cBot list.  Select TVToCTraderCopier cBot.

Then cTrader will ask to allow full access.  Please click Yes as this copier bot need to use windows system internal data exchange with that bridge app.

Click cBot start > button to start that cBot.  That start button (circled in yellow at above screenshot) has been turned red as it's running now.

*****

Below are the variable explanations at cTrader copier side:

1. 'Long Trade Switch' & 'Short Trade Switch' - switch variables for long or short trade.

2. Lot Mode -  it has two options - 'fixed lot' or 'Follow Lot Info from TradingView'.  default is fixed lot and can be set at 'Fixed Lot' variable.  If selecting 'follow lot info' mode, please refer to lot info parsing rule at latter variable explanation.

3. Symbol Mapping List - this is to map the different symbol name between TradingView & cTrader.  default will assume the signal symbol from TradingView is identical with cTrader's.

for instance

GOLD,XAUUSD;SILVER,XAGUSD; 

TradingView symbol of GOLD alert will be mapped to cTrader's symbol of XAUUSD

each symbol uses ',' comma as seperator. First symbol is TradingView's while the second is cTrader's. each pair uses ';' semicolon as separator.

4. Close Trade By Oppposite Signal - default is 'yes'.  this copier will follow TradingView's default netting/futures trading rules and thus close opposite short/long trades before placing a new long/short trade.  if you don't like this rule, you could set this to 'no'.

5. Tp & SL in tick - default are both zero (i.e. disabled)

6. Below are for alert message parsing rules

Keywords for LONG or SHORT trade - this copier has listed some common keywords to identify an alert message as a LONG or SHORT signal.  you could supplement your own by adding it with comma separation.

Excluded keywords from opening trade - NOT to open trade if those keywords are shown at messages.

Enable close trade keywords - enable keyword check to close trade.

Keywords to close LONG or SHORT trade - EA close trades for those keywords.

If you want to close all trades, set keywords list to 'Keywords to close both LONG & SHORT trades'.

If the close trade alerts from TradingView contain xx%, EA will follow the close ratio to partially close the applicable local trades, e.g. 'close long 50%'

Taking TP price from TradingView

default is off.  If enabled, the copier bot will use the TP prices described at TradingView signal texts.

Taking SL price from TradingView

default is off.  If enabled, the copier bot will use the SL prices described at TradingView signal texts.

* For instance, if the TP/SL price text format at TradingView signals is

BUY TP:1.06218, SL:1.03218

To parse this content, below variables should be set as

TP price head strings set as

TP:

SL price head string set as

SL:

'Close by Trade ID' feature

This is designed for trade exit needs of TradingView martingale strategy. Default is disabled.

1. At TradingView alert message, add trade ID identity at strategy.entry and strategy.exit comment (or alert_message) field.

e.g. trade entry:

LONG ID:LONG#1

LONG ID:LONG#2

trade exit

CLOSE LONG ID:LONG#1

CLOSE LONG ID:LONG#2

2. At cTrader copier side,

'Close trades by ID' ---> set to true to enable

'ID head string' ---> set ID: as head string to parse

'ID tail string' ---> leave blank to match above TradingView alert message example as it has no tail string

* Allowed symbol list from TradingView alerts 

default is the blank string. it will take all symbol alerts from TradingView. if setting a string of allowed symbols, this copier bot will only accept the alert signals of those symbols.  if symbol more than one, add comma in between, e.g. EURUSD,GBPUSD.  but 'symbol mapping list' is required to set up if cTrader has different symbol name.

* How to set up and use lot info at TradingView alert 

1. select 'Lot info from TradingView' at 'Lots mode' variable

2. set lot parsing texts at 'TradingView Lot Info Head String' & 'TradingView Lot Info Head String' variables

'TradingView Lot Info Head String' - default text is 'Lot:'

For instance 

Buy Lot:2

Copier will use 2 lots to copy trade.

That is to precisely fetch the string before and after the lot number 

3. TraidingView lot info to cTrader ratio

default is 1.0.  if setting 0.1, 2 lot info from TradingView will be multiplied by 0.1.  the result is 0.2 lot for copy trade.