What the simulator doesn't model
What the simulator does
The simulator is the part of Rungfolio that decides which orders would have filled. It fills orders against real price bars, each of which sums up a stretch of trading and records its open, high, low and close. Practice mode replays each trading day's session from 1-minute bars, and backtests use 5-minute bars by default (a backtest's assumptions). Its rules are cautious:
- Trade-through: a limit order fills only when the price trades through its limit, not when it merely reaches it.
- Gap fills at the open: when the session opens past a limit, the order fills at the open. Only an order's first bar can fill it at a better price than its limit.
- Regular hours only: orders fill only in the sessions where the broker would accept them.
- No same-bar round trips: a sell can't fill in the same bar as its buy.
- The cash guard: a buy fills only if the account's cash covers it.
Practice nights, backtests and live accounts' likely fills use the simulator. The same code will run the public showcase (milestone 8). A backtest tests a ladder's settings on past prices, and the showcase is the public set of backtest results on rungfolio.com. Because it is one piece of code, every one of them shares the limits below. The same prices and orders always give the same result.
What it doesn't model
A simulator is a simplification. These things are left out.
Partial fills. Every simulated order fills completely or not at all. At a broker, a large order can fill in pieces, or only in part. So a simulated fill can be more complete than a real one. In a live account, a likely fill is only a suggestion: if your broker filled a buy only in part, you enter the shares that filled, and tonight's list cancels the rest of the buy and replaces the lot's sell for the shares it holds (the evening routine).
Slippage beyond the trade-through rule. Slippage is the gap between the price an order asks for and the price it gets. A simulated limit order fills at its limit, or at a better opening price. A floor exit fills at the opening price of the session's first regular-hours bar, and so does a re-armed rung whose buy limit is at or above the last close, when that bar opens below its limit. Real fills can differ, especially at a busy open.
Minutes with no trades. The 1-minute bars Rungfolio gets can leave out minutes in which nothing traded. The simulator works with the bars it has, and doesn't fill in the missing minutes. So after a quiet stretch, the next bar can open well away from the close of the bar before it. If that open passes the limit of an order that was already working, the order fills at its limit, by the trade-through rule, not at the open.
Fees. Practice mode counts every trade as free. Many brokers charge no commission on US stocks and ETFs online, but any other fee a real trade carries isn't simulated. A live account counts the commission per order that you set for it.
Settlement and day trading. In practice mode, a sale's cash pays for a buy at once, and a lot can be bought and sold on the same day. A real account has settlement and day-trading rules that can limit both.
Dividends. A dividend is a payment a company makes to its shareholders. Dividends aren't added to simulated cash.
Taxes. Taxes aren't worked out, and Rungfolio doesn't do tax reporting.
Why it matters
Simulated results are hypothetical. They come from a model, not from real trades. They show how the rules behave on real prices, not what an account would earn. The simulator's rules lean cautious, but they can't cover everything above.
Each item above is a way a real account could differ from a simulated one. That is true of every practice night and every backtest, and will be of every showcase result.