Stock Price Change股价涨跌

该接口一次返回单只股票在 1D、5D、1M、3M、6M、YTD、1Y、3Y、5Y、10Y 及历史最长区间的累计涨跌幅百分比,无需拉取日线即可直接用于动量因子打分。

GEThttps://quote-fmp.com/stable/stock-price-change?symbol=AAPL

数据更新周期

3 Hours

接口说明

  • 实时监控:跟踪不同时间间隔(如 1 天、5 天、1 个月直至 10 年)的股价涨跌幅与涨跌值,传入 symbol 后可呈现 1D(近1日涨跌幅)、5D(近5日涨跌幅)与 1M(近1月涨跌幅) 等核心指标,辅助买方研究员快速核验标的基本面。
  • 投资策略:利用数据识别股票表现趋势,依据短期与长期价格变动做出决策,围绕 5D(近5日涨跌幅)与 1M(近1月涨跌幅) 等字段,可在回测中还原历史任意时点的真实截面。
  • 对比分析:比较多个时间段的股价变化,评估股票的长期表现,相应调整投资组合或策略,实务中常与同模块的「股票报价」联合调用,先做广度筛查再下钻单标明细。
  • 关联数据线接口:Full Cryptocurrency Quotes(加密货币批量报价) · Full Forex Quote(外汇批量报价) · Global Exchange Market Hours(全球交易所交易时段) · Company Profile Data(公司概况)

请求参数

1 个参数
参数类型要求示例说明
symbolstring必填AAPL证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS)

调用代码示例

Python 关键代码

针对股价涨跌,向 /stable/stock-price-change 传入必填 symbol后,响应提供 1D(近 1 日涨跌幅)、5D(近 5 日涨跌幅)、1M(近 1 月涨跌幅)(样本 1D=-1.8732)。

Python(核心参数与字段清洗逻辑)
resp = requests.get(
    "https://quote-fmp.com/stable/stock-price-change",
    params={"symbol": "AAPL", "apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 1D(近 1 日涨跌幅)
df["1D"] = pd.to_numeric(df["1D"], errors="coerce")

参数使用和避坑

2 组参数组合 · 2 条避坑

以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:

投研场景Query 参数组合示例返回数据特征与用途
获取 AAPL 最新股价涨跌记录symbol=AAPL通过 symbol=AAPL 访问 /stable/stock-price-change,一次拿齐 股价涨跌 的 1D、5D、1M 等核心列。
带 .HK 后缀查询港股标的股价涨跌symbol=0700.HK针对非美股标的传入 0700.HK,从 /stable/stock-price-change 提取对应的 1D、5D、1M。
参数与空值防守股价涨跌(共 12 列):查询条件与 1D 边界

股价涨跌端点 /stable/stock-price-change(必填 symbol)单次返回 1D 等 12 项属性;在自动化脚本中建议先校验返回列表长度再提取字段。

落库主键与口径归档股价涨跌:(symbol) 唯一索引与 1D(近 1 日涨跌幅)口径

在本地数据仓库归档股价涨跌时,以 (symbol) 去重可防止重跑产生脏数据;其中 1D(近 1 日涨跌幅,如 -1.8732)为原始未缩写数值。

返回数据

12 个字段

本接口示例响应共包含 12 个字段(数值型 11 个,文本/日期/布尔型 1 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。

字段类型示例值说明
symbolstring"AAPL"证券代码
1Dnumber-1.8732近 1 日涨跌幅
5Dnumber3.12782近 5 日涨跌幅
1Mnumber14.68586近 1 月涨跌幅
3Mnumber22.29777近 3 月涨跌幅
6Mnumber27.89233近 6 月涨跌幅
ytdnumber22.06835今年以来涨跌幅
1Ynumber58.74432近 1 年涨跌幅
3Ynumber68.92594近 3 年涨跌幅
5Ynumber127.51612近 5 年涨跌幅
10Ynumber1151.81068近 10 年涨跌幅
maxnumber258454.74094上市以来涨跌幅
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"1D": -1.8732,
"5D": 3.12782,
"1M": 14.68586,
"3M": 22.29777,
"6M": 27.89233,
"ytd": 22.06835,
"1Y": 58.74432,
"3Y": 68.92594,
"5Y": 127.51612,
"10Y": 1151.81068,
"max": 258454.74094
}
]

常见问题解答(FAQ)

2 个问题
想拉取「Single Quote」相关数据,应该调股价涨跌(/stable/stock-price-change)还是 股票报价?

股价涨跌 对应路径 /stable/stock-price-change(必填 symbol),涵盖 1D(-1.8732)、5D(3.12782)等 12 列;Stock Quote(股票报价) 对应 /stable/quote(必填 symbol,共 17 列)。

如何基于 /stable/stock-price-change 构建稳定的股价涨跌定时采集与历史补数任务?

回填或同步 股价涨跌 时,请传入目标证券 symbol 访问 /stable/stock-price-change 采集单票数据;对返回的 1D(近 1 日涨跌幅)序列,建议先做排序核对再参与计算。

同模块相关接口对比

Single Quote

本接口路径 /stable/stock-price-change,必填参数 symbol。 同一模块「Single Quote」下共 5 个接口,下表列出其余 4 个, 按粒度与查询维度对比,避免选错接口。

接口路径核心差异与适用场景
股票报价Stock Quote/stable/quote个股的实时行情数据,最新价格、涨跌与成交量,数据实时更新
精简报价Stock Quote Short/stable/quote-short单只股票的极简实时行情快照,仅保留最新成交价、涨跌额与当日累计成交量三个核心字段
盘后逐笔成交Aftermarket Trade/stable/aftermarket-trade盘后交易时段的实时成交明细,成交价、成交规模与成交时间戳等关键信息
盘后报价Aftermarket Quote/stable/aftermarket-quote正常交易时段之外的股票报价,买卖价、成交量等关键数据实时更新

Quote(实时行情)全部接口目录 →

需要稳定访问 股价涨跌 数据?注册即可获取专属 API Key,免费体验全部接口。
免费试用 1 个月