# Holdings

The Holdings module records the underlying securities and positions that sit inside each portfolio (Model Code). It acts as the operational layer that translates portfolio target allocations into real, dated exposures that can be tracked, audited, and reported.

#### Key Concepts

* Model Code (Portfolio)

  Each holding is tied to a specific Model Code, representing the parent portfolio or strategy. This ensures that holdings data is always contextualised within a portfolio structure.
* Instrument Linkage

  Holdings reference investment instruments (securities, funds, benchmarks, cash positions) from the Investments library. Codes (APIR, ticker, ISIN, or custom IDs) provide consistency across portfolios and reports.
* Entity Relationship
  * Entity → Portfolio (Model Code) → Holdings
  * Investments → Holdings

    Entities own or manage portfolios, portfolios are defined by model codes, and holdings store the actual security-level exposures that can be measured against targets or benchmarks.

#### Structure

```
/Entity  
 └── Portfolio (Model Code)  
      └── Holdings  
           └── Investments (securities, funds, benchmarks, cash)  
```

#### Top Menu

* All – Shows the complete dataset of holdings across both synced and custom sources.
* Synced – Holdings generated automatically from Data Workflows, Database Connections, Pipelines, or platform integrations managed by Quant Reports.
* Custom – Holdings that have been manually uploaded through a validation process, allowing flexibility for bespoke or unlisted assets.
* Upload – Tool for importing holdings into the system, applying validation rules to ensure structure and consistency.
* Delete – Allows removal of Custom Uploaded holdings. Synced holdings cannot be deleted here, as they are governed by integration logic.

#### Functionality

* Filtering & Exporting

  Users can filter holdings by model code, platform, or date range, and export data for external use.
* Audit & Version Control

  Holdings are stored with effective dates, creating a time-series of exposures that can be rolled forward or audited historically.
* Usage Across Modules
  * Portfolios: Holdings provide the live weights and exposures for reporting.
  * Reports: Factsheets, quarterly reports, and committee packs draw directly on holdings to show current positions.
  * Compliance: Holdings are checked against rules (neutral/min/max ranges, force overrides).