Positions and Lots¶
Finvee records every trade you make as a combination of two things: a Position and one or more Lots. Understanding the difference between them helps you read your portfolio data accurately and get the most out of the trade history and P&L views.
Positions: the aggregate view¶
A Position is the summary view of one complete trade cycle for a single asset. It answers the questions: how many shares do I hold right now, at what average cost, and what is the current status of this holding?
A position tracks:
- Total shares held — the net quantity currently in the portfolio
- Weighted average cost — the blended cost per share across all your buy transactions
- Status — Open, Partially Closed, or Closed
- Direction — Long or Short
When you buy shares, a position opens. When you partially sell, it becomes Partially Closed. When you sell everything, it closes. A closed position is a permanent historical record — you cannot reopen it. If you buy the same asset again later, Finvee creates a new position for that fresh cycle.
You can hold multiple closed positions in the same asset across time, each representing a distinct trade cycle.
Lots: the individual transaction record¶
A Lot is a record of a single transaction. Every buy, scale-in, partial sell, or full exit creates exactly one lot. Lots are the permanent, immutable audit trail of everything that happened inside a position.
Each lot records:
- Type and direction — whether it was a buy or sell, long or short
- Quantity and price — the original traded amount and execution price (these never change)
- Commission — the brokerage fee for this transaction
- Trade date — the economic date of the transaction, used for cost basis and holding-period calculations
- Notes — freeform text for anything you want to annotate on this specific transaction
- Lot tag — a short label you can assign to group or annotate this lot independently (see below)
Scale-ins: adding to an existing position¶
When you buy additional shares in an asset you already hold, Finvee adds a new lot to the existing open position rather than creating a new position. The position's weighted average cost updates to reflect the blended entry across all your buy lots.
This lot is marked as a scale-in, which lets you filter and analyse your scale-in behaviour separately — for example, to see whether adding to positions at higher prices has helped or hurt your average outcome.
How closes work: FIFO matching¶
When you sell shares, Finvee matches each share sold to a specific buy lot using FIFO (first in, first out) — the oldest buy lots are consumed first.
For each buy-lot / sell-lot pair that gets matched:
- Realised P&L is calculated as
(sell price − buy price) × shares matched - Holding period is the number of days between the buy lot's trade date and the sell lot's trade date
- Short-term or long-term is determined by whether the holding period is under or over 365 days
This matching happens automatically. If a partial sell only consumes part of an older buy lot, that buy lot remains open with a reduced remaining quantity until further sells consume the rest.
Commissions are deducted from your free funds at execution time but are not included in the matched P&L figure — so the P&L shown in lot detail is the gross realised gain or loss before fees.
Lot tags: labelling individual transactions¶
Every lot has a Lot Tag — a short free-text label (up to 80 characters) you can use to annotate and group individual transactions independently of any Trade Idea or position-level notes.
Useful for:
- Labelling scale-in sequences ("Scale-in #1", "Scale-in after breakout confirmation")
- Marking entries tied to a specific setup or event ("Earnings entry", "Sector rotation play")
- Grouping lots across multiple positions that share a common thesis or timing
Lot tags are entirely optional. You can add or edit a tag at any time by clicking the Tag cell in the lot detail table — type your label, then press Enter or click away to save. Press Escape to cancel.
A tag is independent of the linked Trade Idea. It is a personal annotation tool, not a link to another record.
Position status reference¶
| Status | Meaning |
|---|---|
| Open | You hold the full original quantity. No shares have been sold. |
| Partially Closed | Some shares have been sold. Remaining quantity is greater than zero. |
| Closed | All shares have been exited. The position is a historical record. |