Fund Equity Book (an ETF or fund equity positions, N-PORT)
fund_equity_bookA fund's / ETF's equity holdings — given a fund SERIES id (S000…), return its equity positions (ticker, issuer, shares, value_usd), ranked by position size, amendment-resolved to the fund's latest N-PORT report. The mirror of fund_equity_holders ('who holds X' ↔ 'what does fund Y hold').
Source: SEC N-PORT-P fund-holdings panel (equity slice), fund-series grain. series_id is the FUND, not the fund family — one registrant (e.g. iShares Trust) files a separate N-PORT per series (iShares Core S&P 500 ETF = one series_id). Find a series_id from fund_equity_holders (each holder row carries it) or a fund's N-PORT.
Caveats: equity slice only (this is the fund's EQUITY book — its bond holdings are in the tranche corp-debt panel, its full book incl. derivatives/other isn't here); as_of is the fund's latest report_date; value_usd is the marked position. Coverage: latest-quarter + ~3.5y history (2022-11 → current); full 6.5y backfill in progress.
The header carries accession + filing_url (the N-PORT for as_of; open with get_filing) and each position its own accession + filing_url (the N-PORT it was read from).
Each fund row carries fund_type from the fund's latest SEC N-CEN: etf, mutual_fund, closed_end, money_market, interval, both (one series with ETF and mutual-fund share classes, e.g. Vanguard Total Stock Market = VTI + VTSAX; share_classes then lists each class with ticker and is_etf_class), other (separate account, UIT), or null when N-CEN doesn't cover the series (e.g. liquidated before filing one).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"series_id": "<series_id>"
},
"name": "fund_equity_book"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max positions (default 100, max 1000), ranked by value_usd desc. | |
| series_id | Yes | Fund series id (S000… — the fund, not the family). Required. | |
| include_preferred | No | Include preferred-stock positions (asset_cat 'EP'). Default true (a fund's full equity book). |