Form 13F Filings Dates13F申报日期查询
该接口返回机构投资者提交 Form 13F 申报的日期，便于按季度跟踪机构的股票持仓与投资动向，理解其投资策略，可直接用于机构重仓股穿透、聪明钱调仓方向追踪与机构抱团集中度分析。
https://quote-fmp.com/stable/institutional-ownership/dates?cik=0001067983数据更新周期
1-2 Hours
接口说明
- 机构动向监控：跟踪机构投资者何时向 SEC 申报其股票持仓，传入
cik后可解析出year（年份）、quarter（季度） 等字段，适合作为回测框架的基础数据层。 - 季度对比分析：查看机构持仓在不同季度间的变化，围绕
year（年份）与quarter（季度） 等字段，可在回测中还原历史任意时点的真实截面。 - 历史研究：分析多年来的申报规律，发现机构持股的趋势，实务中常与同模块的「机构持股申报」联合调用，先做广度筛查再下钻单标明细。
- 上下游关联接口：Positions Summary（机构持仓汇总） · Industry Performance Summary（细分行业表现汇总） · Company Profile Data（公司概况） · SEC Filings By CIK（按 CIK 查 SEC 申报）
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
cik | string | 必填 | 0001067983 | SEC Central Index Key（CIK）编号，用于定位公司 SEC 主体（须传补足前导零的 10 位定长字符串，如 "0000320193"，切勿传整型） |
调用代码示例
Python 关键代码从 /stable/institutional-ownership/dates 同步13F申报日期查询（必填 cik），一次拿齐 year（年份）、quarter（季度）、date（日期）（样本值 year=2026）。
resp = requests.get(
"https://quote-fmp.com/stable/institutional-ownership/dates",
params={"cik": "0001067983", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 year（年份）
df["year"] = pd.to_numeric(df["year"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按 10 位 CIK（0001067983）检索13F申报日期查询 | cik=0001067983 | 向 /stable/institutional-ownership/dates 传补零 10 位 cik=0001067983，获取 year、quarter、date（样本 year=2026）。 |
| 切换代表性机构/主体（cik=0000320193）对比13F申报日期查询 | cik=0000320193 | 改传 cik=0000320193 调用 /stable/institutional-ownership/dates，横向比较不同 SEC 申报主体的 year、quarter、date。 |
针对 /stable/institutional-ownership/dates（13F申报日期查询，必填 cik），返回首行的 year 为 2026、quarter 为 1；入库前请先拦截 200 [] 空响应。
持久化 /stable/institutional-ownership/dates（13F申报日期查询）的 3 个字段时，自然键取 (cik, date)；数值列 year（样本 2026）切勿用整型截断小数精度。
返回数据
3 个字段本接口示例响应共包含 3 个字段（数值型 2 个，文本/日期/布尔型 1 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
date | string | "2026-03-31" | 日期 |
year | number | 2026 | 年份 |
quarter | number | 1 | 季度 |
查看响应数据示例（原始 JSON）
[
{
"date": "2026-03-31",
"year": 2026,
"quarter": 1
}
]常见问题解答（FAQ）
2 个问题在「Extract」下，13F申报日期查询（/stable/institutional-ownership/dates）与 机构持股申报（/stable/institutional-ownership/latest）如何分工？
13F申报日期查询（/stable/institutional-ownership/dates，必填 cik）重在输出 year（年份）与 quarter 等 3 列；而 Institutional Ownership Filings（机构持股申报）返回 8 列，两者按查询维度互补。
在批量同步13F申报日期查询时，/stable/institutional-ownership/dates 的查询窗口与参数组合该如何安排？
推荐做法：传入精确匹配的 cik 参数调用 /stable/institutional-ownership/dates；当 /stable/institutional-ownership/dates 正常返回含 year 的 JSON/CSV 后，即可直接合入本地策略宽表。
同模块相关接口对比
Extract本接口路径 /stable/institutional-ownership/dates，必填参数 cik。 同一模块「Extract」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。