Mutual Fund & ETF Disclosure Name Search基金ETF披露检索
该接口按基金名称查找披露文件:返回基金代码、CIK、系列与类别 ID、申报文件编号及申报主体地址等关键信息,便于精准定位监管文件。
https://quote-fmp.com/stable/funds/disclosure-holders-search?name=Federated Hermes Government Income Securities, Inc.数据更新周期
Daily
接口说明
- 基金名称检索:用基金或主体名称查找公募基金与 ETF 的披露文件,传入
name后可同步classId(类别ID)、seriesId(系列ID)与entityName(主体名称) 等明细数据,支撑多维度选股与面板回归分析。 - 关键申报信息:获取 CIK 编号、系列与类别 ID、主体名称和申报文件编号等重要信息,结合
seriesId(系列ID)与entityName(主体名称) 等明细维度,有助于对标的异动做归因拆解与交叉验证。 - 完整结果:返回所查基金或 ETF 主体的地址详情与申报信息,便于定位相关文件,在多因子回测管道里,常联合「基金ETF按日披露」一起采集以丰富特征维度。
- 上下游关联接口:ETF & Fund Country Allocation(ETF 基金国家配置) · ETF Asset Exposure(ETF持仓分布查询) · Stock Quote(股票报价) · Eod Bulk(日线行情批量)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
name | string | 必填 | Federated Hermes Government Income Securities, Inc. | 公司或证券名称关键词,用于按名称检索。 |
调用代码示例
Python 关键代码访问 /stable/funds/disclosure-holders-search 获取基金ETF披露检索(必填 name),单条记录含 classId(类别 ID)、seriesId(系列 ID)、entityName(主体名称) 等 13 个字段。
resp = requests.get(
"https://quote-fmp.com/stable/funds/disclosure-holders-search",
params={"name": "Federated Hermes Government Income Securities, Inc.", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 entityOrgType(主体组织形式)
df["entityOrgType"] = pd.to_numeric(df["entityOrgType"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按关键词「Federated Hermes Government Income Securities, Inc.」检索基金ETF披露检索 | name=Federated Hermes Government Income Securities, Inc. | 向 /stable/funds/disclosure-holders-search 传入 name=Federated Hermes Government Income Securities, Inc.,返回匹配的 classId、seriesId、entityName(样本 classId=C000024574)。 |
| 切换检索词「Microsoft」查询基金ETF披露检索 | name=Microsoft | 将 name 设为 Microsoft 调用 /stable/funds/disclosure-holders-search,获取对应实体的 classId、seriesId、entityName 等 13 列信息。 |
访问 /stable/funds/disclosure-holders-search 提取基金ETF披露检索(必填 name),单条 JSON 含 classId(C000024574)等 13 个字段,空列表响应代表该条件下无匹配记录。
从 /stable/funds/disclosure-holders-search 抽取 entityOrgType(样本 30)入库时,以 (symbol, cik) 建唯一索引可安全支持断点续传。
返回数据
13 个字段本接口示例响应共包含 13 个字段(数值型 0 个,文本/日期/布尔型 13 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "FGOAX" | 证券代码 |
cik | string | "0000355691" | SEC CIK 编号(SEC 10 位定长中央索引键,落库须定义为 VARCHAR(10) 字符串以防前导零丢失) |
classId | string | "C000024574" | 类别 ID |
seriesId | string | "S000009042" | 系列 ID |
entityName | string | "Federated Hermes Government In…" | 主体名称 |
entityOrgType | string | "30" | 主体组织形式 |
seriesName | string | "Federated Hermes Government In…" | 系列名称 |
className | string | "Class A Shares" | 类别名称 |
reportingFileNumber | string | "811-03266" | 申报文件编号 |
address | string | "4000 ERICSSON DRIVE" | 注册地址 |
city | string | "WARRENDALE" | 城市 |
zipCode | string | "15086-7561" | 邮政编码 |
state | string | "PA" | 州/省 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "FGOAX",
"cik": "0000355691",
"classId": "C000024574",
"seriesId": "S000009042",
"entityName": "Federated Hermes Government Income Securities, Inc.",
"entityOrgType": "30",
"seriesName": "Federated Hermes Government Income Securities, Inc.",
"className": "Class A Shares",
"reportingFileNumber": "811-03266",
"address": "4000 ERICSSON DRIVE",
"city": "WARRENDALE",
"zipCode": "15086-7561",
"state": "PA"
}
]常见问题解答(FAQ)
2 个问题如何区分「Fund Disclosures」模块的基金ETF披露检索与 公募基金与 ETF 披露?/stable/funds/disclosure-holders-search 的传参要求是什么?
两者的差异在于入口与字段集:/stable/funds/disclosure-holders-search(基金ETF披露检索)要求必填 name并产出 13 列(含 classId=C000024574);Mutual Fund & ETF Disclosure(公募基金与 ETF 披露)要求必填 symbol并产出 7 列。
拉取 /stable/funds/disclosure-holders-search 的基金ETF披露检索数据时,如何处理历史回溯、空结果判定或代码格式?
针对 /stable/funds/disclosure-holders-search,推荐传入精确匹配的 name 参数调用 /stable/funds/disclosure-holders-search;这样既能稳定获取 classId(类别 ID),又能避免单次请求载荷过大。
同模块相关接口对比
Fund Disclosures本接口路径 /stable/funds/disclosure-holders-search,必填参数 name。 同一模块「Fund Disclosures」下共 4 个接口,下表列出其余 3 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 公募基金与 ETF 披露Mutual Fund & ETF Disclosure | /stable/funds/disclosure-holders-latest | 按基金或 ETF 代码与报告期查询 SEC N-PORT 监管披露的底层持仓明细 |
| 公募基金披露Mutual Fund Disclosures | /stable/funds/disclosure | 按目标股票代码反查持有该股的公募基金与 ETF 监管披露清单 |
| 基金ETF按日披露Fund & ETF Disclosures by Date | /stable/funds/disclosure-dates | 按申报日期检索公募基金与 ETF 的披露文件,跟踪最新申报、回溯历史季度数据、监测申报趋势 |