REST 接口 · 文档目录

美股 Form 3 初始持股申报 · REST 接口

Form 3 初始持股申报。获取 SEC Form 3 申报文件,报告公司内部人(董事、高管及持股 10% 以上股东)首次持有的证券权益。当内部人首次适用第 16 条报告义务时,这些申报文件确立了其持股基数。

GET /stocks/filings/vX/form-3
上游时效说明

每日更新

上游历史范围

该接口不适用

适用场景

  • 跟踪新增内部人持仓、监控高管与董事持股、大股东尽职调查、构建持股数据库、合规检查。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。

查询参数

参数类型必填说明
issuer_cikstringNo发行公司的 SEC 中央索引键(CIK),10 位、左侧补零。
issuer_cik.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
owner_cikstringNo申报所有人的 SEC 中央索引键(CIK),10 位、左侧补零。
owner_cik.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
tickersstringNo筛选数组包含该值的结果。
tickers.all_ofstringNo筛选数组包含全部给定值的结果。多个值可用逗号分隔的列表指定。
tickers.any_ofstringNo筛选数组包含任一给定值的结果。多个值可用逗号分隔的列表指定。
form_typestringNoSEC 表单类型(3 为首次申报,3/A 为修订申报)。
filing_datestringNo申报文件提交至 SEC 的日期(格式 YYYY-MM-DD)。值格式须为 yyyy-mm-dd。
filing_date.gtstringNo筛选大于该值。值格式须为 yyyy-mm-dd。
filing_date.gtestringNo筛选大于或等于该值。值格式须为 yyyy-mm-dd。
filing_date.ltstringNo筛选小于该值。值格式须为 yyyy-mm-dd。
filing_date.ltestringNo筛选小于或等于该值。值格式须为 yyyy-mm-dd。
limitintegerNo限制返回结果的最大数量。未指定时默认为 100,允许的最大值为 10000。
sortstringNo逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 filing_date,排序方向默认为 desc。

响应字段

字段类型说明
next_urlstring若存在,可用该值获取下一页数据。
request_idstring服务器分配的请求 ID。
resultsarray[object]本次请求的结果。
results[].accession_numberstring该申报文件的唯一 SEC 归档编号(如 0001209191-25-012345)。
results[].aff_10b5_oneboolean该交易是否依据 10b5-1 规则交易计划执行。
results[].date_of_original_submissionstring修订类申报(3/A)对应的原始申报提交日期;首次申报时为空(格式为 YYYY-MM-DD)。
results[].direct_or_indirectstring持股为直接(D)还是间接(I)。
results[].exercise_datestring衍生证券的可行使日期(格式 YYYY-MM-DD)。
results[].exercise_pricenumber衍生证券的行权价或转换价,单位为 USD。
results[].filing_datestring申报文件提交至 SEC 的日期(格式 YYYY-MM-DD)。
results[].filing_urlstringSEC EDGAR 网站上该文件的直达链接。
results[].footnotesarray[object]申报文件中与本行相关的脚注列表,每条包含 id 与说明。
results[].form_typestringSEC 表单类型(3 为首次申报,3/A 为修订申报)。
results[].is_directorboolean报告义务人是否为发行人的董事。
results[].is_officerboolean报告义务人是否为发行人的高管。
results[].is_otherboolean报告义务人是否与发行人存在其他关系。
results[].is_ten_percent_ownerboolean报告义务人是否持有一类权益证券的 10% 或以上。
results[].issuer_cikstring发行公司的 SEC 中央索引键(CIK),10 位、左侧补零。
results[].issuer_namestring申报文件中报告的发行公司名称。
results[].nature_of_ownershipstring间接持股的性质(如 By Trust、By Spouse)。
results[].not_subject_to_section_16boolean报告义务人是否不受《证券交易法》第 16 条约束。
results[].officer_titlestring高管职务名称(若报告义务人为高管)。
results[].owner_cikstring申报所有人的 SEC 中央索引键(CIK),10 位、左侧补零。
results[].owner_namestring报告义务人的名称(个人或机构)。
results[].period_of_reportstring触发该申报的事件的日期(格式 YYYY-MM-DD)。
results[].remarksstring申报文件中包含的补充备注。
results[].security_titlestring证券的标题或说明(如 Common Stock、Stock Option)。
results[].security_typestring证券类型(non-derivative 或 derivative)。
results[].shares_ownednumber实益持有的股份数量。
results[].tickersarray[string]发行公司的股票代码列表。多个代码可能代表不同的股份类别。
results[].underlying_security_sharesnumber衍生品持仓对应的底层标的股份数量。
results[].underlying_security_titlestring衍生品持仓对应的底层标的证券名称。
statusenum: OK本次请求响应的状态。

响应示例

{
  "count": 1,
  "next_url": "https://api.massive.com/stocks/filings/vX/form-3?cursor=eyJsaW1pd...",
  "request_id": "047c7035a86042b1925118e5f68d81b0",
  "results": [
    {
      "accession_number": "0001628280-26-022046",
      "aff_10b5_one": null,
      "date_of_original_submission": null,
      "direct_or_indirect": "D",
      "exercise_date": null,
      "exercise_price": null,
      "filing_date": "2026-03-30",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/1903508/0001628280-26-022046.txt",
      "footnotes": [
        {
          "description": "The options granted on May 17, 2022 vested 100% on the third anniversary of the grant date.",
          "id": "F1"
        },
        {
          "description": "The exercise price of the options granted on May 17, 2022 was GPB 8.85, or approximately $11.80 based on a GBP to USD exchange rate as of March 27, 2026 of 1.3336.",
          "id": "F2"
        }
      ],
      "form_type": "3",
      "is_director": false,
      "is_officer": true,
      "is_other": false,
      "is_ten_percent_owner": false,
      "issuer_cik": "0001903508",
      "issuer_name": "Public Policy Holding Company, Inc.",
      "nature_of_ownership": null,
      "not_subject_to_section_16": null,
      "officer_title": "Chief Administrative Officer",
      "owner_cik": "0002125791",
      "owner_name": "Mazzanti Matthew Ross",
      "period_of_report": "2026-03-20",
      "remarks": null,
      "security_title": "Options",
      "security_type": "derivative",
      "shares_owned": null,
      "tickers": [
        "PPHC"
      ],
      "underlying_security_shares": 9000,
      "underlying_security_title": "Common Stock, $0.001 par value"
    }
  ],
  "status": "OK"
}

原文:Massive 文档 ↗