Williams威廉指标(Williams %R)

该接口按指定时间周期与窗口长度，返回衡量当前收盘价在过去一段周期最高价与最低价区间内相对位置的威廉指标（Williams %R，取值 -100～0）。适用于震荡市反转点捕捉、趋势回调买点确认与短期动能枯竭预警。

GEThttps://quote-fmp.com/stable/technical-indicators/williams?symbol=AAPL&periodLength=10&timeframe=1day

数据更新周期

Real-Time · 实时更新

接口说明

  • 威廉超买超卖指标（Williams %R）：衡量当前收盘价在过去 N 个周期最高价与最低价区间内的相对位置（取值 -100 至 0，-20 以上为超买区、-80 以下为超卖区），适合在震荡行情中捕捉短线情绪极值与反转买点。
  • 顺大势逆小势的波段回调入场信号：在由长期均线确认的上升趋势中，当威廉指标短暂跌入 -80 下方的超卖区并重新向上穿越阈值时，常被量化波段策略用作高盈亏比的顺势回踩买入信号。
  • 跨周期超买超卖共振与情绪过热过滤：通过同时监控日线与小时线级别的威廉指标读数，可在多周期同时触及极端超买阈值时发出短期追高风险警示，优化执行算法的建仓节奏。
  • 配套投研接口：Stock Price and Volume Data（日线完整行情） · Stock Quote（股票报价）

请求参数

5 个参数
参数类型要求示例说明
symbolstring必填AAPL证券代码，例如 AAPL 或 MSFT（美股直传代码如 AAPL；港股/英股/A股须带交易所后缀，如 0700.HK、600519.SS）
periodLengthnumber必填10技术指标的回看周期长度。例如简单均线 periodLength=10 表示计算 10 个周期的均值。
timeframestring必填1min,5min,15min,30min,1hour,4hour,1day行情时间粒度或回溯区间，如 1min、1day、1year（单值时间粒度：可选 1min / 5min / 15min / 30min / 1hour / 4hour / 1day，每次仅传单值）
fromdate可选2026-03-01查询起始日期，格式 YYYY-MM-DD，包含当天。
todate可选2026-06-01查询结束日期，格式 YYYY-MM-DD，包含当天。

调用代码示例

Python 关键代码

上方代码调用 /stable/technical-indicators/williams（必填 symbol, periodLength, timeframe），将威廉指标(Williams %R)的 williams（威廉指标（Williams %R））、open（开盘价）、high（最高价） 载入 DataFrame。

Python（核心参数与字段清洗逻辑）
resp = requests.get(
    "https://quote-fmp.com/stable/technical-indicators/williams",
    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["williams"] = pd.to_numeric(df["williams"], errors="coerce")
    result = df[["date", "williams"]].sort_values("date").reset_index(drop=True)
    print(result)

参数使用和避坑

3 组参数组合 · 2 条避坑

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

投研场景Query 参数组合示例返回数据特征与用途
日线粒度（1day）计算威廉指标(Williams %R)symbol=AAPL&periodLength=14&timeframe=1day向 /stable/technical-indicators/williams 传 timeframe=1day&periodLength=14，产出日线级 williams、open、high（样本 williams=-48.29500396510714）。
小时级（1hour）20 周期威廉指标(Williams %R)序列symbol=AAPL&periodLength=20&timeframe=1hour切换 timeframe=1hour、窗口 20，从 /stable/technical-indicators/williams 提取日内波段 williams、open、high 读数。
5 分钟级（5min）短线威廉指标(Williams %R)信号symbol=AAPL&periodLength=10&timeframe=5min设定 timeframe=5min&periodLength=10，高频计算盘中 williams、open、high 异动拐点。
时序与查询边界执行威廉指标(Williams %R)查询：williams 滚动计算前的升序排列

执行 /stable/technical-indicators/williams 拉取威廉指标(Williams %R)（必填 symbol, periodLength, timeframe），响应涵盖 williams（-48.29500396510714）等 7 列；对返回序列做滚动窗口计算前请先按日期升序排列。

落库主键与口径解析威廉指标(Williams %R)：williams 精度与 (symbol, timeframe, date) 唯一键

/stable/technical-indicators/williams 产出的 7 项字段（含 williams=-48.29500396510714、open=333.13）在写入宽表前，应按 (symbol, timeframe, date) 执行去重校验。

返回数据

7 个字段

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

字段类型示例值说明
datestring"2026-07-30 00:00:00"日期
opennumber333.13开盘价
highnumber334.48最高价
lownumber329.59最低价
closenumber332.39收盘价
volumenumber29207295成交量
williamsnumber-48.29500396510714威廉指标（Williams %R）
查看响应数据示例（原始 JSON）
[
{
"date": "2026-07-30 00:00:00",
"open": 333.13,
"high": 334.48,
"low": 329.59,
"close": 332.39,
"volume": 29207295,
"williams": -48.29500396510714
}
]

常见问题解答（FAQ）

2 个问题
威廉指标的核心输出是什么，与价格字段有什么区别？

核心结果是 williams：收盘价在近期高低区间中的相对位置，不是价格均线。open、high、low、close 用来交代对应价格背景，不能代替指标本身。使用示例先提取 date 与 williams，再根据研究任务决定是否关联行情；不要仅比较两个接口都返回几个字段来选择指标。

比较两组威廉指标结果时，需要固定哪些请求条件？

保存 symbol、timeframe、periodLength 和查询区间。相同的 periodLength 在日线与小时线上代表不同时间跨度；比较窗口参数时应固定其他条件，再按 date 对齐结果。遇到缺失先检查标的覆盖、原始价格与计算窗口，不将缺失值直接补成零或据此生成信号。

同模块相关接口对比

Technical Indicators

本接口路径 /stable/technical-indicators/williams，必填参数 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按指定时间周期与回看窗口，返回衡量价格上涨与下跌动量相对强弱的相对强弱指数
标准差(SD)Standard Deviation/stable/technical-indicators/standarddeviation按指定时间周期与回看窗口，计算并返回证券收盘价序列的滚动样本标准差
平均趋向指数(ADX)Average Directional Index/stable/technical-indicators/adx按指定时间周期与窗口长度，计算并返回衡量市场趋势绝对强度的平均趋向指数

TechnicalIndicators（技术指标）全部接口目录 →

需要稳定访问 威廉指标(Williams %R) 数据？注册即可获取专属 API Key，免费体验全部接口。
免费试用 1 个月