Biggest Stock Gainers涨幅榜
该接口返回各大交易所股价涨幅最大的股票实时名单：现价、涨跌额、涨跌幅及公司名称、代码等信息一并获取，用于捕捉市场领涨股与动量机会。
https://quote-fmp.com/stable/biggest-gainers数据更新周期
3 Minutes
接口说明
- 涨幅榜名单：实时获取股价涨幅最高的股票列表，调用后可解析出
price（最新价）、name（名称）与change（涨跌额） 等字段，适合作为回测框架的基础数据层。 - 实时价格与涨跌幅：跟踪每只股票的现价、涨跌额与涨跌幅，配合
name（名称）与change（涨跌额） 等返回项，能高效支撑同行业标的横向比对。 - 分交易所数据：查看纳斯达克（NASDAQ）、纽交所（NYSE）等特定交易所的涨幅榜，在策略信号生成环节，与「成交活跃榜」配合使用可有效过滤单指标噪音。
- 配套投研接口：Historical Sector PE（板块历史市盈率） · Historical Industry PE（细分行业历史市盈率） · Available Sectors（可用板块清单） · Available Industries（可用细分行业清单）
调用代码示例
Python 关键代码示例向 /stable/biggest-gainers 发起涨幅榜请求（仅 apikey），并清洗 price（最新价）、name（名称）、change（涨跌额） 等核心列。
resp = requests.get(
"https://quote-fmp.com/stable/biggest-gainers",
params={"apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 price（最新价）
df["price"] = pd.to_numeric(df["price"], errors="coerce")参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 一次性拉取全量涨幅榜初始化本地主表 | GET /stable/biggest-gainers（免参数） | 直接请求 /stable/biggest-gainers 即返回全表，含 price、name、change 等 6 列；建库或每日全量覆盖时无需拼接任何 Query 参数。 |
| 以 symbol 为唯一键覆盖写入，避免全表重复 | GET /stable/biggest-gainers → upsert on symbol | 全表每轮返回 symbol（样本 MOTS）等 6 列，落库时以 symbol 作唯一键覆盖；同模块无参数相近的接口，单点补数只能重拉全表。 |
| 落库后自检：symbol 唯一性与 price 空值率 | GET /stable/biggest-gainers → count(distinct symbol) / null_ratio(price) | 本表共 6 列。落库后先比对 count(distinct symbol) 与总行数确认无重复；再统计 price（样本 0.0002）的空值比例，判断该批次是否拉到完整截面。 |
/stable/biggest-gainers 返回的涨幅榜数据集（免业务参数）以 price（样本 0.0002）为核心，入库或关联前建议先做缺失值检测。
同步 /stable/biggest-gainers 的 6 个字段入库时，依赖 (symbol, exchange, name) 实现幂等去重；核心数值 price（如 0.0002）可直接用于量化回测计算。
返回数据
6 个字段本接口示例响应共包含 6 个字段（数值型 3 个，文本/日期/布尔型 3 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "MOTS" | 证券代码 |
price | number | 0.0002 | 最新价 |
name | string | "Motus GI Holdings, Inc." | 名称 |
change | number | 0.0001 | 涨跌额 |
changesPercentage | number | 100 | 涨跌幅（%） |
exchange | string | "OTC" | 交易所代码 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "MOTS",
"price": 0.0002,
"name": "Motus GI Holdings, Inc.",
"change": 0.0001,
"changesPercentage": 100,
"exchange": "OTC"
}
]常见问题解答（FAQ）
2 个问题涨幅榜（/stable/biggest-gainers）相比同模块的 跌幅榜，在查询维度与字段上差在哪？
涨幅榜 走 /stable/biggest-gainers 端点（免业务参数），单条含 price、name、change 共 6 项字段；同模块的 Biggest Stock Losers（跌幅榜） 走 /stable/biggest-losers（无必填参数，6 项字段）。
针对 /stable/biggest-gainers（涨幅榜），工程脚本中如何避免漏数或无效轮询？
生产调度中通常直接请求无参端点 /stable/biggest-gainers 拉取全表快照并缓存；每次拉回 price（样本 0.0002）后，按时间或代码水位线增量推进。
同模块相关接口对比
Market Leaders本接口路径 /stable/biggest-gainers，无必填参数。 同一模块「Market Leaders」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。