Whose account
When you connect, you say who the account is with:- Lucid Trading or FundedNext. These are the two firms offered, because their own rules allow trading bots. An evaluation or funded account is always a Live account in TraderFrame.
- My own account: your own NinjaTrader account, as Practice or Live.
Before you start
- NinjaTrader 8 installed on your computer, with the login your firm gave you (or your own account’s login).
- NinjaTrader must stay open while your bots run. The add-on lives inside it.
Connect
- Brokers → Connect broker → NinjaTrader. Choose the firm, or My own account. TraderFrame shows your add-on token and a Download add-on (.zip) button. Treat the token like a password.
- Open NinjaTrader 8 and sign in. You type your login into NinjaTrader, never into TraderFrame.
- In NinjaTrader open Tools ▸ Import ▸ NinjaScript Add-On and choose the zip you downloaded. NinjaTrader asks whether to authorise an add-on that runs by itself: choose Yes. It then asks you to close NinjaTrader and open it again.
- Open NinjaTrader again and connect. Then open New ▸ TraderFrame, paste your add-on token, pick the account this connection trades, and press Connect.
- Leave NinjaTrader open. TraderFrame shows the account as Connected within about 20 seconds.
Updating the add-on
The Brokers page shows a download link on the account’s card when a newer add-on is out. Download it and import it the same way as in step 3; NinjaTrader replaces the installed copy and asks for a restart. Your token stays.Firm rules
A funded account ends when a rule is crossed, not when a trade loses. On a firm’s account the bot editor has one more step in Risk management, called Firm rules. Until you fill it in, it reads Not set · enter your plan’s limits. Open it and copy the numbers from your firm’s plan, exactly as its dashboard shows them:
TraderFrame has no presets for any firm. If a number is wrong, the bot protects the wrong number.
After you save, the panel shows the room left on each limit, and the account’s card on the Brokers page shows the same under Firm rules · room left. Change these numbers reopens the form.
What the bot refuses
With firm rules on the account, the bot will not:- Open a trade whose loss at its stop is more than the room left.
- Send an order larger than your plan’s largest order. A Martingale step is checked like any other order.
- Send an order whose risk cannot be measured: one with no stop, or a stop set in ATR.
- Open a new trade from 5 minutes before the flat-by time.
At the flat-by time
An entry order that has not filled is cancelled, and an open position is closed at market. The closed trade reads Firm rule. The check runs once a minute, so the close can go out up to a minute after the time you entered: set the time a little ahead of your firm’s own.If the account ends
When a rule is crossed the account’s card reads Breached, with the recorded reason and the day. Its bots are paused and nothing trades on it again. The account keeps its history. Move its bot on the card opens the bot’s editor on the account picker, so you can give that bot another account.The bot
A NinjaTrader bot uses the same editor and panels as an Interactive Brokers futures bot: a product rather than a symbol, whole contracts, a session, a flatten time and an Exit rule. Two things differ:- Stop and target are placed when the entry fills. The entry goes to NinjaTrader first. The moment it fills, the add-on places the stop and the target as a pair where one cancels the other. Keep NinjaTrader open while a position is open.
- Distances are measured from the fill. A 20-point stop from the Exit rule sits 20 points from the price you were filled at, on market and limit entries alike. A stop or target carried in the signal itself is a price and is used as sent.
Closing by hand
Close now on the Trades tab sends a market order the other way through the add-on, for that trade’s contracts only. The stop and target stay working until the close has filled, and NinjaTrader cancels them the moment it does. You can also close in NinjaTrader itself, for example with Close Position on the Positions tab. The add-on reports it and the trade reads Closed by hand.When NinjaTrader is not reachable
- NinjaTrader not connected: the add-on is running but NinjaTrader has lost its connection to the account. Connect in NinjaTrader.
- Add-on offline: nothing is reporting. Check that NinjaTrader is open, connected to the account, and that the TraderFrame window says it is connected.
- Token refused: copy the add-on token again and paste it into the TraderFrame window in NinjaTrader.
Limits
- One token, and one add-on connection, per NinjaTrader account.
- The add-on places orders only for commands TraderFrame queued for this account. It never trades on its own.
- The Trade Agent sends the entry only. Every exit is your bot’s own Exit rule, as on every venue.

