Snapshot object

Returned by POST /screener/institutional-holdings (as matches[], with cik and name) and POST /ownership/institutional-holdings/manager-history (as quarters[], without them, plus quarter). One row = one manager × one calendar quarter, after amendments are merged.

cik, name

The filing manager. Screener rows only.

period

Calendar quarter end the report covers.

quarter

Manager-history rows only: the YYYYQn label of period, as taken by the portfolio endpoint; unknown when period is not a calendar quarter end.

filing_date, accession

The filing this quarter's data comes from.

is_combination_report

true = 13F COMBINATION REPORT (the filer also reports holdings managed by other managers), false = 13F HOLDINGS REPORT.

confidential

The quarter carries confidential-treatment holdings.

is_amended

Amendments were merged into this quarter. The full archive is on the portfolio endpoint's quarter header.

unit_multiplier

1, or the whole-quarter unit-correction multiplier applied to the filed values. When it is not 1, unit_multiplier_reason (corrected_error or pre2023_rule) is present; the key is omitted when null.

total_positions_value

Total value of the stock holdings, USD.

total_derivatives_notional

Total notional of the option holdings, USD.

cover_table_value

The cover-page total as filed, verbatim.

positions_count, derivatives_count

Live stock / option rows in the quarter.

portfolio_value_qoq_pct

Quarter-over-quarter change of total_positions_value, percent.

top1_security_pct, top10_security_pct

Portfolio share of the largest / ten largest stock holdings, percent (stock holdings only).

est_turnover

Estimated traded value versus the prior quarter, USD.

activity_counts

Map of row activity → count: NEW, ADD, REDUCE, HOLD, SOLD_OUT, CUSIP_CHANGE.

sec_url

The URL opens the filing's EDGAR index page; see the files listed there for full details.

A quarter with no prior filed quarter to compare against has null portfolio_value_qoq_pct, est_turnover and activity_counts.

Quarters marked confidential in the returned result are also flagged in _warnings.