rungfolio

Practice and live modes

Two modes

Every Rungfolio account runs in one of two modes. A practice account simulates fills. A live account tracks your real brokerage account. Both run the same engine and the same rules.

Practice mode is for trying a ladder on real prices. Live mode is for running one with real money, at your broker. The difference is who does the bookkeeping. In practice mode, Rungfolio does it: it counts the orders as placed, simulates the fills and tracks the cash. In live mode, you do a short routine each evening, so that Rungfolio's records match what happened at your broker.

Practice mode

A practice account has no broker behind it, so no real orders are placed, and its cash is practice cash, not money. There are no orders to enter anywhere: you watch the ladder work on real prices. What it records is a simulation, not a record of real trades.

Your practice accounts

The first time you sign in, Rungfolio makes you a practice account named "Practice", with $10,000 of practice cash and a ladder on the TNA template, Rungfolio's starting settings for the ticker TNA. Home shows the ladder's first orders straight away, marked "Placed tonight", until the nightly job places them.

You can add more: up to 10 practice accounts, each with its own cash and capital cap, and up to 20 ladders in each, one per ticker. An account's ladders share its cash and its cap, in a priority order you set. Practice accounts explains accounts, priority, and how to reset or archive one.

Adding a ladder, or changing one

The new-ladder preview plans a ladder from a ticker's real prices: it takes the last close and works out the moving average for the number of days you set, and you choose the other settings. The starting price is the last close unless you type one. "Start practicing" asks which account the ladder goes in, and adds it at the bottom of that account's priority order. Adding a ladder never changes the account's cash or cap.

If the account already runs that ticker, you choose:

  • Apply to that ladder: it keeps its lots, and the new settings take effect from the next plan. The preview's cap becomes the account's. Apply isn't offered for a ladder winding down, closing or waiting for a split's review.
  • Replace it: the old ladder ends and the new one takes its place, and the account's cash and cap stay as they are. This is offered only when the old ladder holds no open lots. A ladder whose orders worked in the last session can't be replaced until that session's nightly run: replace it after that run.

Each ladder's page has a Settings tab, which applies new settings to it the same way, the cap included.

To stop a ladder, its page offers "Wind down", which lets its lots sell at their targets, or "Close now", which sells them all at the next open. To start a whole account over, reset it in Settings → Accounts. A ladder's statuses explains pausing and stopping.

Each night

On each trading day, after the day's prices load in the evening, at about 8:30 pm New York time, Rungfolio's nightly job runs each practice account's night, every ladder in it together:

  1. If a ladder's ticker split that day, it adjusts the ladder for the split (stock splits).

  2. It fills the orders that were working that day, from the day's 1-minute bars, by cautious rules:

    A buy spends practice cash, and a sale brings it back, minute by minute across the account's ladders. No fees are charged.

  3. It checks each ladder's safety net against the day's close.

  4. It plans the next session's orders from that close, ladder by ladder in priority order, under the account's shared cap, and counts them as placed.

  5. It records the account's value, capital in use and profit and loss.

A rung whose sell fills during the day is re-armed by that night's plan, as the nightly routine would do it.

An account's night waits until every one of its tickers has the day's prices, since its ladders share one pot of cash. Home names a ticker that's late. After 3 sessions with none, its ladders are set aside, and the account's nights run on without them.

If a ladder's settings no longer pass Rungfolio's checks, the job pauses the ladder: its buys are canceled and its sells keep working, but nothing is planned until new settings arrive. Home shows a note saying so.

If you add a ladder, apply settings, or pause, resume, move or stop one after the evening's run, it still gets a plan before the next open: the job plans again from 8:00 to 9:15 am New York time. A pause, stop or move made after the close, before the evening's run, takes effect from the next session: the run still fills an order that traded through that day, and a buy that fills brings back its lot's sell (a ladder's statuses). A replaced ladder's working orders are canceled at once, and the new ladder begins working at the next session. Applying settings leaves the day's working orders in place: the settings take effect from the next plan.

Home

Home shows one account at a time, with a switcher when you have more than one: the account's value and its change, its capital in use and tonight's planned buys against the shared cap, a row for each ladder, last night's fills with a "why?" for each, and tonight's orders. Each ladder's page has its price chart, with the lots it holds.

Time away

If no one in your workspace visits Rungfolio for 30 days, the nightly job stops running your accounts. When you come back, Home says the account is catching up, and the job replays every night you missed, in order, so the record has no gaps. A night that couldn't run, such as one when a ticker's prices came late, is caught up the same way.

Splits

If a ladder's ticker splits, the ladder adjusts by itself on the day the split takes effect, before that day's fills: its lots, prices, orders and settings move to the new terms. A split reported after that night has run still adjusts a ladder you paused, or one winding down or closing, by itself. Only a ladder that's active, or that Rungfolio paused, waits for you, with an "Adjust for the split" button on the ladder's page. One that has never had an order is paused for its settings instead, until you apply settings in the split's new prices. Stock splits has the details.

What isn't simulated

Some things aren't simulated. What the simulator doesn't model lists them, so you know where a practice result can differ from a real one.

Live mode

A live account follows a brokerage account you hold, at any broker (live accounts and your broker's rules). You add it in Settings → Accounts, with a name, a capital cap, and four of your broker's rules: how long a GTC order lasts, whether a buy can trigger its sell, the commission per order, and whether the cash available to trade it shows already leaves out your open buys. It has no starting cash: you type its cash and value each evening.

Starting a live ladder

A live ladder starts from the same new-ladder preview, with "Start live" for a live account. Before it starts, a confirmation says it plainly: you place every order yourself, at your broker; nothing is traded for you; and the orders and fills use real money.

If the account already holds shares of the ticker, enter them as the ladder's outside shares. The ladder starts empty and never sells them.

Settings, priority, pause, resume and stop work as they do in practice, one ladder per ticker in each account. "Close now" lists the ladder's lots as sells for you to place: nothing sells by itself.

Each evening

In live mode, Rungfolio plans each night's orders, and you place them at your broker. The nightly run never changes a live account by itself: it only works out which of your placed orders probably filled (likely fills).

Then, in the evening routine, you confirm the day's fills, type the shares and cash your broker shows, and make tonight's list. Your part takes a couple of minutes.

  • Tonight's list stays locked until Rungfolio's share count matches your broker's (the share-count check).
  • Buys are bounded by the cash you entered, as well as the account's cap.
  • An exit from the price floor needs its own confirmation.
  • An order counts as working only once you mark it placed.

A split, an order that expired and a ticker that stopped trading are never handled by themselves on a live ladder: the evening form asks what your broker did (splits, expiry and stopped tickers).

Its record

A live account's value, profit and loss and Journal come from the fills you confirm, with their commissions, and from the cash and value you enter. Since its value is your broker's, deposits and withdrawals count in its return. Practice accounts and backtests are unchanged.

Why you place orders yourself

Rungfolio never places a trade, at any broker, so you place each order yourself. It doesn't connect to your brokerage account, and it never asks for or stores your account number, your broker login or your password.

Educational software, not investment advice.