--- title: "A stock or ETF listing's 13F holders split by one dimension, quarter by quarter, oldest first: each bucket's common shares, value and filers, its like-for-like change (only filers with an observed 13F in both quarters, each kept in its bucket of the later quarter on both sides), and new and exited filers. Every dimension's buckets sum to total. Holder type is each filer's current regulatory profile, never its name; client base and private funds come from the Form ADV roster current at the column's quarter end (rosters from December 2019, so an earlier column reads Unknown); style, turnover, horizon and book size are measured from each filer's 13F book in the newest measured quarter on or before the column. A company's primary listing reads its open quarter as the combined view; an ETF series or sibling class reads its exact listing as filed. Shares are restated to today's split basis; options are reported beside them and principal amounts are left out. dimension=fundtype reads registered funds instead: each fund series' latest Form NPORT-P report inside the quarter, bucketed by its Form N-CEN fund type (index fund, index ETF, active ETF, active fund, unclassified), as shares and a percentage of shares outstanding in fundQuarters. Funds sit inside their advisers' 13F reports, so those shares are never added to 13F totals." method: GET path: "/v1/securities/{ticker}/holder-mix" tags: ["Holdings"] --- # A stock or ETF listing's 13F holders split by one dimension, quarter by quarter, oldest first: each bucket's common shares, value and filers, its like-for-like change (only filers with an observed 13F in both quarters, each kept in its bucket of the later quarter on both sides), and new and exited filers. Every dimension's buckets sum to total. Holder type is each filer's current regulatory profile, never its name; client base and private funds come from the Form ADV roster current at the column's quarter end (rosters from December 2019, so an earlier column reads Unknown); style, turnover, horizon and book size are measured from each filer's 13F book in the newest measured quarter on or before the column. A company's primary listing reads its open quarter as the combined view; an ETF series or sibling class reads its exact listing as filed. Shares are restated to today's split basis; options are reported beside them and principal amounts are left out. dimension=fundtype reads registered funds instead: each fund series' latest Form NPORT-P report inside the quarter, bucketed by its Form N-CEN fund type (index fund, index ETF, active ETF, active fund, unclassified), as shares and a percentage of shares outstanding in fundQuarters. Funds sit inside their advisers' 13F reports, so those shares are never added to 13F totals. `GET /v1/securities/{ticker}/holder-mix` ## Request - Base URL: `https://api.equibles.com` - URL: `https://api.equibles.com/v1/securities/{ticker}/holder-mix` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) ## Path parameters - `ticker` string, required ## Query parameters - `dimension` string - `periods` integer ## Response `200` OK - HolderMixResponse: A listing's 13F holders split by one dimension, quarter by quarter, oldest first. - `listingNotice` ListingNotice: What happened to a requested ticker that no longer trades. "delisted": the company has no current US listing, so the answer is its history. "renamed": the company now trades as successorTicker, its current US presentation ticker (possibly another share class). A listed series (short volume, short interest, off-exchange volume, fails-to-deliver, congressional trades) is the retired ticker's own; a company-level read is the company's data. - `status` string, nullable: "delisted" or "renamed". - `ticker` string, nullable: The retired ticker as listed. - `delistedOn` string, date, nullable: The day the retired listing stopped trading, when known. - `successorTicker` string, nullable: For "renamed", the company's current US presentation ticker; null for "delisted". - `ticker` string, nullable: The listed ticker read: the requested ETF series or share class, or the company's primary listing. - `dimension` string, nullable: The dimension token: type, style, turnover, horizon, aum, client, pf, country or fundtype. - `dimensionLabel` string, nullable - `exactListing` boolean: True when the listing is read on its own (an ETF series or a sibling share class), never combined. - `carriedFrom` string, date, nullable: For a combined newest quarter, the quarter whose positions filers yet to file carry; otherwise null. - `quarters` HolderMixQuarterDto[], nullable: The 13F quarters; empty for dimension=fundtype, which fills fundQuarters instead. - `reportDate` string, date - `isCombinedQuarter` boolean: True for the newest quarter while its filing window is open: filers yet to file carry their prior positions. - `measuredQuarter` string, date, nullable: The measured quarter the style, turnover, horizon and book-size bands read (the newest on or before reportDate); null when none is. - `comparisonAvailable` boolean: False when no like-for-like comparison with the quarter before exists, so every like-for-like field is null. - `coverageNote` string, nullable: The filers left out of the like-for-like change (late, first, confidential filers and CIK changes), or null. - `total` HolderMixBucketDto: One bucket of a quarter's 13F holders. Shares are common shares restated to today's split basis; options are reported beside them and principal amounts are left out. - `token` string, nullable: A stable token for the bucket, such as adv, idx or nonus. - `label` string, nullable - `shares` integer - `shareOfTotal` number, double, nullable: This bucket's shares as a fraction (0 to 1) of the quarter's 13F common shares; null when the quarter holds none. - `value` integer: Published position value in dollars: reported shares times the report-date close, the filer's own value as a fallback, or zero when unavailable. - `filers` integer - `likeForLikeCurrentShares` integer, nullable: Shares of filers with an observed 13F in both quarters, this quarter; null without a comparison. - `likeForLikePreviousShares` integer, nullable: The same filers' shares the quarter before; null without a comparison. - `likeForLikeChangePercent` number, double, nullable: Like-for-like change in percent; null without a comparison or when the previous side holds none. - `excludedCurrentShares` integer: Shares of filers with no observed 13F the quarter before, left out of the change. - `excludedPreviousShares` integer: Shares the quarter before of filers with no observed 13F this quarter, left out of the change. - `newFilers` integer: Compared filers that opened a common-share position this quarter. - `exitedFilers` integer: Compared filers that closed their common-share position this quarter. - `callShares` integer: Underlying shares of reported call positions. - `callValue` integer - `putShares` integer: Underlying shares of reported put positions. - `putValue` integer - `activeHolders` HolderMixBucketDto: One bucket of a quarter's 13F holders. Shares are common shares restated to today's split basis; options are reported beside them and principal amounts are left out. - `token` string, nullable: A stable token for the bucket, such as adv, idx or nonus. - `label` string, nullable - `shares` integer - `shareOfTotal` number, double, nullable: This bucket's shares as a fraction (0 to 1) of the quarter's 13F common shares; null when the quarter holds none. - `value` integer: Published position value in dollars: reported shares times the report-date close, the filer's own value as a fallback, or zero when unavailable. - `filers` integer - `likeForLikeCurrentShares` integer, nullable: Shares of filers with an observed 13F in both quarters, this quarter; null without a comparison. - `likeForLikePreviousShares` integer, nullable: The same filers' shares the quarter before; null without a comparison. - `likeForLikeChangePercent` number, double, nullable: Like-for-like change in percent; null without a comparison or when the previous side holds none. - `excludedCurrentShares` integer: Shares of filers with no observed 13F the quarter before, left out of the change. - `excludedPreviousShares` integer: Shares the quarter before of filers with no observed 13F this quarter, left out of the change. - `newFilers` integer: Compared filers that opened a common-share position this quarter. - `exitedFilers` integer: Compared filers that closed their common-share position this quarter. - `callShares` integer: Underlying shares of reported call positions. - `callValue` integer - `putShares` integer: Underlying shares of reported put positions. - `putValue` integer - `buckets` HolderMixBucketDto[], nullable - `token` string, nullable: A stable token for the bucket, such as adv, idx or nonus. - `label` string, nullable - `shares` integer - `shareOfTotal` number, double, nullable: This bucket's shares as a fraction (0 to 1) of the quarter's 13F common shares; null when the quarter holds none. - `value` integer: Published position value in dollars: reported shares times the report-date close, the filer's own value as a fallback, or zero when unavailable. - `filers` integer - `likeForLikeCurrentShares` integer, nullable: Shares of filers with an observed 13F in both quarters, this quarter; null without a comparison. - `likeForLikePreviousShares` integer, nullable: The same filers' shares the quarter before; null without a comparison. - `likeForLikeChangePercent` number, double, nullable: Like-for-like change in percent; null without a comparison or when the previous side holds none. - `excludedCurrentShares` integer: Shares of filers with no observed 13F the quarter before, left out of the change. - `excludedPreviousShares` integer: Shares the quarter before of filers with no observed 13F this quarter, left out of the change. - `newFilers` integer: Compared filers that opened a common-share position this quarter. - `exitedFilers` integer: Compared filers that closed their common-share position this quarter. - `callShares` integer: Underlying shares of reported call positions. - `callValue` integer - `putShares` integer: Underlying shares of reported put positions. - `putValue` integer - `fundQuarters` FundOwnershipQuarterDto[], nullable: For dimension=fundtype only: registered funds' Form NPORT-P positions by Form N-CEN fund type, oldest first. Absent for the 13F dimensions. - `reportDate` string, date - `indexShares` integer: Index funds' and index ETFs' shares, restated onto today's split basis. - `indexPercentOfSharesOutstanding` number, double, nullable: indexShares as a percentage (0-100) of today's shares outstanding; null without a share count or split basis. - `splitUnresolved` boolean: True when a split after the quarter cannot be attributed, so percentages are withheld. - `total` FundOwnershipBucketDto: Registered funds of one N-CEN fund type and what they held of a listing in one quarter. - `token` string, nullable: idxfund, idxetf, actetf, actfund, unclassified, or all for the total. - `label` string, nullable - `shares` integer: Shares held, restated onto today's split basis. - `value` number, double: Market value in dollars as the funds reported it. - `seriesCount` integer: Fund series holding the listing. - `percentOfSharesOutstanding` number, double, nullable: shares as a percentage (0-100) of today's shares outstanding; null without a share count or split basis. - `oldestReportPeriod` string, date, nullable: The oldest and newest portfolio dates of the reports read. - `newestReportPeriod` string, date, nullable - `buckets` FundOwnershipBucketDto[], nullable: Index funds, index ETFs, active ETFs, active funds and unclassified, in that order. - `token` string, nullable: idxfund, idxetf, actetf, actfund, unclassified, or all for the total. - `label` string, nullable - `shares` integer: Shares held, restated onto today's split basis. - `value` number, double: Market value in dollars as the funds reported it. - `seriesCount` integer: Fund series holding the listing. - `percentOfSharesOutstanding` number, double, nullable: shares as a percentage (0-100) of today's shares outstanding; null without a share count or split basis. - `oldestReportPeriod` string, date, nullable: The oldest and newest portfolio dates of the reports read. - `newestReportPeriod` string, date, nullable ## Other responses - `400`: Bad Request - `404`: Not Found ## Changes - **2026-11-06** `666e06778588`: 1 info - endpoint added [Operation history](https://skmtc.dev/equibles/apis/equibles-api/changes/v1/securities/:ticker/holder-mix/get.md) --- [API](https://skmtc.dev/equibles/apis/equibles-api.md) - [All operations](https://skmtc.dev/equibles/apis/equibles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equibles/apis/equibles-api/revisions/713a3e840323?raw)