Portfolio snapshot vs history: why a higher balance is not always a return
Separate a current holdings snapshot from dated records, external cash flows, drawdowns, and annualised return calculations with a worked example.
By HoldingsTracker Pro · Organization author
Product documentation and worked examples for the HoldingsTracker Pro browser extension. No investment recommendations.
Published · Updated
A portfolio snapshot tells you what is present at a selected moment: quantities, marked prices, values, and perhaps remaining purchase costs. Portfolio history records how those quantities, values, and cash flows changed over time. The distinction determines which questions a tool can answer honestly.
“What is my largest holding now?” is a snapshot question. “What was my largest drawdown?” needs a time series. “What did my money earn after several deposits?” needs dated cash flows and a return methodology. A current chart cannot supply missing events merely by looking detailed.
What a snapshot can establish
With reliable quantities and prices, you can calculate current position weights, sector allocation, and gross unrealised P&L against the remaining basis. Record the timestamp and scope: a stock-only view is not the same as stocks plus broker cash, and one account is not the same as household wealth.
Even an automatically refreshed view remains a sequence of current observations unless those observations are deliberately retained. “Live insights” does not necessarily mean exchange-grade real-time data, permanent storage, or a historical return engine.
Worked example: balance growth versus investment gain
Suppose a fictional portfolio, measured as investments plus its cash balance, starts a one-month period at ₹1,00,000. During the month the investor deposits ₹20,000. There are no withdrawals or outside distributions. The ending portfolio value is ₹1,26,000, including remaining cash and after the costs reflected in the balance.
| Reconciliation | Amount |
|---|---|
| Ending value | ₹1,26,000 |
| Less starting value | −₹1,00,000 |
| Less external deposit | −₹20,000 |
| Residual investment gain | ₹6,000 |
The balance rose 26%, but the deposit is not profit. The residual ₹6,000 is the rupee investment gain under the stated assumptions. To reconcile a withdrawal, add it back; to handle an external distribution, include it consistently rather than silently losing it from the boundary.
A percentage return still needs timing. If the ₹20,000 arrived at the very start and remained invested for the whole month, the simplified return is ₹6,000 ÷ ₹1,20,000 = 5%. If it arrived at the very end, with no time to earn a return, the same gain relative to the initially invested ₹1,00,000 is 6%. These are different hypothetical paths with identical start, deposit total, and end values.
Two endpoints cannot reveal the journey
A portfolio might start at ₹1,00,000, fall to ₹70,000, and recover to ₹1,00,000. Another might remain at ₹1,00,000 throughout. The endpoints match, yet the first path experienced a 30% drawdown from its starting peak and the second did not.
Without observations between endpoints, you cannot establish the actual drawdown. Daily records also cannot reveal every intraday movement. State the sampling interval instead of presenting a historical metric with more precision than the records justify.
Annualised measures add further requirements. Money-weighted calculations such as XIRR require dated investor cash flows and an ending valuation. Time-weighted calculations require valuations around flows or a clearly disclosed approximation. A one-month gain percentage should not be relabelled an annual return.
Build useful records deliberately
For a manual history, preserve dated exports, price conventions, external deposits and withdrawals, fees, distributions, and corporate-action notes. Use a stable security identifier so a name change is not mistaken for a new investment. Keep originals separate from edited analysis files.
Zerodha documents holdings reports for selected dates. Its Console product page also describes historical trade breakdowns and reporting. Broker records and user-maintained spreadsheets can support a history workflow; they should not be represented as features automatically supplied by an unrelated extension.
The HoldingsTracker Pro boundary
HoldingsTracker Pro provides current research navigation and portfolio insights in the browser workflow. It has no portfolio-history capability: it does not store a historical holdings series, reconstruct historical allocation, or calculate an account's lifetime return from past transactions. Keeping a page open does not create those capabilities. Preserve dated broker records separately when you need to reconstruct changes over time.
Use help for current product questions and the tracker, spreadsheet, and broker comparison to choose where each record belongs. For open versus closed results, read realised and unrealised P&L. HoldingsTracker Pro is independent of Zerodha. These examples explain measurement limits; they are not investment recommendations or tax advice.
Primary sources
Sources support the broker-specific context. Worked examples use fictional inputs and independent arithmetic, not investment recommendations.