ETF Symbol SearchETF代码检索
该接口返回全球主要交易所挂牌的全部交易所交易基金(ETF)代码与基金名称完整目录。作为 ETF 资产池的专属枚举源,它可用于一键分离纯 ETF 标的与普通个股,支撑大类资产配置、行业轮动及基金穿透分析。
https://quote-fmp.com/stable/etf-list数据更新周期
该接口暂无固定更新周期(多为按需更新的参考或静态数据)。
接口说明
- 大类资产配置与轮动标的池底座:全球市场挂牌的数千只 ETF 覆盖了宽基指数、细分行业、国债久期、大宗商品及杠杆做空工具。通过该接口一次性拉取全量 ETF 清单,可快速搭建宏观资产配置(GTA)与板块轮动模型的候选资产池。
- 选股策略中剔除基金标的过滤黑名单:在开展纯股票多因子选股或事件驱动回测时,若混入高成交量的宽基或行业 ETF,会严重扭曲截面因子分布与行业权重。工程上常将该接口返回的 ETF 代码集合作为过滤黑名单,确保个股池纯净度。
- 下游 ETF 持仓穿透与采集调度入口:在批量采集 ETF 行业权重、前十大重仓股或基金净值(NAV)前,以该目录接口作为顶层任务队列,可对全市场 ETF 开展系统化的资产归类、跟踪误差计算与流动性分层筛选。
- 跨模块关联接口:Company Profile Data(公司概况) · Company Profile Bulk(公司概况批量) · Eod Bulk(日线行情批量) · All Exchange Market Hours(交易所交易时段)
调用代码示例
Python 关键代码调用 ETF代码检索 端点 /stable/etf-list(仅 apikey),响应包含 name(名称)、symbol(证券代码) 等 2 个属性。
resp = requests.get(
"https://quote-fmp.com/stable/etf-list",
params={"apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 ETF代码检索 核心列:symbol, name
df = df[["symbol", "name"]].dropna(how="all")参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 一次性拉取全量ETF代码检索初始化本地主表 | GET /stable/etf-list(免参数) | /stable/etf-list 不收业务参数,一次调用拿回全部 2 列(name、symbol);初始化主表与全量对账都靠这一跳。 |
| 以 symbol 为唯一键覆盖写入,避免全表重复 | GET /stable/etf-list → upsert on symbol | 该表以 symbol 唯一(样本 P60.SI),共 2 列;upsert 到本地表时按 symbol 覆盖写,重复拉取不会产生脏行。 |
| 落库后自检:symbol 唯一性与 name 空值率 | GET /stable/etf-list → count(distinct symbol) / null_ratio(name) | 2 列落库完成后,用 count(distinct symbol) 对账行数;name(如 MULTI-UNITS LUXEMBOURG -…)若大面积为空,说明本次全表拉取不完整,需要重跑。 |
调用ETF代码检索接口 /stable/etf-list(免业务参数),可取回 name 等共 2 项指标;批量轮询时请结合网关 RPM 配额控制并发度。
归档ETF代码检索(端点 /stable/etf-list)推荐采用 (symbol, name) 作为主键;对 name(名称)等 2 个文本/日期列需防范 None 或空串。
返回数据
2 个字段本接口示例响应共包含 2 个字段(数值型 0 个,文本/日期/布尔型 2 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "P60.SI" | 证券代码 |
name | string | "MULTI-UNITS LUXEMBOURG - Lyxor…" | 名称 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "P60.SI",
"name": "MULTI-UNITS LUXEMBOURG - Lyxor MSCI AC Asia Pacific Ex Japan UCITS ETF"
}
]常见问题解答(FAQ)
2 个问题调用ETF代码检索与 全部股票代码清单 有何差异?/stable/etf-list 重点输出哪些指标?
访问 /stable/etf-list 拉取ETF代码检索(免业务参数)可拿到 name(MULTI-UNITS LUXEMBOURG -…)与 symbol;若需 /stable/stock-list(无必填参数)的 2 项数据,可改调 Company Symbols List(全部股票代码清单)。
如何利用 /stable/etf-list 的参数机制,高效完成ETF代码检索的冷启动回填与盘后同步?
无论冷启动还是增量更新,都可免过滤参数访问 /stable/etf-list 一次性导出完整截面;读取 name(样本 MULTI-UNITS LUXEMBOURG -…)后建议先过滤无效记录再入库。
同模块相关接口对比
Directory本接口路径 /stable/etf-list,无必填参数。 同一模块「Directory」下共 11 个接口,下表列出其余 10 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 全部股票代码清单Company Symbols List | /stable/stock-list | 平台覆盖的全球各大交易所全部股票、ETF 及可交易金融工具的完整代码总表 |
| 报表公司清单Financial Statement Symbols List | /stable/financial-statement-symbol-list | 全市场所有具备标准化财务三表数据的上市公司代码清单 |
| CIK 编号清单CIK List | /stable/cik-list | 全市场 SEC 注册实体的中央索引键(CIK)与机构/公司标准名称的分页目录 |
| 股票代码变更清单Symbol Changes List | /stable/symbol-change | 汇总全市场因公司更名、并购重组、借壳上市或拆合股而发生的股票代码变更历史台账 |
| 在市活跃交易清单Actively Trading List | /stable/actively-trading-list | 当前在全球公开交易所处于正常挂牌交易状态的全部股票与金融工具代码清单 |
| 业绩电话会纪要代码清单Earnings Transcript List | /stable/earnings-transcript-list | 全市场所有已收录业绩电话会文字纪要的上市公司代码清单及每家公司可查的历史纪要总篇数 |
| 可用交易所清单Available Exchanges | /stable/available-exchanges | 平台支持的所有全球证券交易所标准字典 |
| 可用板块清单Available Sectors | /stable/available-sectors | 平台采用的一级行业板块标准分类清单 |
| 可用细分行业清单Available Industries | /stable/available-industries | 平台采用的二级细分行业标准分类全量清单 |
| 可用国家清单Available Countries | /stable/available-countries | 平台有证券数据覆盖的全部国家与地区两字母标准代码清单 |