美股 13-F 持仓披露 · REST 接口

13-F 持仓披露。获取管理资产规模不低于 1 亿美元的机构投资管理人提交的 SEC Form 13-F 季度持仓数据，包含季末的股票持仓、股数、市值、投资决策权与投票权。

GET /stocks/filings/vX/13-F

上游时效说明

每日更新

上游历史范围

该接口不适用

适用场景

跟踪机构持股趋势、复制对冲基金策略、组合重叠分析、激进投资者监控、从聪明钱流向中挖掘思路。

接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。

查询参数

参数	类型	必填	说明
`filer_cik`	string	No	申报主体的 SEC 中央索引键（CIK，10 位、前补零）。
`filer_cik.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`filing_date`	string	No	申报文件提交至 SEC 的日期（格式 YYYY-MM-DD）。值格式须为 yyyy-mm-dd。
`filing_date.gt`	string	No	筛选大于该值。值格式须为 yyyy-mm-dd。
`filing_date.gte`	string	No	筛选大于或等于该值。值格式须为 yyyy-mm-dd。
`filing_date.lt`	string	No	筛选小于该值。值格式须为 yyyy-mm-dd。
`filing_date.lte`	string	No	筛选小于或等于该值。值格式须为 yyyy-mm-dd。
`limit`	integer	No	限制返回结果的最大数量。未指定时默认为 100，允许的最大值为 1000。
`sort`	string	No	逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 filing_date，排序方向默认为 desc。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	本次请求的结果。
`results[].accession_number`	string	该申报文件的唯一 SEC 归档编号（如 0000950123-24-011775）。
`results[].cusip`	string	所持证券的 CUSIP 标识。
`results[].file_number`	string	分配给申报人的 13F 专用文件编号。
`results[].filer_cik`	string	申报主体的 SEC 中央索引键（CIK，10 位、前补零）。
`results[].filing_date`	string	申报文件提交至 SEC 的日期（格式 YYYY-MM-DD）。
`results[].filing_url`	string	SEC EDGAR 网站上该文件的直达链接。
`results[].film_number`	string	该申报文件在 SEC EDGAR 的胶片编号。
`results[].form_type`	string	SEC 表单类型（如 13F-HR 为持仓报告，13F-HR/A 为修订报告）。
`results[].investment_discretion`	string	投资决策权类型。可选值：SOLE（独立）、SHARED（共享）、DFND（已界定）。
`results[].issuer_name`	string	所持证券所属公司的名称。
`results[].market_value`	integer	持仓的市值（美元）。
`results[].other_managers`	array[string]	若适用，列出与申报人共同对所报持仓行使投资决策权的其他管理人名称。
`results[].period`	string	该申报文件所属的季度末日期（格式为 YYYY-MM-DD）。
`results[].put_call`	string	表示该持仓为看跌还是看涨期权。可选值：PUT、CALL，普通股则为空。
`results[].shares_or_principal_amount`	integer	所持股份数量或本金金额。
`results[].shares_or_principal_type`	string	所报数量的类型。可选值：SH（股份）、PRN（本金）。
`results[].title_of_class`	string	所持证券类别的描述（如 COM、CL A）。
`results[].voting_authority_none`	integer	无投票权的股份数量。
`results[].voting_authority_shared`	integer	共享投票权的股份数量。
`results[].voting_authority_sole`	integer	独有投票权的股份数量。
`status`	enum: OK	本次请求响应的状态。

响应示例

{
  "next_url": "https://api.massive.com/stocks/filings/vX/13-F?cursor=eyJsaW1pd...",
  "request_id": "a3f8b2c1d4e5f6g7",
  "results": [
    {
      "accession_number": "0000950123-24-011775",
      "cusip": "023135106",
      "file_number": "028-04545",
      "filer_cik": "0001067983",
      "filing_date": "2024-11-14",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/1067983/0000950123-24-011775.txt",
      "film_number": "241461756",
      "form_type": "13F-HR",
      "investment_discretion": "DFND",
      "issuer_name": "AMAZON COM INC",
      "market_value": 1439212920,
      "other_managers": [
        "Buffett Warren E"
      ],
      "period": "2024-09-30",
      "put_call": null,
      "shares_or_principal_amount": 7724000,
      "shares_or_principal_type": "SH",
      "title_of_class": "COM",
      "voting_authority_none": 0,
      "voting_authority_shared": 0,
      "voting_authority_sole": 7724000
    },
    {
      "accession_number": "0000950123-24-011775",
      "cusip": "025816109",
      "file_number": "028-04545",
      "filer_cik": "0001067983",
      "filing_date": "2024-11-14",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/1067983/0000950123-24-011775.txt",
      "film_number": "241461756",
      "form_type": "13F-HR",
      "investment_discretion": "DFND",
      "issuer_name": "AMERICAN EXPRESS CO",
      "market_value": 311864270,
      "other_managers": [
        "Buffett Warren E"
      ],
      "period": "2024-09-30",
      "put_call": null,
      "shares_or_principal_amount": 1149942,
      "shares_or_principal_type": "SH",
      "title_of_class": "COM",
      "voting_authority_none": 0,
      "voting_authority_shared": 0,
      "voting_authority_sole": 1149942
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗