Stock Price and Volume Data日线完整行情
该接口提供个股自上市以来的完整日 K 线与成交量历史序列。数据默认已完成历史拆股与合股前复权平滑处理,消除了拆股日的价格断层,可直接用于绘制长期走势图、计算量价技术指标与日频策略回测。
https://quote-fmp.com/stable/historical-price-eod/full?symbol=AAPL数据更新周期
5-15 Minutes · 约 5~15 分钟更新
接口说明
- 拆股校准长周期序列:美股科技与成长股历史上频繁发生大比例拆股(如 1 拆 10、1 拆 4)或合股。该接口默认对历史开高低收价格做前复权缩放、对成交量做反向还原,确保跨年度计算均线、波动率与动量因子时不会产生虚假跳空断层。
- 日内结构与成交重心:除标准四价与成交量外,单条记录直接提供日内实体涨跌幅与日线参考均价(VWAP),便于在不拉取分钟级高频数据的前提下,快速评估每日多空博弈强弱与筹码成交重心变化。
- 多市场统一回测底座:以相同的字段结构覆盖美股、港股、A 股及全球主要交易所标的,支持按任意起止日期区间一次拉穿数十年历史,是构建本地日频行情库与计算技术指标的基础数据源。
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
from | date | 可选 | 2026-04-30 | 查询起始日期,格式 YYYY-MM-DD,包含当天。 |
to | date | 可选 | 2026-07-30 | 查询结束日期,格式 YYYY-MM-DD,包含当天。 |
调用代码示例
Python 关键代码/stable/historical-price-eod/full 直接返回顶层 JSON 数组(不再包裹旧版 v3 的 {"historical": [...]}),可直接传给 pd.DataFrame()。
resp = requests.get(
"https://quote-fmp.com/stable/historical-price-eod/full",
params={"symbol": "AAPL", "from": "2025-01-01", "to": "2026-10-20", "apikey": FMP_KEY},
)
# 接口默认按 date 降序返回,且内置 changePercent 为日内 (close - open) / open
# 计算含隔夜跳空的真实日度收益率(Close-to-Close)必须先按日期升序排列:
df = pd.DataFrame(resp.json()).sort_values("date").reset_index(drop=True)
df["close_to_close_pct"] = (df["close"].pct_change() * 100).round(4)参数使用和避坑
3 组参数组合 · 3 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 拉取指定起止日期区间的日 K 线 | symbol=AAPL&from=2025-01-01&to=2026-10-20 | 返回闭区间 [from, to] 内所有交易日的 OHLCV、日内涨跌幅与 vwap,默认按日期从新到旧倒序排列。 |
| 单次拉取上市以来完整 30+ 年日线 | symbol=AAPL&from=1980-01-01&to=2026-10-20 | 显式传入早年 from 即可一次拉回完整历史(AAPL 约 1.1 万个交易日,gzip 压缩后传输体积约 200 KB),无需按年份切片循环。 |
| 港股、A 股与全球多市场日线拉取 | symbol=0700.HK&from=2026-01-01 | 支持港股(.HK)、沪深 A 股(.SS / .SZ)等全球主要交易所后缀,价格单位为对应交易所挂牌币种。 |
以本页示例数据为例:open=333.13、close=332.39,返回的 change=-0.74(即 332.39 - 333.13),changePercent=-0.2221355(即 -0.74 / 333.13 * 100)。它衡量的是当日开盘买入持有至收盘的日内涨跌,不包含前一交易日收盘到今日开盘的隔夜跳空(Overnight Gap)。做标准日频因子回测时,切勿直接拿 changePercent 当日收益率,必须用相邻交易日的 close 计算环比。
经逐日验算(如本页示例 (333.13 + 334.48 + 329.59 + 332.39) / 4 = 332.1475 ≈ 332.15),本接口已结算日线的 vwap 为四价简单均值而非逐笔成交量加权均价(详见 FMP 与 Massive 日线复权及 VWAP 算法实测对比)。若策略依赖真实的成交量加权 VWAP,请调用 1 Min Interval Stock Chart(个股分时1分钟线)按 sum(close * volume) / sum(volume) 自行合成。
本接口支持查询已退市股票退市前的历史日线(如硅谷银行 SIVBQ、动视暴雪 ATVI)。构建多年回测管线时,应先调 Delisted Companies(退市公司清单)与 Historical S&P 500(标普500成分变动)还原历史真实股票池(实战步骤见 如何消除美股回测中的幸存者偏差)。
返回数据
10 个字段本接口示例响应共包含 10 个字段(数值型 8 个,文本/日期/布尔型 2 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
date | string | "2026-07-30" | 日期 |
open | number | 333.13 | 开盘价 |
high | number | 334.48 | 最高价 |
low | number | 329.59 | 最低价 |
close | number | 332.39 | 收盘价 |
volume | number | 29207295 | 成交量 |
change | number | -0.74 | 涨跌额 |
changePercent | number | -0.2221355 | 涨跌幅(%) |
vwap | number | 332.15 | 成交量加权均价 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"date": "2026-07-30",
"open": 333.13,
"high": 334.48,
"low": 329.59,
"close": 332.39,
"volume": 29207295,
"change": -0.74,
"changePercent": -0.2221355,
"vwap": 332.15
}
]常见问题解答(FAQ)
3 个问题为什么拆股日(如 NVDA 1 拆 10)拉出来的历史价格没有出现断崖暴跌?
因为本接口(/stable/historical-price-eod/full)默认已对历史拆合股做前复权平滑调整(Split-Adjusted),同时把历史成交量按拆股比例反向放大。如果你需要拆股前在交易所挂牌的原始未调整价格,请调用同模块下的 Unadjusted Stock Price(未复权日线行情,/apis/unadjusted-stock-price/)。
为什么交易时段内拉取当天日线,open 和 vwap 在收盘后会发生微小变化?
在美股盘中交易时段(美东 09:30–16:00),最新一根日线反映的是盘中实时快照(此时 vwap 暂按 (high+low+close)/3 估算);待美东 16:00 收盘集合竞价定盘结算后,官方会以交易所最终官方定盘价刷新该根 K 线,并将 vwap 重算为 (open+high+low+close)/4。
高股息策略回测应该用本接口还是 Dividend Adjusted Price Chart(分红复权日K线)?
应使用 Dividend Adjusted Price Chart(分红复权日K线,/apis/dividend-adjusted-price-chart/)。本接口仅做了拆合股复权,未将历史现金分红复权进价格序列;对高股息价值股或宽基 ETF(如 SPY、SCHD)做 5 年以上回测时,忽略现金分红再投资会显著低估策略真实总回报(Total Return)。
同模块相关接口对比
End Of Day本接口路径 /stable/historical-price-eod/full,必填参数 symbol。 同一模块「End Of Day」下共 4 个接口,下表列出其余 3 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 日线行情(精简版)Stock Chart Light | /stable/historical-price-eod/light | 指定股票的极简版日线历史行情序列,仅保留交易日期、收盘价与成交量三个核心维度 |
| 未复权日线行情Unadjusted Stock Price | /stable/historical-price-eod/non-split-adjusted | 指定股票未经任何拆股、合股或分红调整的原始历史日线行情 |
| 分红复权日K线Dividend Adjusted Price Chart | /stable/historical-price-eod/dividend-adjusted | 同时完成拆合股调整与现金分红除息复权的日线历史行情序列 |