Stock Price Change股价涨跌
该接口一次返回单只股票在 1D、5D、1M、3M、6M、YTD、1Y、3Y、5Y、10Y 及历史最长区间的累计涨跌幅百分比,无需拉取日线即可直接用于动量因子打分。
https://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 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
调用代码示例
Python 关键代码针对股价涨跌,向 /stable/stock-price-change 传入必填 symbol后,响应提供 1D(近 1 日涨跌幅)、5D(近 5 日涨跌幅)、1M(近 1 月涨跌幅)(样本 1D=-1.8732)。
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。 |
股价涨跌端点 /stable/stock-price-change(必填 symbol)单次返回 1D 等 12 项属性;在自动化脚本中建议先校验返回列表长度再提取字段。
在本地数据仓库归档股价涨跌时,以 (symbol) 去重可防止重跑产生脏数据;其中 1D(近 1 日涨跌幅,如 -1.8732)为原始未缩写数值。
返回数据
12 个字段本接口示例响应共包含 12 个字段(数值型 11 个,文本/日期/布尔型 1 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
1D | number | -1.8732 | 近 1 日涨跌幅 |
5D | number | 3.12782 | 近 5 日涨跌幅 |
1M | number | 14.68586 | 近 1 月涨跌幅 |
3M | number | 22.29777 | 近 3 月涨跌幅 |
6M | number | 27.89233 | 近 6 月涨跌幅 |
ytd | number | 22.06835 | 今年以来涨跌幅 |
1Y | number | 58.74432 | 近 1 年涨跌幅 |
3Y | number | 68.92594 | 近 3 年涨跌幅 |
5Y | number | 127.51612 | 近 5 年涨跌幅 |
10Y | number | 1151.81068 | 近 10 年涨跌幅 |
max | number | 258454.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 | 正常交易时段之外的股票报价,买卖价、成交量等关键数据实时更新 |