MAmassive
reference

GET /stocks/insiders/vX/holdings

Changed on

Insiders of each issuer: one row per reporting owner per issuer, from every SEC Form 3, 4, and 5 filing, with the shares they hold. Use it to see who the insiders of a company are and how much each owns, or to find the CIK of a director, officer, or 10%+ shareholder and then query the Form 4 endpoint by owner_cik for their filings across issuers. Name, roles, and title reflect the owner's most recent filing for that issuer. Share totals sum the latest reported balance of each of the owner's non-derivative positions (direct holdings and each trust, LLC, or family vehicle); see position_count and oldest_position_date for how fresh the sum is.

Request

  • Base URL
    https://api.massive.com
  • URL
    https://api.massive.com/stocks/insiders/vX/holdings
  • Auth
    API key in query parameter apiKey

Query parameters

tickersstring

Filter for arrays that contain the value.

tickers.all_ofstring

Filter for arrays that contain all of the values. Multiple values can be specified by using a comma separated list.

tickers.any_ofstring

Filter for arrays that contain any of the values. Multiple values can be specified by using a comma separated list.

issuer_cikstring

SEC Central Index Key of the issuer company (10 digits, zero-padded).

issuer_cik.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

owner_cikstring

SEC Central Index Key of the reporting owner (10 digits, zero-padded). Stable across issuers and years; use it to follow a person through the Form 3, 4, and 5 endpoints.

owner_cik.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

last_filing_datestring

Date of the owner's most recent Form 3, 4, or 5 filing for this issuer (formatted as YYYY-MM-DD). Value must be formatted 'yyyy-mm-dd'.

last_filing_date.gtstring

Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.

last_filing_date.gtestring

Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.

last_filing_date.ltstring

Filter less than the value. Value must be formatted 'yyyy-mm-dd'.

last_filing_date.ltestring

Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.

limitinteger

Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '10000'.

sortstring

A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'last_filing_date' if not specified. The sort order defaults to 'desc' if not specified.

Response

A list of results.

next_urlstring

If present, this value can be used to fetch the next page.

request_idstring required

A request id assigned by the server.

status'OK' required

The status of this request's response.

Changes