PROJECTX COPIERS
This is the user guide for ProjectX Copier
Quick Notes:
1. This copier is applicable to various ProjectX derivative webtraders, e.g. TopstepX, Alpha Ticks, EliteX.
ProjectX is a futures platform which trade operation follows netting mode approach (i.e. LONG and SHORT trades *cannot* coexist). If your signal trading platform uses hedging mode (e.g. MetaTrader or cTrader hedging accounts), please ensure your trade logics follow netting mode requirements. This copier will strictly use netting logics to process copied trades to ProjectX.
2. This copier suite has two components -
(a) ProjectX Copier app
(b) the corresponding trade signal ea or indicator or bot at cTrader, MetaTrader, NinjaTrader, Quantower depending on what selection you purchase.
This copier suite was released to market before ProjectX API becomes available. Hence it does *not* use ProjectX API. It sends out trading requests to ProjectX server directly from your own machine.
3. ProjectX webtrader server only allows one user login session everywhere. When this ProjectX copier performs login and copy activities, your ProjectX webtrader login session will be forced to log out by ProjectX server.
As such this copier will timely update the position change info at its log window as supplement.
* Position changed. net lot: 0 -> 1: means position is changed from flat to one long order = 1 lot.
* Position changed. net lot: -1->-2: means position is changed from one short lot to two short lots
* Position changed. net lot: -1->0: means one short lot is closed and now position is flat.
It will also relay ProjectX server response messages that 'error: null' means *no error* and copy is well done with returned order id.
4. This copier only acts on position change event at signal terminals and do the market order for new order entry and exit. For limit/stop order at signal side, it will copy by market order entry when it's fulfilled. For tp/sl price fulfilled at signal side, it will copy by market order close.
5. Please ensure ProjectX agreement has been signed at first webtrader login before using this copier.
6. Currently ProjectX only allows trades placed to futures front month contract. If now ES front month contract is ESH25, any ES trade entered at webtrader will go to this contract. As such, this ProjectX copier follows this rule.
7. After an order entry or exit is placed, this copier will output:
If order fulfilled okay - output (a) broker server response and (b) net lot after position changed
If order fulfilled failure - only output (a) broker server response with failure reason
If broker server down - (a) & (b) won't be output
8. If you indeed need to do manual trade along with ProjectX copy or view real-time account and trade status, the alternative approach is to use our Quanotwer relevant copiers and run over Quantower. For details, please see the last section of 'Side Note of Quantower+ProjectX Integration'.
====
ProjectX copier install
1. Download ProjectXCopier.zip
2. Unzip that zip file
3. Modify config.ini file at unzipped folder
4.
license_key=
fill in that license key assigned at your license email.
e.g.
license_key=taigk2005+nttopx@gmail.com
5.
login=
fill in
your ProjectX broker login user name
your ProjectX broker login password
your ProjectX broker account name (that is shown at ProjectX webtrader left upper corner. if you have multiple accounts, input the applicable one)
your ProjectX broker platform login url
separate each by comma
e.g.
login=Js5021223,Newyork2025#,PRACTICE3241234,https://www.topstepx.com/login
or
login=Dejour205,London2025#,EXPRESS3423423,https://platform.alpha-futures.com/login
Note:
login 'user name' and 'password' are the input that you're using to log in your ProjectX webtrader:
If you have more accounts under *different* user names (or prop firms) to copy, duplicate this login= line and input another login credential.
e.g.
login=Js5021223,Newyork2025#,PRACTICE3241234,https://www.topstepx.com/login
login=Dejour205,London2025#,EXPRESS3423423,https://platform.alpha-futures.com/login
login=taigk97@gmail.com,c&ilbus,PRACTICE125124,https://bulenox.projectx.com/login
You cannot input multiple login credential under *same* prop firm user name as it will violate ProjectX single login session restriction.
For multiple accounts under *same* prop firm, please copy to one account at Project copier app and use ProjectX built-in group copier feature to relay to others.
How to use ProjectX built-in group copier at ProjectX webtrader:
https://help.topstep.com/en/articles/8937219-topstepx-trade-copier
6. Save that config.ini
7. run ProjectXCopier app
8. after license check, click 'Copy Start' button to start login and copy
9. if you want to change your input at config.ini file during copier runtime, click 'Copy Start' button again to stop. modify that config.ini file and save. click 'Copy Start' button to resume.
=====
Signal side install
1. If you're using 'MT4/MT5 to ProjectX' suite:
- At MT4/MT5 menu -> 'File' -> 'Open Data Folder'
- Copy MT4ToProjectX or MT5ToProjectX signal ea to /MQL4/Experts or /MQL5/Experts folder
- At MT4/MT5 menu -> 'Tools' -> 'Options' enable 'Allow DLL Import':
- Refresh your experts list
- Open any chart and attach it to chart.
Please only attach to one chart that signal ea will scan all trades of that account.
- Input license key at the first variable.
- Then follow '5. Other signal ea/bot variable explanations' section for the rest of variable input
2. If you're using 'NinjaTrader to ProjectX' suite:
- At NT8 menu -> 'Tools' -> 'Import' -> 'NinjaScript Add-On'
- Import NTPXSignals.zip to NT8. Click 'Allow' if NT8 asks for any indicator access right.
- Open any chart, find 'NinjaTrader to ProjectX Signals' at NT8 indicator list.
- Attach it to one chart
- Ensure your NT8 is connected with your broker/propfirm server.
- Input one NT8 account name that you want to copy from.
NT8 account name can be seen at NT8 control center's 'account' window:
Only attach to one chart for one NT8 account that signal indicator will scan all trades of that account.
- Then follow '5. Other signal ea/bot variable explanations' section for the rest of variable input
3. If you're using 'Quantower to ProjectX' suite:
- Unzip QTPXSignals
- Move that unzipped folder to [your Quantower install folder]/Settings/Scripts/Strategies/ folder.
Note: If you install Quantower by their default path, Quantower folder should be at your computer 'Desktop' folder.
- At Quantower, select 'Strategy Manager'. Then select 'QTPXSignals' from strategy list. Then select 'Setting' icon to set variables. Choose your 'Account' from selection.
- Then follow '5. Other signal ea/bot variable explanations' section for the rest of variable input.
Once finish variable input, click 'Run' to start.
4. If you're using 'cTrader to ProjectX' suite:
- Copy CTPXSignals.algo file to [your computer documents folder]\cAlgo\Sources\Robots folder.
- Select 'Trade' tab (circled in light blue) at cTrader upper left corner. Open any chart and click 'cBot' icon (circled in red) and select TPXSignals bot to chart. Only open one chart to attach that signal bot that will scan all trades of that account.
- Allow unlimited access when cTrader has popup to ask.
- Input license key at first variable and follow below sections to complete other variable inputs. Once finish variable input, click '>' button to start this signal bot.
5. Other signal ea/bot variable explanations:
- ProjectX account names
As explained at ProjectX copier 'config.ini' file setup, ProjectX account name can be found at ProjectX webtrader. Fill in the same account name used at 'config.ini' file.
If you have multiple logins at copier 'config.ini' file, you could input multiple accounts here. For instance, PRACTICE324123,EXPRESS123512 (separated by comma).
- Symbol Mapping List
Format: signal side symbol name, then comma, then ProjectX symbol names, then semi-colon
Example for 'MT4/MT5 to ProjectX':
US500,MESH25;XAUUSD,MGCH25;
As ProjectX only takes front month contract, you could omit contract month. below symbol mapping is also okay
US500,MES;XAUUSD,MGC;
For 'NinjaTrader to ProjectX' copier, you could simply leave this variable as blank string. It will do smart name matching.
- Lot Multiplier List
If you want different lot multiplier for specific symbol, input like
US500,1;XAUUSD,2;
If simply input
1
All signal side lot will be multiplied 1 time to ProjectX copier.
Use signal platform symbol names at this variable.
- Applicable Symbol List
If you want to restrict to certain signal side symbols to be copied, input, e.g.
US500,XAUUSD
separated by comma
Use signal platform symbol names at this variable.
- Reverse Trade?
Default is no. if enabled, all trades will be sent by reversed signals.
- cTrader and MT4/MT5 have one extra variable
Lot mode - default is 'follow order lot'; another option is 'Fixed Lot'
