---
title: "Top-N cohort holdings within a 9-box style cell"
method: GET
path: "/funds/style/{slug}/holdings"
tags: ["Funds"]
---

# Top-N cohort holdings within a 9-box style cell

`GET /funds/style/{slug}/holdings`

## Request

- Base URL: `https://riskmodels.app/api`
- URL: `https://riskmodels.app/api/funds/style/{slug}/holdings`
- Auth: HTTP bearer

Top-N cohort holdings at the latest teo. Reads `weight (teo, symbol, weighting)` and `contribution_*` / `n_funds_holding` from Slice 5b's per-cell `ds_symbols.zarr`. Sorted by `weight` descending.

`?weighting` defaults to `mv` (market-cap-weighted, Morningstar- comparable). Switch to `ew` to see equal-weight cohort exposures — radically different top-N lists for non-uniform cells.

## Path parameters

- `slug` string, required

## Query parameters

- `weighting` 'ew' | 'mv'
- `limit` integer

## Response `200`

Top-N cohort holdings snapshot.

- CohortHoldingsResponse: Top-N cohort holdings at the latest teo for the chosen weighting.
  - `equity_style_9box` string, required
  - `slug` string, required
  - `teo` string, date, required
  - `weighting` 'ew' | 'mv', required
  - `n_returned` integer, required
  - `n_total_holdings` integer, required
  - `holdings` CohortHolding[], required
    - `bw_sym_id` string, required: Internal symbol id. Resolve to ticker via POST /api/data/symbols/batch with {"symbols": [...]}.
    - `weight` number, float, required: Cohort weight at this teo (sums to 1.0 within the chosen weighting).
    - `contribution_gross` number, float, nullable
    - `contribution_market` number, float, nullable
    - `contribution_sector` number, float, nullable
    - `contribution_subsector` number, float, nullable
    - `contribution_idiosyncratic` number, float, nullable
    - `n_funds_holding` integer, nullable: Number of funds in the cell holding this symbol.

## Other responses

- `400`: Invalid slug, weighting, or limit.
- `402`: Insufficient prepaid balance.
- `404`: No cohort holdings panel available.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/riskmodels/apis/riskmodels-api.md) · [All operations](https://skmtc.dev/riskmodels/apis/riskmodels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/riskmodels/apis/riskmodels-api/revisions/1a034cad408a?raw)