Robot Installation & Configuration Guide · 2020. 8. 17. · Robot Installation & Configuration...

2

Robot Installation & Configuration Guide

Contents

INTRODUCTION .................................................................................................................................3

REQUIMENTS & RECCOMENDATIONS ..............................................................................................3-4

INSTALLATION PROCESS ..................................................................................................................5-9

CHART SETTINGS ........................................................................................................................... 9-10

TYPE OF WORK ................................................................................................................................ 11

ROBOT CONFIGURATION ............................................................................................................. 11-14

FULLY AUTOMATIC VERSION ....................................................................................................... 14-20

DETAILED DESCRIPTION OF THE FUNCTIONS ................................................................................ 20-29

EXTERNAL PANEL ............................................................................................................................. 30

BACKTESTS ...................................................................................................................................... 30

UPDATES ......................................................................................................................................... 30

3


INTRODUCTION Welcome! We are pleased that you were interested in the subject of automatic forex solutions.

Our task will be to confirm that it was an excellent choice and to meet your expectations. Read

this guide carefully, because it contains a lot of useful information about the operation of the

robot and its installation. Before you start using Forex Ninja Levels™ on your account(s), make

sure you have everything you need ready for the robot to work properly. Let's get started.

What’s Next?

1. LOW SPREAD BROKER ACCOUNT

The robot works on short ranges so we want the broker you use to have the lowest spread. A

high spread can also cause large discrepancies in the results we present and those you achieve.

Personally, we have been using the IC Markets broker for many years. It is a trusted Australian

broker with the largest number of servers on MetaTrader among all brokers. We fully

recommend it due to low fees and transparency. The robot was tested from the beginning and

used on it. There are 2 accounts to choose from. Raw Spread and Standard. The standard has

lower commissions but a higher spread. A better solution is the account type: Raw Spread

Commissions for opening transactions are higher but the spread is the best on the market.

You can take advantage of the preferential conditions at the IC Markets broker by clicking this

link: LINK FOR REGISTRATION WITH ICM BROKER

You can compare broker spreads on: https://www.myfxbook.com/forex-broker-spreads

https://www.icmarkets.com/?camp=39493

https://www.myfxbook.com/forex-broker-spreads

4


2. VPS WITH META TRADER 4

Forex Ninja Levels™ robot needs a continuous connection to the internet and Meta Trader 4

platform to work properly. If you are able to have a 24/7 computer with internet access - VPS will

not be needed. If you do not have VPS and Meta Trader 4 installed on it, read the instructions

on: https://forex.ninja/enVPSguide.pdf

The website you use is not so important. It is only important that VPS is stable, cheap and with

the Windows operating system.

3. LICENSES WITH THE APPROPIRATE „CAPITAL LIMIT”

When purchasing a license at https://forex.ninja, be sure to set a correspondingly high "Capital

Limit". To estimate the possible profits you can use the "Profit Calculator" from the site and add

about 10-15% to the result just in case.

For example, for a starting capital of $ 2,500 and buying a license for 3 months, a good choice of

"Capital Limit" would be a value around $ 3,600. If we chose the month, it's about $ 2,900.

4. PREPARED INSTALLATION FILES

If you already have VPS running with Meta Trader 4, download from the Forex Ninja website or

transfer the installation files from your computer to it. It is important that they are located there.

Extract them on your VPS. If the files are ready, we can proceed to the installation.

https://forex.ninja/enVPSguide.pdf

https://forex.ninja/

5


The installation process is simple if we follow the guidelines. To be able to properly install the

robot and add it to Meta Trader 4, open the platform, log in to the broker account and then in

the upper left corner press "File” and then "Open Data Folder"

The first file we add will be "Forex Ninja Template.tpl" add it to folder "templates”

You should have 2 versions with 2 types of resolution. Add both there.

6


After adding the file, go to the MQL4 folder, where you will find more subfolders

The "Forex Ninja Levels.ex4" file should be added to the "Experts" folder

The "MMD Ninja Clouds.ex4" file should be added to the "Indicators" folder

7


The "ForexNinjaHelper.ex4" file should be added to the "Libraries" folder

Files from the "Sample Sets" folder should be added to the "Presets" folder.

You should have 2 versions with 2 types of resolution. Add both there.

8


After adding the files to the indicated places, restart the Meta Trader 4 platform. The next step

on the platform will be to open the "Tools" tab and go to the "Options" sub-tab.

And then go to the "Expert Advisors" tab

9


Then select the options there according to the screen above. We should mark:

a) Allow automated trading

b) Allow DLL imports

c) Allow WebRequest for listed URL:

1) http://ec.forexprostools.com/?columns=exc_currency,exc_importance&importance=1,2,3&calType=week&timeZone=15&lang=1

A link that will allow the robot to automatically download information on

economic events.

2) https://licensing.forex.ninja

A link through which the licensing system will connect to your account and it will be possible to start the robot.

Add them and then press "OK" at the bottom to save the information.

The robot installation process is completed, it remains to add it to the chart and configure it.

CHART SETTINGS

You can use your own chart settings if you're used to some chart appearance. However, if you

would like to use the ones we have prepared for you in the package. Open a new chart window,

right click on it and then select "Forex Ninja Template" in the "Templates" tab. Try to add

"Basic Resolution" first if the buttons are of good size, leave it on the chart. If the subtitles get

mixed up - use the "High resolution" version

http://ec.forexprostools.com/?columns=exc_currency,exc_importance&importance=1,2,3&calType=week&timeZone=15&lang=1

http://ec.forexprostools.com/?columns=exc_currency,exc_importance&importance=1,2,3&calType=week&timeZone=15&lang=1

https://licensing.forex.ninja/

10


The chart should look like this:

The interval separators should be visible (every 1 day) and the MMD Ninja Cloud™ indicator

turned on at the top. If the indicator does not display correctly (e.g. it protrudes outside the graph

or is in a completely different place than on the screen), enter the indicator's settings and change

its position or size. In this paragraph we will not describe the functionality and use of the

indicator. This will be described later in describing the functionality of the Forex Ninja Levels™

11


The recommended way to use the Forex Ninja Levels™ is the automatic version

Fully automatic - This means that once the robot is set up, you look after it very rarely and

you do not interfere with its work by opening additional positions, etc. The robot will have to

be looked after once a week - on Mondays. But you will learn about the details in the following

chapter.

We will now show you how to add a robot to a chart and then discuss the basic functionalities.

From the "Navigator" tab on the left side of the platform go to "Expert Advisors" and then select

"Forex Ninja Levels" and move it to the chart.

12


Then select the options in the "Common" tab as on the screan below

After selecting simply, go to the "Inputs" tab - there are the most important settings. First of all,

our task will be to check the correctness of the license code we received.

For this purpose, in the "Imputs" tab, the first parameter that we will complete is:

The serial code assigned to your license can be found after logging into your account

https://forex.ninja in the „Subscriptions” tab


13


Copy the license code and paste it into the box next to "SerialKey". Then to check if the code is

correct press "OK" to confirm the settings. If everything is OK at the top of the chart you should

see the "Ninja Levels" button

If the code is incorrect or the data do not match, an alert will pop up.

This may mean several options, I will give the most common:

a) You have copied the incomplete code or added unnecessary spaces before/after the code

b) Each license is assigned to one Meta Trader 4 account number at the broker. Check if you are logged in to the correct account

c) It's possible that you made a mistake when entering your account number when you bought it. You can update your license in the panel at https://forex.ninja at any time in the "Subscriptions" tab after clicking "Edit License"

If none of these options work and you still get an Alert pop up add Ticket in the customer panel

at https://forex.ninja in the "Support" tab on the right or via email at [email protected]



mailto:[email protected]

14


ROBOT SETTINGS

The next sections will be devoted to describing the parameters. You don't need to know them all

for the robot to work properly, because we have provided you with ready-made settings that you

can use - the same as we use. We have presented these parameters for people who want to fully

understand the operation of the robot. Read the "Fully automati vestion" sections for the basics.

Remember that the presented settings can be freely changed by you and it depends on you which

you use. Our tests simply show that the specific ones work well, it does not mean that there are

no better ones. Let's continue.

When we confirmed that our robot starts

correctly let's go to the settings again.

Right click on the chart and then in the "Expert

Advisors" tab go to "Properties"

Then click the „Load” button to add settings

15


We choose "Sample Sets" and then choose the currency pair whose chart we have open (we will

tell you more about the currency pairs in a moment). Then choose the file from "FullyAutomatic"

in the name and double click on it to add.

You may need to enter the license code again. But if we know that it works properly just paste it

again in the box intended for this.

The first parameter that we will pay attention to is "Begin_hour"

It applies to the time zone your broker uses on the Meta Trader 4 platform. If you use the IC

Markets broker, leave this value at "0". If you are using another broker, first check if the time

coincides with this here: https://time.is/GMT+3

If the time on the watch from the link:

coincides with the one on your chart:

Everything is ok - leave this parameter to "0"

If your broker time is 2 hours late and instead of e.g. 22:00 you have 20:00 enter "-2". If your time

is ahead of this IC Markets, enter the appropriate number of hours more.

https://time.is/GMT+3

16


The next parameter is "Magic_number" - a unique random Magic Number enables Forex Ninja

Levels™ to distinguish its open trade positions from those that were entered by other robots,

or done manually. Any number is acceptable as long is not the same number used by any other

robot running on this MetaTrader Platform. Each setting has its own Magic_number number

already entered, but you should know it.

The parameter that we need to pay attention to is in the "News filter settings" section the

"Time_offset" parameter is very similar to "Begin_hour" except that the start value is "3".

If our time is the same as on IC Markets, we leave "3". If our time is 2 hours late, enter the

number 2 smaller, which is 1. If our time is 2 hours ahead, instead of 3, enter 5.

17


The last - very important parameter to set correctly in the automatic version is

"Refresh_timeframe" and "MaxSpread"

The "MaxSpread" parameter specifies the maximum allowed currency pair spread. If it is

exceeded, the pending order is deleted and the spread is checked again after

"Refresh_timeframe". If the spread is reduced to the correct one - the order will be issued again.

Each time the order is deleted because of this you will receive the alert "Too big spread, delete

SET UP". It should be normal and occur several times a day.

This protects us from opening a position when the market is overactive and too volatile. In the

"Sample Set" settings, the appropriate "MaxSpread" parameter is set for each pair - matched to

the Raw Spread account in IC Markets. If you use a different broker or demo account, be sure to

change the "MaxSpread" values for each currency pair and adjust them to the spread with your

broker.

"MaxSpread" should be about 50-75% higher than the standard spread of a given currency pair.

If you don't know how to do it, enter "2.5" because this is the maximum that works in strategy.

18


It's all from the settings of the automatic version of the selected currency pair. If you want to

know the other settings, read them in the „Detailed description of the functions” section.

Thanks to a better understanding of functionality, you will be able to edit the automatic version

yourself.

BASICS OF OPERATION

We are one step away from starting the robot. It is important that you also know the very

basics of its operation and what activities it performs.

Forex Ninja Levels™ robot generates one Kaishi level and three Tsuika levels every day at 1:00

(GMT+3)

Kaishi - The initial level at which robot open the first position, it is always closer to the current

price when they are generated than the Tsuika levels. The Kaishi level is marked in gold:

Tsuika - 3 additional levels where robot open additional positions if the Kaishi initial position

was not closed with a profit. Tsuika levels are marked blue:

> The robot uses pending orders of the BUY LIMIT or SELL LIMIT types to place order.

> The active levels are until midnight of the day they were given, unless the initial position was

opened and it was not closed the same day - then we trade the Tsuika levels from the same

setup where the Kaishi level was given. If the initial position (Kaishi) is not opened until 1:00

next day (GMT+3) = the levels on this day will expire. There are days that there are no levels for

a given pair or only one. After starting the robot, if it is possible, the robot will immediately add

pending orders.

19


STARTING THE ROBOT

After entering, making sure that the time zones in the robot are all right, press "OK". Again, the

"Ninja Levels" button should appear at the top - press it. You should see this panel:

Let's check now if the levels are loading correctly. Press "Show levels" and then "Kaishi" and

"Tsuika". The buttons should light up red and the chart should look like this:

Now when levels are added, start automatic trading and adding positions by the robot. To do

this, first press "Enable Trading" in the top panel to make the icon look like this:

As confirmation of turning on the robot in the upper right corner of the graph, the face icon

should be smiling:

20


Now we can proceed to turning the robot into standby mode on Ninja Levels to add trades.

To do this, press the "Start" button and then select "Buy Setup" and "Sell Setup".

It should look like this:

Congratulations, your first robot started ! What about other currency pairs ?

Due to the conservative settings and back tests, it appears that a single currency pair per month

generates about 0.2-0.5% profit depending on the month. To this end, to maximize profits we

personally use it on many currency pairs at the same time, such as:

AUD/CAD AUD/CHF AUD/JPY AUD/NZD CAD/CHF CAD/JPY CHF/JPY EUR/AUD

EUR/SGD EUR/CAD EUR/CHF EUR/JPY EUR/NZD EUR/USD GBP/AUD GBP/CAD

GBP/CHF GBP/JPY GBP/USD USD/CAD USD/JPY USD/SGD NZD/CHF NZD/JPY

For example, you can start it on 12-15 currency pairs at the beginning to see how it works and

then increase the quantity even to +20. To add new pairs, proceed in the same way as when

adding a new robot. Start by adding a chart and template and then load the appropriate sample

settings or configure the robot yourself.

During the robot's work or immediately when adding it to the chart, some notifications may

occur.

So-called :

An example alert is "The order cannot be added over the weekend" means that when the

market is closed the robot cannot place an order. But when the market opens, the robot will try

to add the order again.

Alerts are used to inform you about activities performed by the robot.

21


Detailed description of the functions

The "Order_offset" parameter is the number of pips by which the BUY/SELL Limit position is

moved relative to the Kaishi Level. 0.2pips is 2 points. For example, if we trade BUY Setup and

the Kaishi level is at the price of "1.29500" then the BUY Limit position will be issued at the level

of "1.29502”. We do not recommend using a value greater than 1.5 pips.

The "Broker 5 Digits" parameter applies to the format of quoting currency pairs and indices. For

currency pairs, use the "On" parameter if you want to test the robot, e.g. on indexes, select the

"Off" parameter and everywhere you enter values in pips, change them into points.

The "Lot_Type" parameter specifies which type of flight for the initial position - opened at

Kaishi level we want to use. Choosing "Fixed" the value that will apply to us will be the one in

"Fixed_lot_size". If you decide on this solution, remember to be careful not to take too much

risk on your account.

22


Personally, we use the "Auto" version in the "Lot_Type" parameter. It automatically adjusts the

size of the position to each Setup and the risks we want to take.

We will describe it in more detail.

Auto_deviation: This is the distance from the

Tsuika 3 in pips

Auto_Percent: parameter determining how

much % of capital we will lose in this whole

Setup if the price reaches the value from

Auto_deviation.

On the screen, this price is: "Distance in pips -

risk level" shown on the right. These parameters

apply only to the calculation of the size of the

initial position. This does not mean that

positions will be closed at this level, only that

their total loss will be "Auto_percent".

Personally, "Auto_Percent" we do not use more

than 25.

23


The "TakeProfit" parameter determines the profit in pips that a position must achieve. It is

calculated from the initial position issued at the Kaishi level.

If it comes to the situation that the price does not react to the Kaishi level and the additional

position opens on Tsuika 1. The robot will open the position so that the average profit would be

equal to the value in $ that the position would have obtained by taking "TakeProfit" from the

first position.

The "BreakEven" parameter enables or disables this option. If the price reaches

"BreakEven_trigger" specified in pips, it will move our StopLoss to the value "BreakEven_lock".

It is important that if we use the parameter so that the value "BreakEven_trigger" is lower than

TakeProfit and higher than BreakEven_lock.

Recommended use for TakeProfit larger than 10 pips.

The "Type_SL" parameter determines from which level StopLoss is calculated. The

"StopLoss_pips" parameter determines how many pips from the level a stop loss will be issued

for the initial + additional position. Choosing "Off" will not have Stop Loss. Personally, we do

not use Stop Loss, we only close positions manually when we see that we are on the wrong side

of a trend or capital drawdown that we have previously set as a limit - we then close positions

manually. It is rare but it happens.

24


The "Only_one_setup" parameter determines whether a given robot after completing or

canceling one setup is to trade the other (on the opposite side) or delete an order. For example,

if a robot opened a BUY position for us and closed it with a profit, if "Only_one_setup" is

selected, the opposite SELL Limit order will be deleted as soon as BUY is opened. However, if

we select "Off", the robot will leave this position pending. The removal of the opposite position

occurs even if one of the opposite positions is removed by one of the filters described below.

When there is a situation on the market that the robot has not issued a position due to this

setting, we are informed about this via

„Buy/Sell setup was reached today, change Only_one_setup for place Buy/Sell"

Very important parameter to set correctly in the automatic version is "Refresh_timeframe" and

"MaxSpread"

The "MaxSpread" parameter specifies the maximum allowed currency pair spread. If it is

exceeded, the pending order is deleted and the spread is checked again after

"Refresh_timeframe". If the spread is reduced to the correct one - the order will be issued again.

Each time the order is deleted because of this you will receive the alert "Too big spread, delete

SET UP". It should be normal and occur several times a day.

25


This protects us from opening a position when the market is overactive and too volatile. In the

"Sample Set" settings, the appropriate "MaxSpread" parameter is set for each pair - matched to

the Raw Spread account in IC Markets. If you use a different broker or demo account, be sure to

change the "MaxSpread" values for each currency pair and adjust them to the spread with your

broker.

"MaxSpread" should be about 50-75% higher than the standard spread of a given currency pair.

If you don't know how to do it, enter "2.5" because this is the maximum that works in strategy.

If the "Correlation_filter" parameter is enabled, the

robot will automatically remove all pending orders with

very correlated pairs after opening a position on a given

currency pair. You can check the correlation level at:

https://www.myfxbook.com/forex-market/correlation

As you can see on the screen above, EURUSD is strongly correlated with EURCHF and NZDUSD.

This means that usually when the EURUSD price increases it happens the same on these pairs.

Thanks to the filter, we will avoid opening an additional steam position that behaves very much

like the one we already have open. When the position of the pair we have opened will be closed

again, the robot will check again whether it is possible to list the position on the remaining

correlated pairs.

https://www.myfxbook.com/forex-market/correlation

26


The "MMDNinjaCloud_filter" parameter defines whether we want to use MMD Ninja Cloud™

filters or not. This filter increases the quality of trades due to the fact that we only play positions

where the MMD Ninja Cloud™ overlaps or is close to the Kaishi or Tsuika level.

MMD Ninja Cloud™ are support and resistance zones to which the price will probably react.

There are 3 cloud colors:

Orange - Made of moving averages 48

Blue - Made of moving averages 288

Green - Made of moving averages 1440

The lower the Moving Average value, the more volatile the cloud has. The fastest is orange and

the slowest changing is green. A good way to recognize the current trend is to look at the current

cloud setup. If you are looking for a long-term trend, it's worth looking at the clouds from the

H1, H4 or D1 chart. If the blue cloud is under the green and in addition the price is also under the

blue cloud - we can talk about a downward trend. However, if the blue cloud is above the green

and in addition the price is also above the blue cloud - we can talk about a upward trend. The

situation is similar in the short-term trends but then it is worth looking at the lower intervals -

M5/M15.

The pointer itself can be used in the template you have loaded. Clouds and intervals should be

displayed on the top bar. Press the selected clouds you want to activate and select from which

interval they are to be shown.

Let's return to the filter's operation. "NinjaLevelsCluster" is the parameter that determines which

levels of Ninja Levels the clouds should overlap with. You can choose either the Kaishi or Kaishi

level combined with the Tsuikami. This means that for a Buy / Sell limit pending position to be

posted, the level must coincide or be close to the cloud. Just like on the screan:

27


The "Upper / Lower_band_min_distance" parameters determine the minimum distance from the

clouds. The robot takes into account all clouds from the M5 / M15 / M30 / H1 / H4 / D1 intervals.

Just one nearby to meet the condition.

The RefreshTimeframe parameter mentioned during the Spread also applies to the MMD filter.

This is the time interval every robot checks if the cloud is still nearby. If the cloud goes away from

too far you will be notified by an alert: "The MMD Ninja Cloud no longer overlaps with the level"

The next parameter filtering the initial entries is "Delete_when_price_was_too_close"

In the selection of the parameter Off / "1" / "1&2" / "1&2& 3 "we specify which of the following

settings should be taken into account. If we select" 1 "then only" DistanceArm1 "and"

DistanceTrial1 "will be active.

This filter is so that if the price approaches the level very close but our position will not be opened

(e.g. 1 pip will run out) and then we will go in the direction we assumed. Then the pending order

will be deleted.

"DistanceArm" determines how many pips from the Kaishi level the price observation is

activated. Then, if the price after activation moves to a level distant from Kaishi specyfied by

"DistanceTrial" it means that the condition is met and the pending position is removed.

28


If the filter is active and the situation occurs we are informed about it by the alert:

"Buy/Sell setup deleted - the price was too close"

The default settings of this parameter work well but if you want you can try to search for your

own

The last of the filters that we can use relative to the initial position is "News_Filter"

Its operation is simple. Within a certain time before important news takes off pending orders and

after they are added again. The only possibility that he will not add levels again is that during the

news one of the initiating levels has been touched.

In the parameters "Light / Medium / Hard_news" we specify what news we want to filter.

In the "Before/AfterNewsStop" parameters specify how many minutes before and after news the

order should be inactive. After the "AfterNewsStop" time, the robot will try to place the order

again.

29


Enter after the decimal point for which countries and news are to be observed.

USD EUR CHF JPY AUD NZD SGD

USA Europe Switzerland Japan Australia New Zeland Singapore

In the "DrawLines" parameter we specify whether the robot should draw vertical lines on the

chart with markings at the time when News occurs. However, "DrawOnlyFutureLines" specifies

that only those news are drawn in the future.

30


The parameter that we need to pay attention to is in the "News filter settings" section the

"Time_offset" parameter is very similar to "Begin_hour" except that the start value is "3".

If our time is the same as on IC Markets, we leave "3". If our time is 2 hours late, enter the

number 2 smaller, which is 1. If our time is 2 hours ahead, instead of 3, enter 5.

When the order is temporarily deleted due to News, we will receive the alert :

„News time, the robot will try place order after news finish "

EXTERNAL PANEL

In the upper right corner, the robot informs us about which

setups for a given currency pair are still possible to set based on

the configuration.

The basic panel allows us to enable or disable setup in a given direction at any time. If we try to

set the setup in a direction that is not available at the moment, we will receive an Alert and the

position on the given pair, if the robot is turned on, will be issued the new day when levels appear.

31


BACKTESTS

The robot enables back tests and we recommend searching for interesting settings and sharing

them with the group. It is important to set "Refresh_timeframe" greater than 1 minute and less

than 1 day with the backtest. The MMD cloud filter does not work in the backtest.

WHAT TO REMEMBER ?

• If you have chosen the automatic version to check the robot's work once every few days. Check every Monday if after pressing Show Levels -> Kaishi + Tsuika the levels are visible on the chart. If not. Reposition the robot on the graph, load the settings and run.

• Remember to increase your Capital Limit at https://forex.ninja when the robot generates a profit and will be approaching the limit you set. You can raise it at any time.

• Remember that drawdowns are part of trading and do not worry about them if they are not high

• Remember not to set too much risk for individual setups

When an update occurs, you will be notified by email.

If you have any questions, please contact: [email protected] or via Ticket in the user panel

______________________________________________________________________________

Risk warning: Trading in financial markets, involving leveraged financial instruments, provides a

wide range of opportunities and enables investors ready to take risks to make high profits, but it

carries a potentially high level of risk of loss. Therefore, prior to trading you should address the

issue of choosing an appropriate investment strategy, taking into consideration available

resources. Use of the information: Full or partial use of materials from this website must always

be referenced to Forex Ninja as the source of information. Use of the materials on the Internet

must be accompanied by a https://forex.ninja/. Automatic import of materials and information

from this website is prohibited.

2020 Forex Ninja™ | Software Development Eryk Skórzyński | Robot Installation Guide v1.4


mailto:[email protected]

Date post:	02-Apr-2021
Category:	Documents
Upload:	others
View:	3 times
Download:	0 times

Robot Installation & Configuration Guide · 2020. 8. 17. · Robot Installation & Configuration...

Documents