Jay Rocco is the Founder and Editor of FullStack Alpha. He has tested 200+ AI stock tools since 2022 and run 15+ AI trading platforms on live accounts with his own money. He reviews the software. He does not tell you what stocks to buy.
Quick Answer
Interactive Brokers paper trading is a free simulated account that starts with $1,000,000 in virtual Equity with Loan Value and uses real market prices, your live account’s market data subscriptions and nearly every TWS order type. New IBKR clients get one automatically, usually within 24 hours of approval; older accounts may need to request it through Client Portal. Bots connect to it on port 7497 (TWS) or 4002 (IB Gateway) with a separate paper username. The catch: fills are simulated from the top of the book, so execution looks cleaner than it will with real money.[1][3][11]
It’s the standard staging ground for testing trading bots, API scripts, and new strategies before a single real dollar is on the line.[7][9] We test every broker sandbox the same way on AI Stock Trading Bots, and IBKR’s is the most complete one a retail trader can get for free.
On AI Stock Trading Bots: go deeper in our Paper Trading guide, and see How We Test for the method behind every score.
Key Takeaways
- Interactive Brokers paper trading gives you $1,000,000 in simulated equity by default. You can reset it any time in Client Portal, up to five times your live account’s value; requests entered before 4:00 pm ET take effect the next business day.[5][8]
- New IBKR accounts get a paper account automatically once the live account is approved. Older accounts may need to request one.[2][4]
- Margin in a paper account is set to Reg T and cannot be changed.[3]
- Fills are simulated from the top of the book only. VWAP, Auction, RFQ, and Pegged to Market orders aren’t supported, and the unfilled remainder of a partially filled market order is rejected.[1][5]
- Bots connect through TWS (paper port 7497) or IB Gateway (paper port 4002) and can send about 50 requests per second on the default 100 market data lines.[11][12]
- Mutual funds and penny-priced US options aren’t tradeable in paper mode.[1][5]
- Paper trading is free. It costs nothing beyond having an approved IBKR account.[3]
- This is education, not financial advice. Simulated results say nothing certain about live performance.
What Is Interactive Brokers Paper Trading?
Interactive Brokers paper trading is a simulated brokerage account that lets you place trades with fake money against real, live market prices. It works in Trader Workstation (TWS), IB Gateway, Client Portal, and the IBKR Mobile app, and it runs alongside your real account without touching it.[1]
The official IBKR documentation is blunt about what this actually is: a simulator, not a shadow exchange. Trades never execute on an exchange or settle at a clearing house. Fills are modeled, not executed.[1][5]
That distinction matters. A paper fill tells you what should happen under normal conditions. It does not tell you what happens when liquidity dries up at 3:58 PM on a Friday. Keep that gap in your head every time you look at a paper P&L.
How Do You Set Up an Interactive Brokers Paper Trading Account?

Setting up a paper account at IBKR is now largely automatic. Once your live account application is approved, IBKR provisions a linked paper account, normally within 24 hours, and emails you when it’s ready.[1][4] Advisors, brokers, hedge funds and residents of India and Japan log in with separate paper credentials by design.[5]
If you opened your account before this became standard, or you don’t see a paper account in your dashboard, here’s the fix:
- Log into Client Portal, click the head-and-shoulders icon (top right), choose Settings, then Paper Trading Account under Account Configuration.[7]
- Request a paper account if one isn’t already listed.[2]
- Note your paper username and paper account number. You’ll need both for API work. If you never set a paper password, use “Reset Paper Trading Password” on the same screen.[7]
- Launch TWS or IB Gateway, set the Live/Paper toggle above the username field to Paper, and log in with the paper credentials, not your live ones.[1]
- In the Paper Trading Account settings, choose to share real-time market data with the paper account if you want live price action instead of delayed quotes.[4]
- Confirm the window says you’re in a simulated account. IBKR says the paper interface clearly flags this; if it doesn’t, you’re in production and liable for fills.[5]
One clean setup, five minutes, no fee. That’s the whole barrier to entry.
How Much Virtual Money Do You Get With Interactive Brokers Paper Trading?
IBKR paper accounts start with $1,000,000 in “Equity with Loan Value,” a balance that moves up and down as if the trades were real.[1][3][4] That’s the default for every new paper account.
A few practical notes on the balance:
- It fluctuates with your simulated positions, just like a live margin account.
- You can reset the cash equity at any time, up to five times your production account’s value.[5]
- $1,000,000 is a testing sandbox, not a target. Sizing a paper trade the way you’d size a $2,000 live account is the entire point.
Practical takeaway: trade your paper account at the size of the real account you actually plan to fund. Testing a strategy with $1,000,000 in buying power when your live account will hold $5,000 teaches you nothing about your real risk-reward.
How Do You Reset an Interactive Brokers Paper Trading Account?
The reset lives in Client Portal, and it has one rule that trips people up: you must trade out of open positions first.[8]
- Close every open paper position.
- Log into Client Portal with your paper username and password.
- Click Trade to open the Paper Trading Account Reset page.
- Pick the equity amount from the Select Reset Amount list and confirm on the verification page.
- Submit before 4:00 pm ET. Requests received by then are processed by the next day.[8]
Worked example: a trader with a $10,000 live account can reset paper equity to as much as $50,000 (five times production value).[5] We’d go the other way and pick the smallest amount on the list that is close to $10,000, so every position size the bot learns is one you could afford live.
Is Interactive Brokers Paper Trading Free?
Yes. It costs nothing beyond having an approved account.[3] There’s no separate subscription, no simulator fee, no premium tier that adds more virtual cash.
The only cost most traders overlook is market data. IBKR says the paper account’s market data subscriptions, trading permissions and base currency are the same as your regular account, so real-time quotes in paper mode depend on what you already pay for live.[1][5] If a quote looks stale in the simulator, check your live data subscriptions before you blame the bot.
What Limits and Restrictions Does Interactive Brokers Paper Trading Have?
The IBKR simulator has real functional limits, and most of them come down to one thing: it simulates fills, it doesn’t execute them. That changes behavior at the edges.
| Limit | What it means |
|---|---|
| Top-of-book fills only | No access to deep order book data; simulated fills can be more forgiving than a real fill in a choppy tape |
| Some order types unsupported | VWAP, Auction, RFQ, and Pegged to Market orders don’t work in paper mode[1][4] |
| Margin-only structure | Margin is set to Reg T and cannot be changed[3][5] |
| No mutual funds | Mutual fund trading isn’t available in the simulator[1][4] |
| No penny-priced US options | Sub-penny and penny option pricing isn’t simulated[1] |
| Limited portal functions | Some Client Portal features are restricted for paper accounts, though core TWS tools stay intact[1][5][6] |
Common mistake: assuming a stop order will behave identically in paper and live mode. Stops and complex orders are always simulated in paper trading, so slippage and fill behavior can differ meaningfully from a real order hitting a real market.[1][4] Our paper trading slippage test shows how big that gap gets on fast names.
How Long Can You Keep a Paper Trading Account Active on Interactive Brokers?
A paper trading account stays linked to your live IBKR account. A hard expiration date for paper accounts tied to an active live account is not published on the IBKR pages we checked (October 2026).[8]
What can trip you up is closing the live account it’s linked to. If you’re planning a multi-month bot test, log in every few weeks and pull a paper statement from the Reports menu so you have a record if anything changes.[5]
Can You Use Paper Trading to Test Trading Bots on Interactive Brokers?

Yes, and it’s exactly what IBKR’s own API documentation recommends. The TWS API guide says a paper account lets you use the full range of trading facilities in a simulated environment, and warns that order execution may vary because paper relies on more simulated technology than live.[16] The Web API guide tells developers to log into the Client Portal Gateway with the paper username, since there is no live/paper slider at that login.[7]
Here’s the practical workflow:
- Grab your paper username and paper account number from Client Portal settings.[7][8]
- In TWS, open Global Configuration, then API, then Settings. Enable “ActiveX and Socket Clients,” disable “Read-Only API,” and check the “Socket Port” value.[13]
- Point your script at 127.0.0.1 on the paper port: 7497 for TWS, 4002 for IB Gateway.[11]
- Wait for the
nextValidIdcallback before sending anything. IBKR says calls made before it can be dropped.[15] - Set hard caps in your config: max trades per day, max portfolio exposure, and a flag such as
PAPER_TRADING=truethat your code checks before every order.[10] - Log every connection and order attempt so you can audit behavior later.
Note on the TWS API: an IBKR Pro account is required, and the old GitHub-hosted docs are marked deprecated. Use the current documentation on interactivebrokers.com.[13][17] For the full install, see our Interactive Brokers TWS API setup guide.
Practical takeaway: paper trade it first, always. A bot that’s never seen a real fill, a real spread, or a real API disconnect has no business touching a funded account. If you’re building or evaluating an execution bot, the best AI trading bot roundups and this breakdown of what to check before you automate trades are worth reading before you write a line of code. Building it yourself? Start with our Build a Trading Bot guide, or wire up an AI assistant with IBKR API and Claude.
Which Ports and Settings Does Interactive Brokers Paper Trading Use for the API?
Wrong port is the most common reason a bot “can’t see” the paper account. These are the defaults from IBKR’s own API reference.[11]
| Platform | Live port | Paper port |
|---|---|---|
| Trader Workstation (TWS) | 7496 | 7497 |
| IB Gateway | 4001 | 4002 |
Other limits worth wiring into your code:
- Client IDs: TWS supports up to 32 simultaneous API connections. IBKR suggests client ID 0 for full order management.[11]
- Pacing: the request cap equals your market data lines divided by two, per second. Default accounts have 100 lines, so 50 requests per second.[12]
- Daily restart: in Global Configuration, Lock and Exit, IBKR recommends “Never lock Trader Workstation” and “Auto restart” for API users.[14]
- Weekly login: the weekly reauthentication cycle starts every Monday and needs a manual login.[14]
If you use the Client Portal Web API instead of sockets, read our notes on what the IBKR Web API update broke for bots before you schedule a long paper run.
What Errors Will Your Bot Hit in Interactive Brokers Paper Trading?
These are the failures we see most when a bot first meets the paper account, with what IBKR’s docs say causes them.
- Error 502 on connect. The operating system couldn’t open the socket. IBKR says this usually means TWS isn’t running with the API enabled or is listening on a different port; across a network, a firewall or a missing “Trusted IPs” entry can also cause it.[15]
- Error 100 (pacing). If “Reject messages above maximum allowed message rate” is checked, TWS sends error 100 when you exceed the limit, and after three violations the API session terminates (WinError 10053 on Windows, BrokenPipe on macOS or Linux). Uncheck it and TWS paces requests for you instead.[18]
- “Soft token=0 received instead of expected permanent.” That’s the Monday weekly reauthentication. Log in by hand.[14]
- Half a market order vanishes. The simulator rejects the remainder of any exchange-directed market order that partially executes. Your position logic must read actual fills, not intended size.[5]
- A market order just sits there. If there’s no quote on the opposite side, the simulator holds the order until market data arrives.[1]
- Feature works in paper, missing in the API. IBKR’s rule: if a feature isn’t available in TWS, it isn’t available in the API either. Test it by hand in TWS first.[16]
Canadian residents, note this one: Interactive Brokers Canada does not allow clients to send API orders for products traded on Canadian exchanges.[16]
Can You Run Algorithmic Trading Strategies on an Interactive Brokers Paper Account?
Yes. Nearly every TWS order type and contract type available to live traders is also available in paper mode, and IBKR says the API works with paper accounts with minimal differences compared to live use.[1][6] That’s why quants and retail developers use it as the default staging environment for algorithmic strategies.
Best practice from experienced bot builders:
- Run separate Gateway instances for paper and live (ports 4002 and 4001) so you never accidentally cross-wire credentials.
- Schedule test runs around market close to catch end-of-day behavior without real exposure.
- Validate Python bots and any AI-driven signal logic in paper mode for weeks, not hours, before flipping to a funded account.
If you’re still building the strategy logic itself, start with how to find a trading edge before you risk a single dollar and how to backtest a trading strategy without fooling yourself. A bot without a tested edge is just an expensive way to lose money faster.
How Realistic Is Interactive Brokers Paper Trading Compared to Live Markets?
IBKR’s simulator is realistic for price action, charting, and order mechanics, but it’s not realistic for execution quality. Because fills are simulated from the top of the book, you often get cleaner, faster fills than you would in a genuinely choppy tape.[1][4]
Where the gap shows up:
- Slippage: Paper mode tends to understate slippage on fast-moving or low float names.
- Partial fills: Real markets can leave you half-filled during volatility. Paper mode rejects the remainder instead of working it.
- Psychology: The biggest gap isn’t technical. It’s emotional. Losing simulated money doesn’t trigger the same revenge trading impulse that losing real money does.
Decision rule: treat paper trading as a mechanics test, not a psychology test. It tells you if your system works. It won’t tell you if you’ll actually follow it under pressure.
How Does Interactive Brokers Paper Trading Compare With Alpaca and Webull?
IBKR’s simulator is the deepest of the three, and the hardest to set up. Alpaca’s paper account runs on its own host, https://paper-api.alpaca.markets, and its free data is the IEX feed rather than the full SIP tape (see our Alpaca API for beginners guide). Webull’s paper trading runs inside its app and web platform (see our Webull paper trading walkthrough).
- Use IBKR paper if you plan to trade options, futures or international markets live at IBKR, or you need TWS order types.
- Use Alpaca paper if you want a plain REST API and a working Python bot this weekend.
- Skip both if you haven’t backtested the idea yet. A simulator can’t fix a strategy with no edge.
What’s the Difference Between Paper Trading and Live Trading on Interactive Brokers?

The core difference is that paper trading never touches a real exchange, so no trade is executed, cleared, or settled.[1][5] Live trading does all three, with real money, real regulatory reporting, and real consequences for getting stopped out.
Beyond that, the practical differences are: paper margin is fixed at Reg T, some order types and asset classes are restricted, and portal functionality is trimmed down compared to a live account.[3][4][5]
Can You Switch From Paper Trading to Real Money on Interactive Brokers?
No. IBKR says you cannot convert a paper trading account to a live account, because it’s already connected to your live account. You fund your actual live IBKR account separately, and the paper account keeps running alongside it as a permanent testing environment.[5]
That structure is a feature, not a bug. You keep the sandbox even after you go live, so you can keep testing new setups without disturbing the account that holds your actual capital.
Our go-live rule: switch a bot from port 7497 to 7496 only after it has run at least four weeks in paper with zero unhandled errors, real position sizes, and a written kill switch. Start live at a fraction of the paper size. That rule is ours, not IBKR’s, and it’s cheap insurance.
Why Isn’t My Paper Trading Account Working on Interactive Brokers?
The most common reason a paper account “isn’t working” is logging in with live credentials instead of the separate paper username, or connecting a bot to the wrong port.[7][11] Check these first:
- Confirm you’re using the paper-specific username and account number from Client Portal, not your live login.[7]
- Verify “ActiveX and Socket Clients” is enabled and “Read-Only API” is off if you’re running a bot.[13]
- Check for a second login. An IBKR reply on its paper trading lesson says there can only be one active session at a given time.[3]
- Check that your live account is still active and approved. The paper account is tied to it.[5]
- If data looks delayed or frozen, confirm market data sharing is turned on in the paper account settings.[4]
What Are Common Mistakes People Make With Interactive Brokers Paper Trading?
The single biggest mistake is oversizing. Trading the full $1,000,000 balance instead of the size of your actual planned account builds habits that don’t transfer.[1] Beyond that:
- Ignoring order type gaps. Building a strategy around VWAP or Pegged to Market orders that simply don’t exist in paper mode, then getting surprised when live behavior differs.[1][4]
- Skipping the stress test. Never running the bot or strategy through a genuinely choppy, low-liquidity session.
- Treating a winning streak as proof. A clean run in paper mode with forgiving simulated fills isn’t the same as surviving a real bull trap or a dead cat bounce with real slippage.
- Never resetting the account. Letting a blown-up paper balance sit there instead of resetting and running the test again with tighter risk management.
Systems over hacks: the point of paper trading isn’t to prove you’re right. It’s to find out where you’re wrong before it costs anything.
Is Interactive Brokers Paper Trading Good for Beginners?
Yes, with a caveat. It’s an excellent way to learn order entry, platform navigation, and basic risk management without financial risk, which is exactly the use case IBKR’s own training material highlights.[9] The caveat: it won’t teach the emotional discipline that live trading demands, because losing fake money doesn’t hurt.
Beginners get the most value by treating paper trading as platform training, not strategy validation. Learn TWS. Learn order types. Learn how support and resistance actually look on a live chart. Then size a real account small and build discipline with money that’s actually yours.
Our Take
Interactive Brokers paper trading is a free, $1,000,000 simulated account built into TWS, IB Gateway, and Client Portal that mirrors live pricing without real execution.[1][3] It’s a solid platform trainer for beginners and the standard staging environment for anyone building or testing an automated bot.[7][9]
The next step is simple: open the paper account, wire it up to a bot or strategy sized like your real account, and run it for weeks, not hours, before you touch live capital. If you’re evaluating which automated tools are worth that testing time, start with automated trading bot results and the fully automated AI trading bot directory, compare brokers in our sister site’s platform reviews, and read one builder’s honest, unfiltered attempt in my AI built me a trading bot and neither of us knows what we’re doing before you write your own.
This article is education, not financial advice. Paper trading results don’t predict live performance, and no simulated strategy promises a real return.
There are 200+ AI trading tools catalogued in the FullStack Alpha directory, filterable by category, price, and what they actually do.
Browse the FullStack Alpha directory of 200+ AI stock tools
Affiliate disclosure: some links on this page may earn FullStack Alpha a commission at no extra cost to you.
Keep Going
More from AI Stock Trading Bots: Paper Trading · Broker APIs · Build a Trading Bot.
Written and edited by Jay Rocco, Founder and Editor of FullStack Alpha. 200+ AI stock tools tested since 2022. Educational content only, not financial advice. See our Financial Disclaimer and How We Make Money.
Free weekly email
Join the FullStack Alpha newsletter
One email a week. The AI trading tools we tested, what broke, and what is worth your money. NO BS, no stock picks. Stay alpha.
Unsubscribe anytime. We never sell your email.
Stay alpha.
References
[1] IBKR Campus: Paper Trading Account (glossary)
[2] IBKR Campus: Request a Paper Trading Account
[3] IBKR Campus: Signing Up for a Paper Trading Account
[4] IBKR Guides: Paper Trading Account
[5] IBKR Guides: About Paper Trading Accounts
[6] Interactive Brokers: Trader Workstation
[7] IBKR Web API Docs: Paper Account Authentication
[8] IBKR Guides: Account Management for Paper Trading Accounts
[9] IBKR Campus: IBKR Paper Trading Account course
[10] Humbled Trader: AI Trading Bot With Claude and IBKR
[11] IBKR TWS API Docs: connect_and_start (default ports and client IDs)
[12] IBKR TWS API Docs: Pacing Limitations
[13] IBKR TWS API Docs: Installation and TWS settings
[14] IBKR TWS API Docs: Daily and Weekly Reauthentication
[15] IBKR TWS API Docs: Establishing an API Connection
[16] IBKR TWS API Docs: TWS API Limitations
[17] Interactive Brokers: legacy TWS API documentation (deprecated)
[18] IBKR TWS API Docs: Pacing Behavior
Frequently Asked Questions
Does everyone get a paper trading account automatically?
New IBKR accounts get one automatically once the live account is approved and funded. Older accounts may need to request one through Client Portal.
Do paper trading accounts expire?
There's no published fixed expiration for an active, linked account, but prolonged inactivity across your IBKR relationship can affect access.
Can I use the paper account for options and futures?
Most contract types available in TWS are available in paper mode, with the exception of penny-priced US options and a handful of restricted order types.
Does paper trading use real-time data?
It can, if the paper account is linked to a live data feed on your account. Otherwise you may see delayed quotes.
Is API access the same in paper and live mode?
The connection process is similar, but you use separate paper credentials and typically a different port for testing. IBKR explicitly recommends validating bots in paper mode first.
Can I lose real money in a paper trading account?
No. Trades never route to a real exchange, so no real capital is at risk in paper mode.
Jay Rocco is the Founder and Editor of FullStack Alpha. He has tested 200+ AI stock tools since 2022 and run 15+ AI trading platforms on live accounts with his own money. He reviews the software. He does not tell you what stocks to buy.