Symbol Changes List股票代码变更清单
该接口汇总全市场因公司更名、并购重组、借壳上市（SPAC 合并）或拆合股而发生的股票代码变更历史台账。逐条记录新旧股票代码、公司名称及变更生效日期，是量化回测消除幸存者偏差与行情历史拼接的核心字典。
https://quote-fmp.com/stable/symbol-change数据更新周期
该接口暂无固定更新周期（多为按需更新的参考或静态数据）。
接口说明
- 量化回测中新旧代码序列无缝拼接：美股市场每年有数百起 SPAC 完成合并、企业品牌重塑或并购改名事件，导致股票交易代码变更。利用该台账建立新旧代码映射链，可将变更前后的日线行情与财务报表归并至同一实体的连续时间序列中。
- 实盘交易系统与持仓代码自动同步：对于自动化交易系统与投资组合管理（PMS）而言，持仓标的突发代码变更若未及时更新，会导致盘中行情订阅断流或报单被拒。每日盘前轮询该接口即可自动捕获最新生效的代码切换事件并更新持仓映射。
- 规避因代码更替导致的历史样本断代：许多历史龙头或成长股在生命周期中曾多次更换代码，若回测脚本仅按当前代码拉取历史数据，极易造成早期样本缺失或误判为新股上市，该接口为还原真实企业存续周期提供了权威依据。
- 关联数据线接口：Company Profile Bulk（公司概况批量） · Eod Bulk（日线行情批量） · All Exchange Market Hours（交易所交易时段） · Stock Screener（条件选股）
请求参数
2 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
invalid | string | 可选 | false | 是否包含被视为无效的条目。 |
limit | number | 可选 | 100 | 返回结果条数上限，用于控制单次响应大小。 |
调用代码示例
Python 关键代码拉取 股票代码变更清单 只需访问 /stable/symbol-change（可选 invalid, limit），结果涵盖 companyName（公司名称）、oldSymbol（旧证券代码）、newSymbol（新证券代码）（companyName=Yarrow Bioscience, Inc. …）。
resp = requests.get(
"https://quote-fmp.com/stable/symbol-change",
params={"invalid": "false", "limit": 100, "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 股票代码变更清单 核心列：date, companyName, oldSymbol, newSymbol
df = df[["date", "companyName", "oldSymbol", "newSymbol"]].dropna(how="all")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 设置返回条数上限（limit=50）获取最新股票代码变更清单 | limit=50 | 向 /stable/symbol-change 传 limit=50，单次拉取最新 50 条 companyName、oldSymbol、newSymbol 记录（样本 companyName=Yarrow Bioscience, Inc. …）。 |
| 扩大单次返回上限（limit=100）批量归档股票代码变更清单 | limit=100 | 向 /stable/symbol-change 传 limit=100，扩大单次返回容量以归档更多期的 companyName、oldSymbol、newSymbol 等 4 列。 |
在股票代码变更清单（/stable/symbol-change）中，首条样本的 companyName 为 Yarrow Bioscience, Inc. …；批量采集时请按可选 invalid, limit校验传参格式。
存储股票代码变更清单（/stable/symbol-change）数据时，键 (oldSymbol, newSymbol, date) 能唯一标识每条记录；注意 companyName（公司名称，样本 Yarrow Bioscience, Inc. …）为标准文本字段。
返回数据
4 个字段本接口示例响应共包含 4 个字段（数值型 0 个，文本/日期/布尔型 4 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
date | string | "2026-07-28" | 日期 |
companyName | string | "Yarrow Bioscience, Inc. Common…" | 公司名称 |
oldSymbol | string | "VYNE" | 旧证券代码 |
newSymbol | string | "YARW" | 新证券代码 |
查看响应数据示例（原始 JSON）
[
{
"date": "2026-07-28",
"companyName": "Yarrow Bioscience, Inc. Common Stock",
"oldSymbol": "VYNE",
"newSymbol": "YARW"
}
]常见问题解答（FAQ）
2 个问题使用「Directory」接口族时，股票代码变更清单（可选 invalid, limit）与 全部股票代码清单（无必填参数）怎么选？
按输入参数看，/stable/symbol-change（股票代码变更清单）为可选 invalid, limit，产出 companyName（Yarrow Bioscience, Inc. …）等 4 列；/stable/stock-list（Company Symbols List（全部股票代码清单））为无必填参数，产出 2 列。
在自动化流水线中对接股票代码变更清单（/stable/symbol-change），怎样平衡拉取深度与请求效率？
最佳实践是根据回测跨度需求在 /stable/symbol-change 中设置 limit 条数上限一次拿齐序列；解析响应中的 companyName（如 Yarrow Bioscience, Inc. …）前，请确保对异常空值和网络超时设置退避重试。
同模块相关接口对比
Directory本接口路径 /stable/symbol-change，无必填参数。 同一模块「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）与机构/公司标准名称的分页目录 |
| ETF代码检索ETF Symbol Search | /stable/etf-list | 全球主要交易所挂牌的全部交易所交易基金（ETF）代码与基金名称完整目录 |
| 在市活跃交易清单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 | 平台有证券数据覆盖的全部国家与地区两字母标准代码清单 |