← All lessons and search

Start here · 7 minute read

Set up access and understand account destinations

Separate AI access from broker access, verify the selected account, and find your saved settings.

Published by BrokerBridge · Guide content reviewed

What happens on first launch

Before you start: Have BrokerBridge open at setup. You can finish this beginner route without connecting a broker. Review the terms and consent choices yourself.

BrokerBridge starts with a short setup. Newer versions first ask What do you want to do first? Choose Practice with simulated money (Start without a broker in earlier versions) to use the Local account straight away. No activation code, broker account, or API key is needed. Newer versions also ask you to tick a box agreeing to share beta usage data before Continue. Depending on your installation, setup may also ask you to choose an AI model.

To use a broker, newer versions offer Connect Interactive Brokers, Connect NinjaTrader 8, and Set up both; earlier versions offer Connect a broker. NinjaTrader 8 runs only on Windows. Setup then asks whether you want a paper or live account; depending on your version, a paper account may need only a verified email. If setup asks you to activate, sign in at brokerbridge.tech, copy your Desktop Activation Code from your dashboard, and paste it into setup. Setup then asks you to choose an AI model and connect the broker.

Every path ends on a last step that asks the most you want to lose on one trade and shows a review and the risk disclosure. Tick the agreement, then press Start using BrokerBridge (Finish in earlier versions). Finishing saves your settings and places no order. Setup may also save a draft strategy for you to edit; it is not running, and Open Strategies takes you to it. The Settings pages named in the rest of this chapter open after setup is finished; until then you can read every lesson here. You can connect or change a broker later in Settings → Broker Accounts.

36-second tour: start with Local. Captioned screen tour from actual captures; no audio or live replay.
Read the transcript
  1. Choose Practice with simulated money (Start without a broker in earlier versions) for the built-in Local account. Read and decide on setup agreements yourself.
  2. To start without the free AI, choose Skip for now: use offline practice. Local Demo then gives sample answers. The Local account and AI access are separate.
  3. In Chat, the Local account button at the top shows where plans go, and Chat tools opens Plans. Local Demo is not an AI tutor; the written guide explains the basics.
BrokerBridge setup, step 1 of 3, asking What do you want to do first? with Practice with simulated money selected.
Full running BrokerBridge app, source build 2026.11.4, captured November 4, 2026 in an isolated Local test profile. No broker or real-money account was connected. Earlier versions show Start without a broker; use the version table and the controls in your installed app. Select the image to enlarge it.
  1. Practice with simulated money (Start without a broker in earlier versions) opens the built-in Local account.
  2. Connect Interactive Brokers, Connect NinjaTrader 8 and Set up both are the broker paths. NinjaTrader 8 runs only on Windows.
  3. Scroll below the choices to tick the beta usage-data box (not shown here), then Continue. Read and decide on the agreements yourself.

Two connections with different jobs

AI access provides the model that answers questions. A broker connection provides account information and, when authorized, accepts orders. Check each separately: model readiness does not prove broker readiness, and a connected broker does not prove orders are enabled.

Choose intentionally. Learning does not require a broker, switching an existing account, or enabling live trading.

Local, broker paper/simulated, and live are different

Simulation helps you learn the controls. It cannot establish the price, speed, liquidity, fees, or emotional experience of a live trade. Switching the screen you are viewing does not retroactively move an existing order or holding to a different account.

Setup's first question with Practice with simulated money selected and the Interactive Brokers and NinjaTrader 8 paths below it.
Cropped from the full running app, source build 2026.11.4, captured November 4, 2026 in an isolated Local test profile. No account, broker or model was connected. Windows 2026.10.13 shows earlier wording. Select the image to enlarge it.
  1. Practice with simulated money selects Local, with $100,000 of simulated money. Local Demo is a separate model choice.
  2. Connect Interactive Brokers: a paper account is free with a verified email; a live account needs Personal Credits.
  3. Connect NinjaTrader 8 is for Windows only. The screenshot does not prove an account connection or order permission.
DestinationWhat it meansWhat to verify
Local accountTrades and fills are simulated inside BrokerBridge. They are not broker executions. Setup calls this your Local account; some settings label it Built-in simulator.The selected destination and each plan say Local. It starts with $100,000 of simulated money and charges no commissions. Waiting orders are checked against market prices about every 30 seconds while BrokerBridge is running, so it needs an internet connection.
IBKR PaperOrders are routed to the connected Interactive Brokers paper environment. The broker simulates execution.The authenticated account and Paper Trading mode match the destination on your plan.
NT8 SimOrders use the selected simulated account on the connected NinjaTrader installation.The specific account name is verified. A running NinjaTrader application alone does not identify the selected account.
IBKR Live or NT8 LiveOrders can use real money in the named connected account.Account identity, live labels, order terms, and permission text all match your intention before any action.

Verify model access

Before you start: Check the Mac/Windows version table first. Open Settings → Models & Credits after setup. Choosing a model does not choose an order destination.

In newer versions, the second setup step is Turn on your free AI. Enter the email you downloaded with and the 6-digit code it sends to turn on 10 AI questions a day with selected free models. Or choose Skip for now: use offline practice (sample answers, no AI), which turns on Local Demo; you can turn on free AI later in Settings. No personal AI key is needed for the managed free path. The allowance is shared, not a separate grant for every model. Personal Credits activation enables Interactive Brokers or NinjaTrader access and paid models; the free daily allowance continues after purchase.

Older versions, including the Windows release offered when this guide was checked, use the earlier setup. Select Start without a broker and follow its model-access result. If it offers Use Local Demo, you can continue with fixed local workflows and the fictional plan lesson. Do not buy credits merely because your screen differs from a newer screenshot; read the access message and the version table first. Provider credentials and subscription sign-in apply only when your installed edition actually offers those options.

Local Demo uses fixed workflows for account-risk review, planning, and journaling. On Mac 2026.11.4.2, an explicit simulated-practice request can show a sample card built from available market data. Choose Practice this trade (simulated money) to save a plan for review, then check Chat tools → Plans. A written outline alone is not a saved Trade Plan. Follow Your first practice walkthrough for the exact request and older Windows differences. Open-ended AI research needs a connected model. Model selection and order destination are separate choices. An explicit trade-now instruction can still place a Local order.

Setup step 2 of 3, Turn on your free AI, with offline practice chosen instead.
Full running BrokerBridge app, source build 2026.11.4, captured November 4, 2026 in an isolated Local test profile. No broker or real-money account was connected. Earlier versions show a Use Local Demo button here. Select the image to enlarge it.
  1. Turn on your free AI sends a 6-digit code to the email you downloaded with. It turns on 10 AI questions a day.
  2. After you choose Skip for now: use offline practice, a green line reads Offline practice is ready (sample answers, no AI). Local Demo then gives sample answers; you can turn on free AI later in Settings.
  3. Activation and model access are separate from the Local account. A Local account does not by itself unlock an AI model.
  1. Open Settings → Models & Credits

    Read the options your installation shows: these may include BrokerBridge models and credits, subscription sign-in, or provider credentials.

    You should see: A selected provider/model and its access state are named.

    If you get stuck: Use the displayed verification or sign-in recovery; buying another service may not resolve it.

  2. Complete the selected connection method

    Follow its browser sign-in or connection fields. Provider-key connections are tested before saving. Not every account requires a personal API key.

    You should see: The connection reports readiness after saving.

    If you get stuck: Return from browser sign-in and read any remaining error before retrying.

  3. Check the features you need

    Read capability labels: Chat covers text, Vision covers images, and PDF indicates supported document reading. An absent label means the capability is unverified.

    You should see: Your intended input is supported.

    If you get stuck: For unavailable image or PDF reading, provide text or choose a compatible available model.

Confirm the account that answered

Before you start: Open Settings → Broker Accounts. For an initial IBKR connection check, keep Read-Only API enabled in IBKR.

Interactive Brokers turns on Read-Only API by default. Leave it on for your first connection test: balances and positions load, and no order can be sent. Before you send practice orders to IBKR Paper, turn Read-Only API off in the IBKR application's API settings and restart it, or your first order will be refused. Then choose Test again: ready for orders in setup. BrokerBridge asks IBKR to check a sample order for your paper account and places nothing; it shows a check mark when the account can receive orders.

Keep IBKR connected for scheduled runs. IB Gateway and Trader Workstation log off once a day: turn on Auto restart under Lock and Exit in their settings so they restart without a new login. IBKR still asks you to sign in again with two-factor authentication about once a week, and until you do, Autopilot and scheduled runs cannot reach your account. Leave Allow connections from localhost only on when BrokerBridge runs on the same computer; if IBKR runs on another computer, turn it off there and add this computer under Trusted IPs.

  1. Open Settings → Broker Accounts

    Read the Selected destination line, the connection status, and the account's Local, Paper, Sim, or Live label.

    You should see: An exact account name or identifier matches the intended destination.

    If you get stuck: Resolve missing, changed, or unverified accounts before ordering.

  2. For Interactive Brokers, prepare the IBKR application

    Open IB Gateway or Trader Workstation and sign in with the Trading Mode you intend: Paper Trading or Live Trading. In its API settings, enable ActiveX and Socket Clients if that control is shown. During first-launch setup, pick the matching application and Trading Mode, then choose Test broker connection. In Settings, use Connection presets, then Test Connection.

    You should see: The test names the authenticated account and mode that answered.

    If you get stuck: For Connection refused, keep the IBKR application open and check its Socket port: 4002 for IB Gateway with Paper Trading, 7497 for Trader Workstation with Paper Trading. A paper preset alone does not prove a paper login; read the mode the test reports.

  3. For NinjaTrader, install the link, pair, and bind an account

    NinjaTrader 8 runs only on Windows, so install BrokerBridge on the Windows PC or Windows VPS that runs NinjaTrader 8; on a Mac, Broker Accounts shows this notice instead of install steps. The first time, open Install the NinjaTrader link in Broker Accounts: download the link from your BrokerBridge account, quit NinjaTrader, and choose Install the link for me, which copies the link file into NinjaTrader's Custom folder (or copy it yourself). Then start NinjaTrader, register the Machine ID the link prints, and restart NinjaTrader. When Link detected turns green, choose Pair securely with NinjaTrader, choose your Sim account, set its class, and choose Bind account.

    You should see: The badge reads NT8 connected, and the bound account name and class are shown.

    If you get stuck: Install the link for me refuses while NinjaTrader is running: exit it from its tray icon and try again. UNVERIFIED usually means NinjaTrader or its link is not running; start both and retry. If the panel says entries are unavailable on this NinjaTrader build, update the link before relying on it. A generic Connected message does not identify the account.

Finish with a saved-settings check

  • Open Risk & Trading and read each rule's value, unit, and explanation. Some rules use percentages; others use counts, ratios, or on/off settings. A position allocation and a planned loss are different limits. Leave each rule's Enabled box ticked while you learn.
  • After changing a value, choose Save & Apply at the bottom of Settings. Wait for the success message, then reopen the section to confirm the saved value.
  • Visit Dashboard and Journal so you know where account information and history appear. Empty history is expected for a new account.
  • If a getting-started step refuses to save, address the reported error. Ticking checklist items does not unlock approval; the app checks your actual setup.

Continue in the website manual

The website manual keeps the detailed broker setup steps, prerequisites, videos, and transcripts. Choose the guide for your own destination and read its availability notes. A paper or simulation tutorial does not change the account you selected in the app.

The NinjaTrader beginner walkthrough is not available yet. Use Local for this learning path, or ask support about your installed NinjaTrader version before attempting that connection.

See this workflow in BrokerBridge

Explore the matching tool, or try an illustrative browser example. Use this lesson to understand the controls before working in your own account.

Check your understanding

Practice questions only. Answers do not change accounts, orders, or permissions.

1. An AI model is connected. Does that prove the broker account is ready?

2. Local Demo returns a written plan outline. Where is its saved plan card?

Download all beginner lessons for offline reading

Browse documentation