Stock Split Details公司拆合股明细
该接口返回指定股票自上市以来的全部历史拆股(正向分割)与合股(反向缩股)事件明细。每条记录精确给出除权生效日期及拆合股比例的分子与分母,是本地行情数据库自行计算前后复权因子与还原真实历史股本的核心参数源。
https://quote-fmp.com/stable/splits?symbol=AAPL数据更新周期
1-2 Hours
接口说明
- 自建复权引擎精确比例因子源:在构建本地量化行情库时,许多团队选择存储原始未复权日线并自行维护动态复权因子表。该接口以独立的分子与分母整数(如分子 4、分母 1 代表 1 拆 4;分子 1、分母 10 代表 10 合 1)精确表达每次股本变动,消除浮点数舍入误差。
- 正向拆股成长股与反向合股仙股识别:在美股市场中,绩优成长股常通过大比例正向拆股降低单股价格门槛以吸引流动性;而濒临退市仙股则频繁通过反向合股(分子小于分母)强行将股价拉回 1 美元合规线以上。通过统计历史拆合股方向与频次,可有效分离优质长牛股与价值毁灭的“老千仙股”。
- 历史总股本回溯与跨期可比性校准:当脱离接口自带的复权序列、直接对历史原始财务数据或期权行权价做跨年度回溯时,利用该拆股历史序列可准确还原任意历史时点的股本折算倍数,确保每股收益与持仓股数核算前后一致。
- 上下游关联接口:IPOs Prospectus(IPO 招股书) · Dividends Company(公司分红派息) · Income Statement(利润表) · Stock Price and Volume Data(日线完整行情)
请求参数
2 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
limit | number | 可选 | 100 | 返回结果条数上限,用于控制单次响应大小。 |
调用代码示例
Python 关键代码公司拆合股明细路径为 /stable/splits(必填 symbol),响应 JSON 展开 numerator(拆股分子)、denominator(拆股分母)、splitType(拆股类型) 共 5 列。
resp = requests.get(
"https://quote-fmp.com/stable/splits",
params={"symbol": "AAPL", "limit": 100, "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 numerator(拆股分子)
df["numerator"] = pd.to_numeric(df["numerator"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 传入 symbol=AAPL 请求公司拆合股明细 | symbol=AAPL | 调用 /stable/splits 拉取 AAPL 的公司拆合股明细,输出 numerator、denominator、splitType 等 5 项标准化属性。 |
| 设置返回条数上限(limit=100)回溯 AAPL 公司拆合股明细 | symbol=AAPL&limit=100 | 通过条数上限参数请求 /stable/splits,单次拉回 AAPL 更长历史周期的 numerator、denominator、splitType。 |
| 跨市场检索 0700.HK 的公司拆合股明细数据 | symbol=0700.HK | 通过 symbol=0700.HK 请求 /stable/splits,实现公司拆合股明细在港股市场的同口径采集(含 numerator、denominator、splitType)。 |
调用 /stable/splits 拉取公司拆合股明细(必填 symbol)时,若条件未命中会返回 [];读取 numerator(4)与 denominator 前须先判断 not df.empty。
/stable/splits 的首条样本含 numerator=4;日常增量任务按 (symbol, date) 合并即可保持本地库与上游一致。
返回数据
5 个字段本接口示例响应共包含 5 个字段(数值型 2 个,文本/日期/布尔型 3 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
date | string | "2020-08-31" | 日期 |
numerator | number | 4 | 拆股分子 |
denominator | number | 1 | 拆股分母 |
splitType | string | "stock-split" | 拆股类型 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"date": "2020-08-31",
"numerator": 4,
"denominator": 1,
"splitType": "stock-split"
}
]常见问题解答(FAQ)
2 个问题公司拆合股明细(/stable/splits)产出的 numerator 等字段,与 拆合股日历 的返回内容有何侧重?
公司拆合股明细(端点 /stable/splits,必填 symbol)返回 numerator(拆股分子)及 denominator(1)共 5 列;若业务需要 Stock Splits Calendar(拆合股日历),可改调 /stable/splits-calendar(无必填参数)。
工程团队在封装 /stable/splits(公司拆合股明细)客户端时,应采用怎样的拉取逻辑?
标准流程是在 /stable/splits 中显式调大 limit 参数(如 limit=100)单次拉取多期记录;在拿到 公司拆合股明细 的 numerator 与 denominator 后,及时释放内存中的原始文本流。
同模块相关接口对比
Splits本接口路径 /stable/splits,必填参数 symbol。 同一模块「Splits」下共 2 个接口,下表列出其余 1 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 拆合股日历Stock Splits Calendar | /stable/splits-calendar | 按自定义起止日期区间返回全市场即将实施或历史已完成的股票拆股与合股日程表 |