Magic Keys

Installation and Usage manual

INSTALLATION MANUAL 1
Installation and Usage manual 1

Software installation 3
Mac installation - USB binding 4
Virtual Box 4

Parallels Desktop 5

Metatrader 8
Linking 8

Setup 9

Troubleshooting 10

cTrader 12
Installation 12

Setup 12

Parameters 16

INSTALLATION MANUAL 2
Software installation

1. Download contents from http://bit.ly/getmagickeys

• The password to access the page si awesome
2. Open the zipped folder and double-click on MagicKeys-Setup to start
the installation
3. Proceed through the guided installation process until the Installation
successful window is shown
4. Launch the newly installed Magic Keys app from your Desktop or the
Windows Start Menu

Note: if your antivirus is blocking the launch of the of the app, you will need
to add it to the white list of app. Low level routines are used to read signals
from the M.Keypad.

5. Check the status of the app

• NO DEVICE means the app is unable to recognise the Magic
Keypad
• CONNECTED means the Magic Keypad is correctly identified

Attention: if you are on a Mac, refer to the relative section of this manual
Note: insert the USB receiver you will find on the back of the M.Keypad
Note: remember to turn on the switch on the back of the M.Keypad

6. Now it’s time to configure your platform

INSTALLATION MANUAL 3
Mac installation - USB binding

1. Perform the same steps as described in the first part of the manual
Software installation
• On the virtual machine, you won’t be able to get the CONNECTED
status unless the USB receiver is bound directly to the Windows
virtual machine
2. Proceed to the Virtual Box or Parallels subsection

Virtual Box

1. Ensure the USB receiver is connected to your computer

2. Open Virtual Box and, having your virtual machine shut down, open its
Settings window

3. Select the Ports tab, then the USB tab

INSTALLATION MANUAL 4
4. Press the Add button: a window showing all of your usb connected
devices will appear on the screen; select the M.Keypad usb driver and
add it to the device filters list

5. Start the Windows Virtual Machine; the device status on the Magic Keys
App should now be CONNECTED

Parallels Desktop

1. Ensure the USB receiver is connected to your computer

2. Open Parallels Desktop Control Center and, having your virtual machine
shut down, open its Settings window

INSTALLATION MANUAL 5
3. Select the Hardware tab, then the USB & Bluetooth tab, and ultimately
click on USB Connection Preferences

4. You now have to add a permanent assignment by pressing the +

button, selecting the USB driver and assigning it to you virtual machine

INSTALLATION MANUAL 6
5. At this point you are ready to start the virtual machine
6. Start the Windows Virtual Machine; the device status on the Magic Keys
App should now be CONNECTED

INSTALLATION MANUAL 7
Metatrader

Linking

1. Press the Link MT button on the Magic Keys app; a dialog box will
appear

2. Enter the MetaQuotes directory; Enter the Terminal directory;

3. Select the directory that identifies your Metatrader installation


NOTE: Terminal folder is usually at the following path <User>/AppData/Roaming/MetaQuotes/Terminal.
Part of this path will be automatically preselected.

INSTALLATION MANUAL 8
NOTE: You probably have only MetaTrader Terminal folder. You can find out terminal identifier folder by pressing
“Open data folder” in the File menu on MetaTrader (look at the folder path).

4. Selecting the correct folder will result in the following alert showing

Setup

1. Open Metatrader
2. Ensure MagicKeys appeared under Expert Advisors in the Navigator
Window

Note! Use CTRL+N to toggle the Navigator Window

3. Open a new chart if none is open

4. Double-click or drag the MagicKeys EA to the destination chart
5. Configure the EA
• Enable DLL imports
• Enable Auto Trading

INSTALLATION MANUAL 9
Note: If you want to have this checks always ticked, go to MetaTrade Options and modify the relative settings
(Tools -> Options…); Tick Allow automated trading and Allow DLL imports in the Expert Advisor tab


6. Configure the input parameters to adjust the EA to your preferences

7. Press OK to proceed
8. The EA has now started and it’s listening for signals from the M.Keypad
• If everything is correct, then Started should appear in the top left
corner of the chart and a smily face (MT4) or a green play button
(MT5) in the top right corner of the chart
• Enable Auto Trading on your account by pressing the following
button if no smily face/green play button

Note: To quickly change EA settings you can press F7 on your keyboard and the parameters dialog will pop op.

Note: For a quicker access we invite you to create your custom chart template with EA added and the
parameters set as you wish. Remember that the EA will keep its state between MT platform restarts; if you do
not close you charts before exiting MetaTrader you will get charts and configurations exactly how you left them.

Attention: Magic Keys EA uses only uses bid price. Make sure your charts are drew based on bid price.

Attention: Magic Keys EA is intended to be used with only one market direction per instrument (either bullish or
bearish). If multiple long and short trades are present on the same symbol, behaviour might be different for
some functionalities.

Troubleshooting

Remember! Always check the Experts logs tab from your terminal window
to identify what is wrong

• Cannot call “libzmq.dll” Probably some libraries are missing from your
Windows installation. To resolve the issue you should install the
Microsoft official software that includes missing libraries. You can find

INSTALLATION MANUAL 10
 the installation executable inside the Extra folder. Use the one relative
to your Metatrader version (vc_redist_MT4 or vc_redist_MT5)

• Error 4756 is an INVALID_FILL error That means you have to change

the Filling Mode from the EA parameters. Filling mode changes the way
your order is handled and it differs from broker to broker. What you
have to do is go to the parameters window (right-click on chart ->
experts -> Properties or just press F7) and change the filling mode to
ORDER_FILLING_IOC or ORDER_FILLING_FOK

• NUM key should be active You need to have num key active to use the
functionalities that have a direct impact on your orders. The Magic
Keypad has a blue LED indicator in the top right corner (under the lock
sign) which shows your Num status. It should be switched on to
perform actions on trades.
• Magic Keys app should be open in the background and the status
should be Connected. We advise you to use the Auto start at startup
feature


INSTALLATION MANUAL 11
cTrader

Installation

1. Inside the downloaded directory, under cTrader, there are two .algo files
• MagicKeys.algo
• MagicKeyBot.algo
Double click on both to add them to your cTrader platform

Setup

For Magic Keys to work on cTrader two distinct components are necessary:
• The bot which forwards the signals from the M.Keypad to the broker
(one only always running instance)
• The indicator which has to be added to each chart

1. Open cTrader
2. From the Automate section, select the cBots tab, and locate
MagicKeysBot

3. Press on + and select a random symbol


Note! Only one instance of the Magic Keys Bot should be active!

Note! Make sure to allow the requested permissions. These are needed
to read low level signals from the M.Keypad

INSTALLATION MANUAL 12
4. Press the play button to activate the bot

5. If the bot is not running orders will not be sent out to the broker. To
ensure the bot is always running even after the platform is restarted,
open Settings

6. Under Startup, select Single instance

7. Under Automate, check Auto Restart cBots in cTrader Startup




INSTALLATION MANUAL 13


Now that the cBot set up and running, you can proceed to adding the
indicator on the charts. This procedure has to be repeated on each
chart where you want to use Magic Keys.
Remember that triggers like partial TP and partial SL are carried over
on charts with the same symbol. Therefore, having the triggers visible
on multiple charts for the same trades will mean that they are
triggered multiple times when target price is reached.

8. Open a new chart or select a chart in the Trade section of the platform

9. Add the Magic Keys indicator to the chart

• When added, a label “ALL” should appear in the bottom right corner
of the chart
• Do not add the indicator multiple times on the same chart!

INSTALLATION MANUAL 14
10. The selected chart which will get signals from the M.Keypad is
indicated by the following sign:
• To select a chart, click once on it; it will stay selected until a new
chart is selected

11. Press Open Calc to ensure everything is working

• Stop loss and Take profit lines should appear on screen
• Move to the left the chart offset to correctly see the calculator labels

Note: Restarting the platform will also result in the indicators restarting automatically. If you do not close the
charts before closing cTrader, on restart everything will be ready to use immediately after the workspace is
loaded.

Note: Changing of parameters is possible by editing the indicator:


INSTALLATION MANUAL 15
Parameters

Note: some parameters might not be available on cTrader

Pips range for closed trades to be considered BE – In the STATS panel, trades
will be categorised into winning, losing and breakeven. With this parameter you
can customise which trades will be considered closed at breakeven based on the
P/L pips from entry price.

Eg. If set to 2, a trade that has been closed with a 2 pips loss or a 2 pips profit will
be considered a breakeven trade.

Exposure indication at risk % – By settings these two parameters you will get a
string on your screen while placing the trade saying that you are over leveraging
your account.

Use risk % of account to calculate lot size per order – Do you want dynamic lots
sizing based on a risked amount of money (percentage of account balance or
equity) or do you want do you want a fixed lot size for every trade?

% or risk per order – What amount of money (expressed in percentage) from
your account balance do you want to risk on the trade? Values go from 1 to 100.

Should equity or balance be used for the calculation –  The % amount risked on
the trade should be from account balance or equity?

Fixed lot size – If not using dynamic lot sizes, this lot size will be used for each
trade you open.

Min and max lots – These values are a limit to the minimum and maximum lots
allowed per trade when using account percentage based risk. If set properly they
prevent you from opening positions with a stop loss size tighter than usual or too
large.

Max price slippage – The maximum difference between the price you want your
position to be entered at and the entry price the broker is offering. 

Pips in profit when SL moved @entry – Defaults at 0 which means your stop
loss will be set exactly at the entry price. If higher then 0 then the stop loss level
will placed that amount of pips in profit when SL @entry is pressed.

Pips in profit when TARGET moved @default – Defines at which amount of pips
from entry the target should be moved to when the TARGET @default button is
pressed. Remember that the target changes based on the action you are taking.

% of position to close on CLOSE CUSTOM – What percentage of your trade

INSTALLATION MANUAL 16
position do you want to close when pressing CLOSE CUSTOM key. This is a value
between 0 and 100.

Eg. 75 for 75% of position lots

% of position to close on when Partial TP/SL is hit – When the partial TP/SL
trigger is activated, what % of the position do you want to be closed
automatically?

RR to move TARGET @1:x – Defines at which risk-reward the target should be
moved to when the TARGET @1:x button is pressed. Remember that the target
changes based on the action you are taking.

Partial TP/SL initial pips distance – If you have an average/default pips amount
of profit at which you take out part of your position, by setting this parameter to
that pips amount you will be able to quickly activate the Partial TP/SL trigger. You
can also drag the line to a specific price point.

Auto BE on partial TP – If set to true, when the partial TP price is reached, the
stop loss will be automatically moved to BE.

Auto BreakEven initial pips distance – If you have an average/default pips
amount of profit at which you move your stop loss to entry price, by setting this
parameter to that pips amount you will be able to quickly activate the Auto BE
trigger. You can also drag the line to a specific price point.

Alert on Partial TP/SL/AUTO BE hit – Do you want to be notified (on-screen alert
+ sound) when trigger price is reached?

Play sound when a Magic Keypad button is pressed – Auto explanatory 

Placement of dynamic labels and fixed position – These will be useful for
keeping the indicator labels in a place you are comfortable with

Line colors – Change them to customise your chart appearance

EA magic number – Trades opened with the Magic Keypad can be marked with a
magic number value

INSTALLATION MANUAL 17