Institutional Holdings API

Parameters

• cik  required*

  Manager SEC Central Index Key (e.g. 1067983). *Either cik or manager_name is required.

• manager_name  optional

  Exact manager name (alternative to cik).

• period  optional

  Quarter-end date (YYYY-MM-DD). Defaults to the latest quarter; free tier is limited to the most recent quarter.

• ticker / cusip  optional

  Filter the portfolio to a single holding.

• put_call  optional

  put or call to filter option positions.

• min_value / max_value  optional

  Filter by reported market value (USD).

• sort  optional

  value (default), shares, percent_of_portfolio, or issuer_name.

• change_type  optional premium

  Comma-separated QoQ filter: new, sold_out, increased, decreased, unchanged. Business/Professional/annual only.

• group_by  optional premium

  sector for a sector-allocation rollup. Business/Professional/annual only.

• limit / offset  optional

  Pagination. limit default 50, max 1000.

Headers

• X-Api-Key  required

  API Key associated with your account.

Response

A JSON array of holding records, or an error if the request is unsuccessful. Fields marked premium return an upgrade prompt for free-tier requests.

• manager_name

  Institutional manager (filer) name.

• cik

  Manager Central Index Key (zero-padded to 10 digits).

• period

  Quarter-end date of the report (YYYY-MM-DD).

• filing_date

  Date the 13F was filed with the SEC.

• issuer_name

  Name of the security's issuer.

• ticker

  Ticker symbol, mapped from the reported CUSIP where available.

• cusip

  CUSIP as reported in the filing.

• security_class

  Title of class (e.g. COM).

• shares / share_type

  Shares (or principal amount) held, and SH/PRN.

• market_value

  Reported market value in whole U.S. dollars.

• percent_of_portfolio

  Position value as a percent of the manager's total 13F portfolio.

• put_call

  Put, Call, or null for a long position.

• investment_discretion

  SOLE, DFND, or OTR.

• voting_authority_sole / _shared / _none

  Shares over which the manager has sole, shared, or no voting authority.

• is_new premium

  true if the manager opened this position in the reported quarter.

• share_change / share_change_percent premium

  Change in shares held versus the prior quarter.

• sec_filing_url

  Link to the filing index on SEC EDGAR.

• last_updated

  Unix timestamp (UTC) of the last record refresh.

Parameters

• ticker  required*

  Ticker symbol (e.g. AAPL). *Either ticker or cusip is required.

• cusip  optional

  9-character CUSIP (alternative to ticker).

• period  optional

  Quarter-end date (YYYY-MM-DD). Defaults to the latest; free tier is limited to the most recent quarter.

• summary  optional premium

  true returns the concentration aggregate instead of the holder list. Business/Professional/annual only.

• put_call  optional

  put or call; long positions are returned by default.

• min_value / min_shares  optional

  Minimum market value (USD) / minimum shares held.

• sort  optional

  value (default), shares, or manager_name.

• limit / offset  optional

  Pagination. limit default 50, max 1000.

Headers

• X-Api-Key  required

  API Key associated with your account.

Response

A JSON array of holder records (default):

• manager_name / cik

  Institution holding the security and its Central Index Key.

• ticker / cusip / issuer_name

  The security being held.

• period

  Quarter-end date of the report.

• shares / market_value

  Shares held and reported market value (whole USD).

• percent_of_portfolio

  Position as a percent of the manager's 13F portfolio.

• put_call

  Put, Call, or null.

• filing_date / sec_filing_url

  Filing date and EDGAR link.

With summary=true, a single aggregate object instead:

• institutional_holders_count

  Number of institutions holding the stock this quarter.

• total_shares_held / total_market_value

  Aggregate across all institutional holders.

• new_positions_count / closed_positions_count

  Holders opening / fully exiting this quarter.

• increased_positions_count / decreased_positions_count

  Holders adding / trimming this quarter.

• net_share_change

  Net share change across holders vs the prior quarter.

• holders_count_change

  Change in holder count vs the prior quarter.

Parameters

• name  optional

  Substring search of institution names; returns directory records.

• cik  optional

  Returns that institution's filing history — one record per quarter.

• period  optional

  Quarter-end date (YYYY-MM-DD); returns every institution that filed for that quarter.

• period_list  optional

  true enumerates the available quarters with filing counts.

• limit / offset  optional

  Pagination. limit default 50, max 1000.

Headers

• X-Api-Key  required

  API Key associated with your account.

Response

Directory records (when searching by name):

• manager_name / cik

  Institution and its Central Index Key.

• latest_period / latest_filing_date

  Most recent quarter reported and the date it was filed.

• num_holdings / portfolio_value

  Holdings count and total portfolio value of the latest filing.

• first_period

  Earliest quarter on file for the institution.

Filing records (by cik or period):

• manager_name / cik / period / filing_date

  Who filed, for which quarter, and when.

• form_type / is_amendment / amendment_type

  13F-HR or 13F-HR/A, plus amendment details.

• num_holdings / portfolio_value

  Holdings count and total value of the filing.

• accession_number / sec_filing_url

  SEC accession number and the EDGAR filing link.

Quarter records (with period_list=true): quarter, period, and filing_count.

Parameters

• mover_type  optional

  new_buys (default), exits, adds, or trims.

• period  optional

  Quarter-end date (YYYY-MM-DD); defaults to the latest quarter.

• cik  optional

  Rank the moves within a single institution instead of market-wide.

• limit  optional

  Number of ranked rows to return. Default 50, max 1000.

Headers

• X-Api-Key  required

  API Key associated with your account.

Response

A ranked JSON array. Market-wide rows include:

• period / mover_type

  The quarter and the type of move.

• ticker / cusip / issuer_name

  The security.

• managers_adding / managers_exiting / managers_trimming

  Count of institutions making this move (the field name reflects the mover_type).

• aggregate_share_change / aggregate_value_change

  Summed share and value change across those institutions.

• rank

  Position on the leaderboard.

When cik is supplied, each row is one position with ticker, cusip, issuer_name, share_change, share_change_percent, market_value, prior_market_value, and rank.