# Holdings & Market Value

## Positions

Each account has a `positions` array containing the fund holdings.

```json
{
  "$ref": "#/components/schemas/positions",
  "components": {
    "schemas": {
      "positions": {
        "type": "array",
        "description": "List of positions held",
        "items": {
          "type": "object",
          "properties": {
            "instrument": {
              "type": "string",
              "description": "Instrument identifier"
            },
            "units": {
              "type": "number",
              "description": "Number of units, including unsettled."
            },
            "unitsSettled": {
              "type": "number",
              "description": "Number of units settled"
            },
            "value": {
              "type": [
                "number",
                "null"
              ],
              "description": "The total value of the position (units * closePrice)"
            },
            "closePrice": {
              "type": [
                "number",
                "null"
              ],
              "description": "Last published NAV (closing price) for the fund"
            },
            "gav": {
              "type": "number",
              "description": "Average acquisition value (Genomsnittligt Anskaffningsvärde)"
            }
          }
        }
      }
    }
  }
}
```

## Total account market value

To display a complete account value — including cash and pending orders — use this formula:

```
Total Account Market Value = Balance + Settled position value + Pending subscription amounts
```

**Definitions:**

- **Balance** — Snapshot of settled cash on the account.
- **Settled position value** — Total market value of settled fund positions: `Σ(unitsSettled × closePrice)` per fund.
- **Pending subscription amounts** — Cash allocated to subscription orders that haven't settled into fund units yet.
- **Pending redemption units** — Units instructed to redeem but not yet settled; value them at `closePrice`.


**Example:**

- Balance: 25,000 SEK
- Settled position value: 80,000 SEK
- Pending subscription orders (amount): 10,000 SEK
- Pending redemption orders: 1,000 units of Fund A
- Last close Fund A: 100


```
Total = 25,000 + 80,000 + 10,000 + (1,000 × 100) = 215,000 SEK
```