Directory(基础目录)

此类接口提供全市场的基础字典信息,包括可用证券代码与 CIK 清单、当前正在交易的标的、代码变更记录,以及交易所、行业、国家等可选值目录。建本地证券主表、做全市场轮询,或给下游接口准备合法参数时,先从这里把清单拉下来。

典型使用场景

3 个场景
本地证券主表建库

每日定时同步在市代码、退市代码与代码变更记录。

爬虫/同步任务分片

以有财报标的清单作为全市场基本面同步的任务队列。

前端筛选器字典

用官方 Sector / Industry / Exchange 枚举填充筛选下拉框。

接口怎么选?

7 项选型对照

基础目录类别用来构建和维护本地证券主表(Security Master):初始化数据库时先拉取交易所、板块(Sector)、细分行业(Industry)枚举,再拉全市场代码清单。

全量代码列表包含缺乏财报的小票或非活跃标的;如果下游任务是跑基本面因子,建议直接以 Financial Statement Symbols List(报表公司清单) 和 Actively Trading List(在市活跃交易清单) 的交集作为任务队列。

你的需求推荐接口选择理由
拉取全市场全部股票代码Company Symbols List全部股票代码清单最全的基础证券代码字典
只拉有财务报表的公司代码Financial Statement Symbols List报表公司清单避免对无财报标的发起无效的报表请求
只拉当前正常交易的标的Actively Trading List在市活跃交易清单过滤停牌与不活跃证券,适合实盘行情同步
追踪历史上改过名字/代码的股票Symbol Changes List股票代码变更清单回测中串联改名前后的历史行情与财报(如 FB → META)
获取全部 ETF 代码目录ETF Symbol SearchETF代码检索单独提取 ETF 标的池
获取有财报电话会纪要的公司清单Earnings Transcript List业绩电话会纪要代码清单批量拉取电话会文字稿前的预检目录
获取标准交易所、板块与行业枚举Available Sectors可用板块清单配合 Available Exchanges(可用交易所清单) / Available Industries(可用细分行业清单) 统一筛选参数值

数据覆盖与参数口径

  • 适用场景:本地证券主表(Security Master)初始化与每日增量同步
  • 更新建议:目录与枚举类接口按日或按周定时同步即可,无需高频轮询
  • 回测防坑:结合 Symbol Changes List(股票代码变更清单) 与 Delisted Companies(退市公司清单) 消除代码变更断层

调用示例

Python 关键代码

示例场景:获取具备财务报表的全部上市公司代码清单 · 对应接口:Financial Statement Symbols List(报表公司清单)

Python(核心参数与字段清洗逻辑)
resp = requests.get(
    "https://quote-fmp.com/stable/financial-statement-symbol-list",
    params={"apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 报表公司清单 核心列:symbol, companyName, tradingCurrency, reportingCurrency
df = df[["symbol", "companyName", "tradingCurrency", "reportingCurrency"]].dropna(how="all")
  • 批量拉取财报前先用此列表过滤,可省去大量空数组请求。
  • 代码变更历史请配合 Symbol Changes List(股票代码变更清单) 建映射表。

数据注意事项

4 条实盘要点
  • 批量拉取三大报表前,先用 Financial Statement Symbols List(报表公司清单) 与 Actively Trading List(在市活跃交易清单) 取交集过滤任务队列,避免对无财报证券发起无效请求。
  • 长周期回测请结合 Symbol Changes List(股票代码变更清单) 将历史改名代码(如 FB → META)串联到同一内部证券 ID,避免历史时间序列断裂。
  • 下游接口的板块(sector)、细分行业(industry)、交易所(exchange)与国家(country)过滤参数,必须使用 Available Sectors(可用板块清单)、Available Industries(可用细分行业清单)、Available Exchanges(可用交易所清单) 与 Available Countries(可用国家清单) 返回的标准英文枚举。
  • 初始化全市场 ETF 或 CIK 映射字典时,可分别调用 ETF Symbol Search(ETF代码检索) 与 CIK List(CIK 编号清单) 按日或按周增量同步。

常见问题

3 个问题
Company Symbols List(全部股票代码清单) 和 Actively Trading List(在市活跃交易清单) 差在哪里?

Company Symbols List(全部股票代码清单) 包含数据库中收录的全部历史与现存代码;Actively Trading List(在市活跃交易清单) 仅保留当前处于活跃交易状态的标的。

股票改过代码(如 FB 改为 META)怎么在回测里不断裂?

调用 Symbol Changes List(股票代码变更清单) 获取 oldSymbol 与 newSymbol 及变更日期,在本地数据清洗层将新旧代码映射到同一个内部证券 ID。

选股器里的 sector 和 industry 参数应该填什么字符串?

分别调用 Available Sectors(可用板块清单) 和 Available Industries(可用细分行业清单) 获取官方精确英文枚举值,原样传入即可。

接口一览(11个)

1 个功能模块

Directory

11 个接口
GETCompany Symbols List
全部股票代码清单

该接口返回平台覆盖的全球各大交易所全部股票、ETF 及可交易金融工具的完整代码总表。作为全市场证券主表(Security Master)的底层全量枚举源,适合用于本地数据库初始化、全市场代码字典同步与每日增量标的比对。

/stable/stock-list
GETFinancial Statement Symbols List
报表公司清单

该接口返回全市场所有具备标准化财务三表(利润表、资产负债表、现金流量表)数据的上市公司代码清单。它是基本面量化团队在批量拉取财报数据前的前置白名单,用于一步剔除无财报覆盖的 ETF、指数及特殊金融工具。

/stable/financial-statement-symbol-list
GETCIK List
CIK 编号清单

该接口提供全市场 SEC 注册实体的中央索引键(CIK)与机构/公司标准名称的分页目录。作为监管申报主体的全量字典,它支持按分页批量同步 CIK 编码库,支撑合规审计、13F 机构名录建库及 EDGAR 文档归集。

/stable/cik-list
GETSymbol Changes List
股票代码变更清单

该接口汇总全市场因公司更名、并购重组、借壳上市(SPAC 合并)或拆合股而发生的股票代码变更历史台账。逐条记录新旧股票代码、公司名称及变更生效日期,是量化回测消除幸存者偏差与行情历史拼接的核心字典。

/stable/symbol-change
GETETF Symbol Search
ETF代码检索

该接口返回全球主要交易所挂牌的全部交易所交易基金(ETF)代码与基金名称完整目录。作为 ETF 资产池的专属枚举源,它可用于一键分离纯 ETF 标的与普通个股,支撑大类资产配置、行业轮动及基金穿透分析。

/stable/etf-list
GETActively Trading List
在市活跃交易清单

该接口返回当前在全球公开交易所处于正常挂牌交易状态的全部股票与金融工具代码清单。通过剔除已退市、长期停牌或失效的历史代码,它为实盘行情轮询、每日增量数据同步与可交易股票池构建提供实时存活白名单。

/stable/actively-trading-list
GETEarnings Transcript List
业绩电话会纪要代码清单

该接口返回全市场所有已收录业绩电话会文字纪要的上市公司代码清单及每家公司可查的历史纪要总篇数。它是构建电话会 NLP 语料库与管理层情绪分析系统的前置目录索引,用于快速盘点标的覆盖度与数据厚度。

/stable/earnings-transcript-list
GETAvailable Exchanges
可用交易所清单

该接口返回平台支持的所有全球证券交易所标准字典,涵盖纽交所、纳斯达克、伦敦、东京、港交所及沪深等主流市场。每条记录提供交易所缩写代码、全称、所在国家、计价币种及与美东时间的时差,是跨市场过滤与交易日历换算的基础维表。

/stable/available-exchanges
GETAvailable Sectors
可用板块清单

该接口返回平台采用的一级行业板块(Sector)标准分类清单,涵盖科技、医疗保健、金融服务、消费、能源及工业等核心经济部门。作为行业分类体系的顶层枚举字典,它直接支撑股票筛选器过滤、板块轮动监控与组合行业暴露归因。

/stable/available-sectors
GETAvailable Industries
可用细分行业清单

该接口返回平台采用的二级细分行业(Industry)标准分类全量清单,涵盖半导体、生物技术、区域性银行、特种化工及软件应用等百余个垂直赛道。它提供比一级板块更精细的产业链颗粒度,是垂直赛道挖掘与同业对标的核心字典。

/stable/available-industries
GETAvailable Countries
可用国家清单

该接口返回平台有证券数据覆盖的全部国家与地区两字母标准代码(ISO 二位国别码)清单。作为地域维度的权威枚举字典,它用于按企业总部所在地或上市市场归属国筛选全球股票,支撑跨国市场比较与地缘风险敞口管理。

/stable/available-countries
准备好接入基础目录相关接口了吗?接口路径与 FMP 保持兼容,替换域名和 API Key 即可开始。
领取 1 个月试用 Key