Standard Deviation标准差(SD)
该接口按指定时间周期与回看窗口,计算并返回证券收盘价序列的滚动样本标准差(Standard Deviation)。它是度量资产绝对价格波动幅度、构建布林带(Bollinger Bands)通道、识别波动率状态切换及动态调整头寸规模的基础算子。
https://quote-fmp.com/stable/technical-indicators/standarddeviation?symbol=AAPL&periodLength=10&timeframe=1day数据更新周期
Real-Time · 实时更新
接口说明
- 价格离散度与历史波动率度量:计算指定回看窗口内收盘价序列的标准差,直接量化标的在特定时间尺度上的价格波动剧烈程度,常用于布林带(Bollinger Bands)上下轨构建、头寸波动率目标配平与止损宽度动态调整。
- 量化风险平价与动态头寸管理基准:在头寸规模计算与止损距离设定中,利用该接口返回的实时价格波动标准差(结合当前股价归一化后),可实现「高波动期自动缩减敞口、低波动期适度放大头寸」的等风险权重配置。
- 多时间尺度波动率结构实时监测:支持在分钟级分时与日频序列上计算不同窗口长度的滚动标准差,协助交易团队实时监测财报发布前后的日内跳升波动与中长期波动率中枢漂移。
- 关联数据线接口:Stock Quote(股票报价) · Stock Price and Volume Data(日线完整行情)
请求参数
5 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
periodLength | number | 必填 | 10 | 技术指标的回看周期长度。例如简单均线 periodLength=10 表示计算 10 个周期的均值。 |
timeframe | string | 必填 | 1min,5min,15min,30min,1hour,4hour,1day | 行情时间粒度或回溯区间,如 1min、1day、1year(单值时间粒度:可选 1min / 5min / 15min / 30min / 1hour / 4hour / 1day,每次仅传单值) |
from | date | 可选 | 2026-03-01 | 查询起始日期,格式 YYYY-MM-DD,包含当天。 |
to | date | 可选 | 2026-06-01 | 查询结束日期,格式 YYYY-MM-DD,包含当天。 |
调用代码示例
Python 关键代码拉取 标准差(SD) 只需访问 /stable/technical-indicators/standarddeviation(必填 symbol, periodLength, timeframe),结果涵盖 standardDeviation(标准差)、open(开盘价)、high(最高价)(standardDeviation=5.675893674127448)。
resp = requests.get(
"https://quote-fmp.com/stable/technical-indicators/standarddeviation",
params={"symbol": "AAPL", "periodLength": 10, "timeframe": "1day", "from": "2026-03-01", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
if not df.empty:
df["standardDeviation"] = pd.to_numeric(df["standardDeviation"], errors="coerce")
result = df[["date", "standardDeviation"]].sort_values("date").reset_index(drop=True)
print(result)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 日线粒度(1day)计算标准差(SD) | symbol=AAPL&periodLength=14&timeframe=1day | 向 /stable/technical-indicators/standarddeviation 传 timeframe=1day&periodLength=14,产出日线级 standardDeviation、open、high(样本 standardDeviation=5.675893674127448)。 |
| 小时级(1hour)20 周期标准差(SD)序列 | symbol=AAPL&periodLength=20&timeframe=1hour | 切换 timeframe=1hour、窗口 20,从 /stable/technical-indicators/standarddeviation 提取日内波段 standardDeviation、open、high 读数。 |
| 5 分钟级(5min)短线标准差(SD)信号 | symbol=AAPL&periodLength=10&timeframe=5min | 设定 timeframe=5min&periodLength=10,高频计算盘中 standardDeviation、open、high 异动拐点。 |
在标准差(SD)(/stable/technical-indicators/standarddeviation)中,首条样本的 standardDeviation 为 5.675893674127448、open 为 333.13;批量采集时请按必填 symbol, periodLength, timeframe校验传参格式。
存储标准差(SD)(/stable/technical-indicators/standarddeviation)数据时,联合键 (symbol, timeframe, date) 能唯一标识每条截面;注意 standardDeviation(标准差,样本 5.675893674127448)采用原始计价单位。
返回数据
7 个字段本接口示例响应共包含 7 个字段(数值型 6 个,文本/日期/布尔型 1 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
date | string | "2026-07-30 00:00:00" | 日期 |
open | number | 333.13 | 开盘价 |
high | number | 334.48 | 最高价 |
low | number | 329.59 | 最低价 |
close | number | 332.39 | 收盘价 |
volume | number | 29207295 | 成交量 |
standardDeviation | number | 5.675893674127448 | 标准差 |
查看响应数据示例(原始 JSON)
[
{
"date": "2026-07-30 00:00:00",
"open": 333.13,
"high": 334.48,
"low": 329.59,
"close": 332.39,
"volume": 29207295,
"standardDeviation": 5.675893674127448
}
]常见问题解答(FAQ)
2 个问题价格标准差的核心输出是什么,与价格字段有什么区别?
核心结果是 standardDeviation:窗口内价格的离散程度,不等于收益率标准差或年化波动率。open、high、low、close 用来交代对应价格背景,不能代替指标本身。使用示例先提取 date 与 standardDeviation,再根据研究任务决定是否关联行情;不要仅比较两个接口都返回几个字段来选择指标。
比较两组价格标准差结果时,需要固定哪些请求条件?
保存 symbol、timeframe、periodLength 和查询区间。相同的 periodLength 在日线与小时线上代表不同时间跨度;比较窗口参数时应固定其他条件,再按 date 对齐结果。遇到缺失先检查标的覆盖、原始价格与计算窗口,不将缺失值直接补成零或据此生成信号。
同模块相关接口对比
Technical Indicators本接口路径 /stable/technical-indicators/standarddeviation,必填参数 symbol、periodLength、timeframe。 同一模块「Technical Indicators」下共 9 个接口,下表列出其余 8 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 简单移动平均线(SMA)Simple Moving Average | /stable/technical-indicators/sma | 按指定时间周期与回看窗口长度,直接计算并返回证券价格的简单移动平均线(SMA)历史序列 |
| 指数移动平均线(EMA)Exponential Moving Average | /stable/technical-indicators/ema | 按指定时间粒度与周期长度,返回对近期价格赋予更高指数衰减权重的指数移动平均线(EMA)序列 |
| 加权移动平均线(WMA)Weighted Moving Average | /stable/technical-indicators/wma | 按所选时间周期与窗口长度,返回采用算术线性递减权重的加权移动平均线(WMA)序列 |
| 双重指数移动平均线(DEMA)Double Exponential Moving Average | /stable/technical-indicators/dema | 计算并返回双指数移动平均线(DEMA)序列 |
| 三重指数移动平均线(TEMA)Triple Exponential Moving Average | /stable/technical-indicators/tema | 计算并返回三指数移动平均线(TEMA)序列 |
| RSI 相对强弱指数Relative Strength Index | /stable/technical-indicators/rsi | 按指定时间周期与回看窗口,返回衡量价格上涨与下跌动量相对强弱的相对强弱指数 |
| 威廉指标(Williams %R)Williams | /stable/technical-indicators/williams | 按指定时间周期与窗口长度,返回衡量当前收盘价在过去一段周期最高价与最低价区间内相对位置的威廉指标 |
| 平均趋向指数(ADX)Average Directional Index | /stable/technical-indicators/adx | 按指定时间周期与窗口长度,计算并返回衡量市场趋势绝对强度的平均趋向指数 |