TRADINGVIEW ALERTS TO NINJATRADER TRADER COPIER

 

User Guide: TradingView Alerts to NinjaTrader Copier

The TradingView Alerts to NinjaTrader copier consists of three parts:

- Google Chrome installed on your computer

- TVBridge, a Windows app that receives TradingView alerts through Chrome

- TVToNT8Copier, an NT8 strategy that receives signals from TVBridge and places copied trades

Operating system: Windows 10 or 11, or Windows Server 2016 or later. 

The delivery package includes two ZIP files.

1. Extract TVBridge.zip. It requires 64-bit Windows 10 or 11, or Windows Server 2016 or later.

2. Enter your license key in config.ini in the extracted folder.

For example:

license_key=wallstreetbulls@gmail.com

Save the file.

You can also set the Chrome window height, width, and sound options in config.ini.

Install Chrome on your computer or VPS before starting the bridge app.

3. Run TVBridge.exe. Wait for "Ready to start", then click "Start".

The bridge log displays a reminder:

a special Chrome session has started. Log in to TradingView in that window. Click "Start" again to close it, and close the Chrome session before exiting the bridge app.

The app opens a special Chrome session with the TradingView home page.

Log in to TradingView in that Chrome window.

If you use Gmail to log in to TradingView, select "Email" rather than "Google" on the login page.

You can enable TradingView two-factor authentication (2FA) for additional login protection.

Keep at least one TradingView chart open while receiving alerts.

Create an alert for your indicator or strategy by selecting "Add alert on xxxxx" in its menu.

This copier reads TradingView alert popups. Select "Show toast notification" in the alert settings.

4. In NinjaTrader 8, import the Copier strategy.

In the NinjaTrader 8 Control Center, select Tools > Import > NinjaScript Add-On.

Select TVToNT8Copier.zip. When the access prompt appears during import, click "OK". The copier uses internal data exchange on your computer to synchronize with the bridge app.

To copy alerts to ES 06-23, for example, open an ES 06-23 chart and attach the Copier strategy. One strategy instance can handle multiple symbols, as explained below.

In Control Center > Strategies, select the Enabled checkbox. The copier will not start until you enable it.

NT8 automatically disables the strategy if you manually close one of its trades or an ATM strategy closes it. This is standard NinjaTrader strategy behavior.

To use ATM strategies, use the alternative TVClick version included in the package. Its separate PDF manual explains the setup.

For a TradingView S&P 500 futures symbol such as ES1!, open the corresponding NT8 contract chart, such as ES 06-23. Enter the following in "Symbol Mapping List":

ES1!,ES 06-23;

Mapping format:

TradingView symbol name

comma

The full NT8 symbol name, including the contract month

semi-colon

The settings below include instructions for copying multiple symbols.

*****

NinjaTrader Copier Settings

1. Symbol Mapping List - Map TradingView symbol names to NT8 symbol names.

For example:

ES1!,ES 06-23;

For multiple mappings:

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

Separate the TradingView and NT8 symbols with a comma, and end each mapping with a semicolon.

Include the contract month exactly as shown on the NT8 chart.

For two or more mappings, also configure "Applicable Symbol List" below.

2. 'Long Trade Switch' & 'Short Trade Switch' - Enable or disable long and short trades separately.

3. Lot Mode - Choose "fixed lot" (the default) or "Follow Lot Info from TradingView". Set the quantity in "Fixed Lot", or follow the lot parsing instructions below.

4. TradingView Alert Parsing Settings

Keywords for LONG or SHORT trade - The copier includes common keywords for identifying LONG and SHORT signals. Add your own keywords separated by commas.

Excluded keywords from opening trade - Do not open a trade if the alert contains any of these keywords.

Enable close trade keywords - Enable keyword matching to close trades.

Keywords to close *All* LONG or SHORT trades - Close all applicable trades when an alert contains these keywords.

To close all trades, enter the relevant keywords in "Keywords to close both *All* LONG & SHORT trades".

If a close alert contains a percentage, the copier partially closes the matching trades by that percentage. For example, "close long 50%" closes half of the applicable long positions.

Keywords to close *Single* LONG or SHORT trade - Close one trade when an alert contains these keywords.

Close Single Trade Lot Size - The default is 1. Set the quantity to close for a single-trade close signal.

Keyword Match Precisely? - Disabled by default (false). Enable it to require an exact keyword match.

Take Profit in Tick & Stop Loss in Tick

Set local TP and SL distances in ticks.

TP/SL prices are calculated as follows:

(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

You can configure up to three sessions to restrict trade entries or exits. Session times use your computer or VPS clock.

1. Sessions Applied To Trade Entry - Disabled by default. When enabled, entries are allowed only during the configured sessions.

2. Sessions Applied To Trade Exit - Disabled by default. When enabled, exits are allowed only during the configured sessions.

3. Configure up to three session slots. Leave unused slots blank.

Use this format, for example: 0200-1530.

This covers 02:00:00 through 15:29:59. The ending time, 15:30:00, is excluded.

5. Applicable Symbol List - Skip this section if you are copying only one symbol.

If this field is blank, the copier accepts only signals mapped to its NT8 chart symbol. For example, on an ES 12-24 chart, it accepts only TradingView signals mapped to ES 12-24.

To accept signals for additional instruments, enter their full NT8 symbol names separated by commas:

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

Using Lot Information from TradingView Alerts

1. Select "Lot info from TradingView" in "Lots mode".

2. Set the head and tail strings used to identify lot information in the alert.

"TradingView Lot Info Head String" - The default is "Lot:".

For example:

Buy Lot:2

The copier will open a trade of 2 lots.

If the alert instead looks like this:

Buy Lot 2 at 1.34563

Set "TradingView lot info head string" to Lot.

The head and tail strings identify the text immediately before and after the lot number.

You can also include lot information in a TradingView strategy.exit alert to close a specified quantity in NT8.

3. TradingView lot info to NT8 ratio

The default is 1.0. With a ratio of 0.1, a TradingView lot value of 2 becomes 0.2 lots in the copied trade.

> Inclusive and Exclusive Keywords

Inclusive keywords

Enter one or more keywords.

e.g.

MIRACLE,MAGIC,

The copier will act only on alerts containing either of these keywords: MIRACLE or MAGIC.

Separate keywords with commas.

A single keyword does not need a comma.

Exclusive keywords

If you enter MIRACLE,MAGIC, as exclusive keywords,

the copier ignores alerts containing MIRACLE or MAGIC.

Inclusive and exclusive keywords are case-sensitive.