Mutual Fund Disclosures公募基金披露

Q: 调用 /stable/funds/disclosure 获取公募基金披露，怎样根据参数特性控制单次返回的记录范围？

针对 公募基金披露（/stable/funds/disclosure），请在 /stable/funds/disclosure 中指定 symbol（跨市场代码须保留后缀）；提取 name（Shenzhen Airport Co Ltd）与 lei 后即可完成当期截面对齐。

该接口按目标股票代码反查持有该股的公募基金与 ETF 监管披露清单（Form N-PORT），展示各基金持股数量、持仓市值、权重占比及环比增减变动。

GEThttps://quote-fmp.com/stable/funds/disclosure?symbol=VWO&year=2023&quarter=4

数据更新周期

Daily

接口说明

跟踪基金持仓：查阅公募基金最新披露的持仓,包括资产类别、发行人信息与投资国家,了解各公募基金的投资组合构成。
分析最新申报：获取公募基金的关键财务报告与申报，包括结存金额、美元市值、占组合总值比例等，支持投资分析与策略制定。
投资透明度：提供 CUSIP、ISIN、发行人类别、公允价值层级等关键细节，让公募基金投资完全透明，研究端可将本接口与「基金ETF披露检索」组合编排，覆盖从概览快照到历史序列的需求。
配套投研接口：ETF & Mutual Fund Information（ETF与基金资料） · ETF & Fund Country Allocation（ETF 基金国家配置） · Eod Bulk（日线行情批量） · Company Profile Data（公司概况）

请求参数

4 个参数

参数	类型	要求	示例	说明
`symbol`	string	必填	`VWO`	ETF 或公募基金交易代码，例如 SPY（标普 500 ETF）、QQQ（纳指 100 ETF）、VOO、VWO。
`year`	string	必填	`2023`	目标财报/数据的年份，如 2023。
`quarter`	string	必填	`4`	目标季度，1、2、3、4 分别对应 Q1~Q4。
`cik`	string	可选	`0000857489`	SEC Central Index Key（CIK）编号，用于定位公司 SEC 主体（须传补足前导零的 10 位定长字符串，如 "0000320193"，切勿传整型）

调用代码示例

Python 关键代码

上方代码调用 /stable/funds/disclosure（必填 symbol, year, quarter），将公募基金披露的 name（名称）、lei（全球法人识别编码（LEI））、title（标题 / 职务）载入 DataFrame。

Python（核心参数与字段清洗逻辑）

resp = requests.get(
    "https://quote-fmp.com/stable/funds/disclosure",
    params={"symbol": "VWO", "year": "2023", "quarter": "4", "cik": "0000857489", "apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 保留上游 acceptedDate 并清洗 balance；可见时间须另核对披露来源和时区
df["reported_accepted_time"] = pd.to_datetime(df["acceptedDate"], errors="coerce")
df["balance"] = pd.to_numeric(df["balance"], errors="coerce")

参数使用和避坑

3 组参数组合 · 2 条避坑

以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：

投研场景	Query 参数组合示例	返回数据特征与用途
按 10 位 CIK（0000857489）检索公募基金披露	`symbol=VWO&year=2023&quarter=4&cik=0000857489`	向 /stable/funds/disclosure 传补零 10 位 cik=0000857489，获取 name、lei、title（样本 name=Shenzhen Airport Co Ltd）。
切换代表性机构/主体（cik=0001067983）对比公募基金披露	`symbol=VWO&year=2023&quarter=4&cik=0001067983`	改传 cik=0001067983 调用 /stable/funds/disclosure，横向比较不同 SEC 申报主体的 name、lei、title。
回溯 2024Q4 历史季末公募基金披露截面	`symbol=VWO&year=2024&quarter=Q4&cik=0000857489`	指定 year=2024&quarter=Q4，还原 0000857489 在历史季末的 name、lei、title 明细。

防未来函数公募基金披露：核验 acceptedDate 的来源，避免将账期或回填时间当作公开时刻

/stable/funds/disclosure 返回 acceptedDate（样本 2023-12-28 09:26:13），但字段名不保证它在所有市场都是实际公开时刻。对经核实的 SEC 申报，可结合接收时间和时区判断可见性；非美标的、与期末同日的零点时间或回填日期，须先核对原始披露来源。未核实前保留原值，不据此承诺回测已消除前视偏差。

落库主键与口径解析公募基金披露：balance 精度与 (symbol, cik, date) 唯一键

/stable/funds/disclosure 产出的 23 项字段（含 balance=2438784、valUsd=2255873.6）在写入宽表前，应按 (symbol, cik, date) 执行去重校验。

返回数据

23 个字段

本接口示例响应共包含 23 个字段（数值型 3 个，文本/日期/布尔型 20 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。

字段	类型	示例值	说明
`cik`	string	`"0000857489"`	SEC CIK 编号（SEC 10 位定长中央索引键，落库须定义为 VARCHAR(10) 字符串以防前导零丢失）
`date`	string	`"2023-10-31"`	日期
`acceptedDate`	string	`"2023-12-28 09:26:13"`	受理日期（SEC 精确到秒接收时间戳；Point-in-Time 量化回测须以此时间为准以防未来函数）
`symbol`	string	`"000089.SZ"`	证券代码
`name`	string	`"Shenzhen Airport Co Ltd"`	名称
`lei`	string	`"3003009W045RIKRBZI44"`	全球法人识别编码（LEI）
`title`	string	`"SHENZ AIRPORT-A"`	标题 / 职务
`cusip`	string	`"N/A"`	CUSIP 代码
`isin`	string	`"CNE000000VK1"`	国际证券识别码
`balance`	number	`2438784`	余额
`units`	string	`"NS"`	数量单位
`cur_cd`	string	`"CNY"`	币种代码
`valUsd`	number	`2255873.6`	美元计价值
`pctVal`	number	`0.0023838966190458206`	占比（%）
`payoffProfile`	string	`"Long"`	收益结构（多/空）
`assetCat`	string	`"EC"`	资产类别
`issuerCat`	string	`"CORP"`	发行人类别
`invCountry`	string	`"CN"`	投资标的所在国家
`isRestrictedSec`	string	`"N"`	是否为受限证券
`fairValLevel`	string	`"2"`	公允价值层级
`isCashCollateral`	string	`"N"`	是否为现金抵押品
`isNonCashCollateral`	string	`"N"`	是否为非现金抵押品
`isLoanByFund`	string	`"N"`	是否由基金出借

查看响应数据示例（原始 JSON）

[
{
"cik": "0000857489",
"date": "2023-10-31",
"acceptedDate": "2023-12-28 09:26:13",
"symbol": "000089.SZ",
"name": "Shenzhen Airport Co Ltd",
"lei": "3003009W045RIKRBZI44",
"title": "SHENZ AIRPORT-A",
"cusip": "N/A",
"isin": "CNE000000VK1",
"balance": 2438784,
"units": "NS",
"cur_cd": "CNY",
"valUsd": 2255873.6,
"pctVal": 0.0023838966190458206,
"payoffProfile": "Long",
"assetCat": "EC",
"issuerCat": "CORP",
"invCountry": "CN",
"isRestrictedSec": "N",
"fairValLevel": "2",
"isCashCollateral": "N",
"isNonCashCollateral": "N",
"isLoanByFund": "N"
}
]

常见问题解答（FAQ）

2 个问题

公募基金披露与公募基金与 ETF 披露的端点路径（/stable/funds/disclosure vs /stable/funds/disclosure-holders-latest）和参数约束分别是怎样的？

调用 /stable/funds/disclosure 获取公募基金披露时（必填 symbol, year, quarter），您将拿到 name=Shenzhen Airport Co Ltd 等 23 列数据；而调用 Mutual Fund & ETF Disclosure（公募基金与 ETF 披露）则会拿到 7 列数据。

调用 /stable/funds/disclosure 获取公募基金披露，怎样根据参数特性控制单次返回的记录范围？

针对公募基金披露（/stable/funds/disclosure），请在 /stable/funds/disclosure 中指定 symbol（跨市场代码须保留后缀）；提取 name（Shenzhen Airport Co Ltd）与 lei 后即可完成当期截面对齐。

同模块相关接口对比

Fund Disclosures

本接口路径 /stable/funds/disclosure，必填参数 symbol、year、quarter。同一模块「Fund Disclosures」下共 4 个接口，下表列出其余 3 个，按粒度与查询维度对比，避免选错接口。

接口	路径	核心差异与适用场景
公募基金与 ETF 披露Mutual Fund & ETF Disclosure	`/stable/funds/disclosure-holders-latest`	按基金或 ETF 代码与报告期查询 SEC N-PORT 监管披露的底层持仓明细
基金ETF披露检索Mutual Fund & ETF Disclosure Name Search	`/stable/funds/disclosure-holders-search`	按基金名称查找披露文件，返回基金代码、CIK、系列与类别 ID、申报文件编号及申报主体地址等关键信息
基金ETF按日披露Fund & ETF Disclosures by Date	`/stable/funds/disclosure-dates`	按申报日期检索公募基金与 ETF 的披露文件，跟踪最新申报、回溯历史季度数据、监测申报趋势

EtfAndMutualFunds（ETF 与基金）全部接口目录 →

需要稳定访问公募基金披露数据？注册即可获取专属 API Key，免费体验全部接口。

免费试用 1 个月