Copy trades from MatchTrader to TopstepX when you trade CFDs on a MatchTrader prop firm account and want your Topstep Trading Combine or Express Funded account to take the same trades in futures. Heron Copier reads the MatchTrader master, opens the matching futures position on TopstepX in whole contracts and closes it with the master.
TopstepX connects through the ProjectX API, so you need the ProjectX API subscription and an API key, and live funded and follower accounts cannot be copied to. Map each CFD to a contract with an alias such as XAUUSD=MGC. Without an expiry in the alias, the current front-month contract is used. Equity-to-Equity works out the number of contracts from what the futures contract is worth per point and rounds to the nearest whole contract, so a small CFD position can come to less than half a contract and be skipped. Additional TP/SL and TP/SL offsets on a TopstepX slave are set in ticks. A MatchTrader master does not pass partial closes on yet, so if you scale out, the TopstepX position stays open in full until you close the rest.
TopstepX accounts run in the Heron Copier cloud only, so the MatchTrader master runs there as well, with no VPS and nothing to install.
How to set up MatchTrader to TopstepX copying
- Add your MatchTrader account as the master in the dashboard. Connect it with your MatchTrader login, password and broker.
- Add your TopstepX account as the slave and pick the master it copies from. Connect it with your TopstepX username or account email and a ProjectX API key.
- Choose a volume sizing method and add symbol aliases such as NAS100=MNQ, so each CFD symbol maps to a futures contract. Sizes are rounded to whole contracts.
- Launch. Cloud accounts are usually online in under 60 seconds, and the dashboard shows every copied trade, balance and position live.
About MatchTrader and TopstepX
MatchTrader is Match-Trade Technologies' browser-based platform. Brokers and prop firms run it under their own brand, each with its own symbol names and account setup.
TopstepX is Topstep's own futures trading platform, built on ProjectX. Topstep traders use it for Trading Combine and Express Funded accounts, and the ProjectX API lets outside tools such as Heron Copier connect.
For everything else about each platform, see the MatchTrader Trade Copier and TopstepX Trade Copier pages.
MatchTrader vs TopstepX
| Detail | MatchTrader (master) | TopstepX (slave) |
|---|---|---|
| Made by | Match-Trade Technologies | Topstep (ProjectX) |
| Markets | Forex, indices, metals, commodities and crypto CFDs, depending on the broker or prop firm | CME Group futures and micro futures traded in Topstep accounts |
| How Heron Copier connects | MatchTrader login, password and broker | TopstepX username or account email and a ProjectX API key |
| Position model | Hedging: positions are tracked one by one | Net position per contract |
| Trade size | Lots | Whole contracts |
| Symbol names | Set by each broker or prop firm | Dated contracts such as ESZ6 or MNQH7 |
| API speed | 500 requests per minute | Real-time order and position updates |
| Partial closes sent to slaves (as master) | No | Yes |
| Partial closes received (as slave) | No | Yes |
| Position resync on its slaves | No | Yes |
| Local version | Yes, plus the cloud version | No, cloud version only |
| EA / cBot hosting | No | No |
Things to check before you start
- CFD lots and futures contracts differ a lot in size. Map every symbol you trade with an alias and a lot multiplier, then test with the smallest size before you go live.
- Turn on Position Resync if you want the TopstepX slave to check that every copied position is still open on the master.
- Partial closes on a MatchTrader master are not passed on to the slaves yet. Full closes are copied, so a trade you scale out of stays at full size on the slaves until you close the rest.
- Only Trading Combine and Express Funded accounts can be traded through the ProjectX API. Live funded accounts and follower accounts cannot be copied to.
- Auto symbol mapping is not available on TopstepX slaves. Additional TP/SL and the TP/SL offsets are set in ticks instead of pips.
Frequently asked questions
Can one MatchTrader master copy to several TopstepX accounts?
Yes. Add as many TopstepX slaves as you need, each with its own volume sizing, symbol mapping and risk limits. In the cloud every account uses one cloud seat.
Can I copy from TopstepX to MatchTrader instead?
Yes. Every trading platform Heron Copier supports can be a master or a slave. See the TopstepX to MatchTrader trade copier.
What happens if a trade fails to copy?
Turn on failed trade copy notifications to get an e-mail alert. The account logs in the dashboard also show the reason, for example a symbol that doesn't exist on the slave or a size below the minimum.
Is there a free trial?
Yes, 7 days with 2 cloud accounts. During the trial a futures slave copies every trade at a fixed 1 contract; a paid license unlocks the other sizing methods.
