TRADINGVIEW ALERTS TO NINJATRADER TRADER COPIER

 

This is the user guide for 'TradingView Alerts to NinjaTrader Copier'

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

- Google Chrome at your computer

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

- 'TVToNT8Copier' - it is a NT8 copier that will sync alert messages with 'Trade Bridge app' and place copied trades on NT8

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

The delivery package includes 2 zip files

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=wallstreetbulls@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 messsage 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 NT8 side.  Please import that NT8 Copier Strategy to your NT8.

At NT8 'Control Center', select 'Tools' -> 'Import' -> 'NinjaScript Add-On'.  

Then select 'TVToNT8Copier.zip'.  During this zip import, NT8 will pop up like below.  This strategy copier needs to use your computer internal data interchange to synchronize data with that bridge app.  Please click 'OK' to proceed.

If you want to copy TradingView alert signal, say, to ES 06-23, open a ES 06-23 chart and then attach this copier strategy to chart.  This copier strategy can accommodate multiple symbol copies at one chart that will be elaborated later.

and enable at 'Control Center' -> 'Strategy' window (i.e. click that 'Enabled' checkbox).  If this is not enabled, this copier bot won't get started.

Please be aware - if you close any trades made by this copier bot (or closed by ATM), NT8 will auto disable it.  This is the expected behavior of any NT8 strategy operation.  

If you want to use NT8 copier with ATM, there is another copier version, i.e. TVClick, at this package folder as well as another pdf manual.  

If your TradingView chart is S&P500 futures (e.g. ES1!), at NT8 side open an ES contract (e.g. ES 06-23) chart.  When you add this copier, input below string at its 'Symbol Mapping List' variable.

ES1!,ES 06-23;

Note: variable format 

TradingView symbol name

comma

NT8 full symbol name including maturity month

semi-colon

All variable explanations will follow at this blog article later - including multiple symbol copy scenario.

*****

Below are the variable explanations at NT8 copier side:

1. Symbol Mapping List - this is to map the different symbol name between TradingView & NT8.

for instance

ES1!,ES 06-23;

or more pairs

ES1!,ES 06-23;NQ1!,NQ 06-23; 

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

NT8 symbol name should carry maturity month as it is shown on NT8 chart.

* If you have two more mapping pairs, please also set 'Applicable Symbol List' as explained later.

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

3. 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.

4. Below are for TradingView 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 *All* LONG or SHORT trades - EA close trades for those keywords.

If you want to close all trades, set keywords list to 'Keywords to close both *All* 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%'

Keywords to close *Single* LONG or SHORT trade - EA close single trade for those keywords.

Close Single Trade Lot Size - default is 1.  You could set any lot size for single close trade.

Keyword Match Precisely? - default is false.  If enabled, it will compare keywords precisely.

Take Profit in Tick & Stop Loss in Tick

You could set 'take profit' & 'stop loss' distance (in tick) locally.  

TP/SL prices are calculated per the following formula:

(a) LONG trade: 

current ask price + TP * symbol tick value = TP Price

current ask price - SL * symbol tick value = SL Price

(b) SHORT trade:

current bid price - TP * symbol tick value = TP Price

current bid price + SL * symbol tick value = SL Price

There are three sessions for trade entry or exit restriction.  Session time uses your computer/vps time.

1. Sessions Applied To Trade Entry - default is false; if enabled, only session time will have trade entry.

2. Sessions Applied To Trade Exit - default is false; if enabled, only session time will have trade exit.

3. 3 session slot for input - if any session slot is not required, just leave it blank.

session input format, e.g. 0200-1530  

the time range will start from 02:00 to 15:29:59.  15:30:00 is not inclusive.

5. 'Applicable Symbol List' (You could skip this part if you just have one symbol copy between TradingView and NT8)

If it is left blank, this Tradingview copier will only take the symbol signals from TradingView to NT8 chart symbol that this copier bot is attached.  For instance, if the chart symbol is ES 12-24, it will only takes the mapped ES 12-24 signals from TradingView.

If you want this copier to take more symbol signals than chart symbol, please fill in NT8 symbol name list per below format separated by comma.

ES 06-23,YM 06-23,MGC 06-23

* 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.

If your TradingView alert message is something like

Buy Lot 2 at 1.34563

'TradingView lot info head string' - input Lot

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

You can also use Lot string method at TradingView strategy.exit method to close given lot at NT8 side.

3. TraidingView lot info to NT8 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.

> Inclusive & exclusive keywords

inclusive keywords

it can be multiple strings

e.g.

MIRACLE,MAGIC,

so that copier will only act on the alert messages with these 2 keywords (i.e. MIRACLE and MAGIC)

each keyword is separated by comma

or you could have only one keyword that is no need to put comma

exclusive keywords

if you input MIRACLE,MAGIC, as exclusive keywords

that copier WON'T act on the alert messages with these 2 keywords (i.e. MIRACLE and MAGIC)

* inclusive & exclusive keywords are case sensitive.