Portfolio Management
A consolidated view of your investments — holdings, positions, cash and performance — derived from the underlying modules. Portfolio Management reports; it never trades.
Portfolio overview, P&L analytics, Performance & attribution, Holdings & cash, Capital allocation.
Purpose
Your portfolio value, invested value, realised and unrealised P&L and allocation are computed on read from positions, trades and market data. When live quotes are available the portfolio marks to market; without them it falls back to cost basis and flags that unrealised P&L is unknown.
Portfolio Management does not create orders or calculate positions independently — it aggregates what the trading modules produce, so the numbers always reconcile.
The Portfolio Management module provides a consolidated business view of a user's investments, trading positions, holdings, cash balances and overall portfolio performance.
It aggregates information from multiple business modules to present the current financial state of the portfolio without performing trade execution or risk enforcement.
The module serves as the single source of truth for portfolio-level information.
Objectives
The module will:
- Consolidate trading and investment assets.
- Present portfolio valuation.
- Measure portfolio performance.
- Track realised and unrealised gains.
- Monitor capital allocation.
- Support portfolio analytics.
- Maintain complete portfolio history.
Functional Scope
The module includes:
- Portfolio Definition
- Portfolio Consolidation
- Portfolio Valuation
- Cash Management
- Holdings Management
- Position Aggregation
- Performance Measurement
- Allocation Analysis
- Portfolio History
- Portfolio Analytics
Portfolio Model
A portfolio represents the complete financial position of a user.
The portfolio will consolidate information from:
- Holdings
- Trading Positions
- Cash Balances
- Broker Accounts
The Portfolio Management module does not execute trades or calculate positions independently.
Portfolio Consolidation
The platform will consolidate assets across all configured broker accounts.
Consolidated information includes:
- Equity Holdings
- Futures Positions
- Options Positions
- Cash Balances
- Margin Balances
Consolidation will preserve broker-level information while presenting an aggregated business view.
Portfolio Valuation
The platform will continuously calculate portfolio value.
Portfolio valuation includes:
- Current Market Value
- Invested Value
- Cash Value
- Total Portfolio Value
Portfolio valuation will update as market prices and trading activity change.
Cash Management
The portfolio will maintain cash-related information.
Typical information includes:
- Available Cash
- Blocked Funds
- Utilised Margin
- Available Margin
- Realised Cash Balance
Cash information is consolidated across broker accounts where applicable.
Holdings Management
The portfolio will maintain long-term investment holdings.
Holding information includes:
- Instrument
- Quantity
- Average Cost
- Current Market Value
- Unrealised Profit & Loss
Holdings remains separate from active trading positions.
Position Aggregation
The platform will aggregate information received from the Position Management module.
Aggregated information may include:
- Open Positions
- Closed Positions
- Net Exposure
- Running Profit & Loss
Portfolio Management does not modify underlying position records.
Performance Measurement
The platform will calculate portfolio performance.
Typical performance measures include:
- Total Return
- Realised Profit & Loss
- Unrealised Profit & Loss
- Daily Profit & Loss
- Portfolio Growth
The platform remains extensible for additional performance metrics.
Capital Allocation
The platform will present capital allocation across investments.
Typical allocation categories include:
- Asset Class
- Broker
- Strategy
- Sector
- Instrument
Allocation reporting will support both absolute values and percentages.
Portfolio Analytics
The platform will provide analytical information about the portfolio.
Typical analytics include:
- Asset Distribution
- Portfolio Composition
- Capital Deployment
- Profit Contribution
- Position Contribution
The analytics framework will support future expansion.
Portfolio History
Historical portfolio information is preserved.
History includes:
- Daily Valuation
- Historical Holdings
- Historical Positions
- Historical Performance
Historical records remains immutable.
Portfolio Search
You can search and filter portfolio information.
Typical filters include:
- Broker
- Instrument
- Asset Class
- Strategy
- Date Range
Portfolio Ownership
Every portfolio will belong to a user within the current application deployment.
Portfolio ownership remains associated with all historical records.
Business Rules
- Every portfolio will belong to one application deployment.
- Portfolio information is derived from underlying business modules.
- Portfolio Management does not create orders.
- Portfolio Management does not calculate positions independently.
- Portfolio valuation will update automatically.
- Historical portfolio information will never be deleted.
- Portfolio analytics does not modify transactional records.
- Holdings and trading positions remains logically distinct.
Audit Requirements
The platform will maintain an audit trail for portfolio-related activities.
Audit events includes:
- Portfolio Creation
- Portfolio Valuation Updates
- Cash Balance Updates
- Holdings Updates
- Portfolio Reconciliation
- Historical Snapshot Generation
Audit records remains immutable.
Out of Scope
The following are outside the scope of this module:
- Order Management
- Strategy Execution
- Broker Connectivity
- Risk Validation
- Position Calculation
- Historical Backtesting
These responsibilities belong to their respective business modules.
Costs, and whose costs they are
Two different deductions are easy to conflate. The broker’s own transaction costs are what the broker charges to execute; a fund manager’s brokerage is a separate fee on a managed account. Net P&L accounts for them separately because they answer to different people.
- A rate can be expressed as a percentage or as a fraction, and treating one as the other is wrong by a factor of a hundred. Worth confirming which a figure is before reasoning about it.
- Managed-account P&L reports closed trades, matched first-in-first-out, with expiries settled rather than left open. An open position is not in it, so it is not the account’s current value.