Guide

Getting started
Slots
Margins
Flips
Stats
Items
Buy limits
Pausing for trades that aren't flips
Known gaps

Getting started

Install Flip Ledger from the Plugin Hub in the RuneScape client.
Log in. The plugin reads your GE slots straight away and starts a ledger for this character.
Open the panel from the plugin's ribbon icon. It has five tabs: Slots, Margins, Flips, Stats and Items.
Optionally grant the chatAccess and httpAccess permissions. Everything works without them.

Then trade as you normally would. There is nothing to type in: every buy and sell, including partial fills, is picked up from your slots.

Slots

Every GE slot is listed with its item, buy or sell, price, how much has filled and how long since it last changed.

Finished offers are highlighted until you have seen them, and the panel title says "offers completed since you last looked". Anything that finishes while the panel is on screen counts as seen.
Stale slots are marked when they haven't moved for 20 minutes (the "Mark slots stale after" setting). This is only for your information: the plugin never suggests a new price.
Pause / Resume stops tracking flips while you trade for yourself. See pausing.

Margins

When you buy or sell a small amount that fills almost at once, that is a margin check. Its price becomes the item's latest insta-buy or insta-sell price.

The tab shows one row per item with both prices, the margin after tax, ROI, how old each price is and your buy-limit use. The Sort button cycles between margin, ROI, age and name.

Margin is insta-buy minus insta-sell minus the sale tax on the insta-buy price. ROI is that margin over the insta-sell price.
Price ages turn amber after 30 minutes and red after 2 hours, so you can see when a price needs checking again.
Guide (only with httpAccess) shows the RS Wiki's guide price. It is dimmed when the Wiki's data is more than two days old.
Star turns on a button at the end of each row that stars or unstars that item. Press Done when finished. All items switches to your starred items only, and back.

How a margin check is detected

An offer counts as a margin check when it is for 1 item (or up to the "Margin check max quantity" setting) and it fills completely within 10 seconds (the "Margin check fills within" setting).

Margin checks still appear in your flips and still count toward buy limits. By default they are left out of profit; the "Leave margin checks out of profit" setting changes that.

Each sell is paired with your earlier buys of the same item, oldest first. Each pairing is a flip, shown with its quantity, buy and sell price, profit after the GE's 2% sale tax, ROI and how long you held the items. Newest flips come first.

Newer and Older move between pages.
Remove deletes a flip that shouldn't count, such as a trade with a friend. Press Remove, then press that row's button twice. Only the flip is removed; the trades behind it stay in your history.

A sell with no earlier buy (the items were bought before you installed the plugin, or on another device) is listed as "no buy" and never counts as profit.

Stats

Totals for the period you pick with the Period button: this session, the last 24 hours, or all time.

Profit, number of flips, items flipped and ROI (total profit over total spent on buys).
GP per hour: profit over the time between the period's first buy and last sell. It shows "-" until the period spans 5 minutes.
Best and worst items: the best is only shown if it made a profit, the worst only if it lost.
Unsold stock (only with httpAccess): what you still hold, what it cost, and its value at guide price after tax. It is shown beside your profit and never added to it.

A flip belongs to the period its sell is in. A session starts when you log in and ends when you log out or after 30 minutes with no GE activity.

Items

Star the items you flip often and keep a short note on any item, such as "slow above 240". Starred items are marked with a * on the Slots, Margins and Flips tabs.

Type an item's name and press Star to star or unstar it. The name must be an item you have traded, or one already starred or noted, since the client has no item search.
Type a note of up to 60 characters and press Save note. Saving an empty note removes it.

The tab lists every starred or noted item, starred ones first. Stars and notes are shared by all your characters, and clearing a ledger keeps them.

Buy limits

The Margins tab shows how much of each item's 4-hour buy limit you have used and when the window resets. The window starts at your first buy after the previous one expired, and every buy in it counts.

Limits come from the game client. If one is missing or wrong, set your own under Buy-limit overrides. With httpAccess, items the client has no limit for get one from the RS Wiki.

Pausing for trades that aren't flips

Not every trade is a flip. Press Pause on the Slots tab while you buy food or supplies to use, or sell things you gathered. Press Resume when you go back to flipping.

While tracking is paused, new offers are still logged and buys still count toward your buy limits, because the GE counts them too. They never become flips, unsold stock or margin checks, so they stay out of your profit.

What counts is whether tracking was on when you placed the offer. Buy a batch to flip, pause, then sell it, and the sale still counts as a flip. An offer placed while paused stays out of your flips even after you resume.

While paused, the panel's title says "(tracking paused)" in amber so you don't forget. The same switch is in Settings as "Track flips".

Known gaps

Trades the plugin didn't see: offers placed or collected on mobile or another PC are not seen. If you later sell those items here, the sale is listed as "no buy" and earns no profit, since the buy price is unknown.
Fills while you were logged out are picked up when you log back in, but their exact time is unknown, so they are given the login time.
Offers already in your slots when you install the plugin are watched from that point on; what filled before is not counted.
A changed display name starts a new, empty ledger.