Biggest Stock Losers跌幅榜
该接口返回各大交易所股价跌幅最大的股票实时名单:现价、涨跌额、跌幅及公司名称、代码、所属交易所等信息一并获取,用于追踪领跌股并评估短期机会与风险。
https://quote-fmp.com/stable/biggest-losers数据更新周期
3 Minutes
接口说明
- 跌幅榜名单:实时获取各大交易所股价跌幅最大的股票列表,调用后可拿到
price(最新价)、name(名称)与change(涨跌额) 等明细项,便于在 Python 或 SQL 中直接聚合。 - 实时价格变动:跟踪每只股票的现价、总跌价与百分比跌幅,围绕
name(名称)与change(涨跌额) 等字段,可在回测中还原历史任意时点的真实截面。 - 分交易所数据:查看纳斯达克(NASDAQ)、纽交所(NYSE)等交易所的跌幅榜,针对深度投研场景,搭配同模块的「涨幅榜」能进一步拓宽样本对比维度。
- 关联数据线接口:Industry Performance Snapshot(细分行业表现快照) · Historical Market Sector Performance(板块历史表现) · Stock Screener(条件选股) · S&P 500 Index(标普500成分股)
调用代码示例
Python 关键代码拉取 跌幅榜 只需访问 /stable/biggest-losers(仅 apikey),结果涵盖 price(最新价)、name(名称)、change(涨跌额)(price=0.0002)。
resp = requests.get(
"https://quote-fmp.com/stable/biggest-losers",
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-losers(免参数) | /stable/biggest-losers 为一次性全量输出(6 列,含 price、name、change);首次建库与周期性覆盖都走它。 |
| 以 symbol 为唯一键覆盖写入,避免全表重复 | GET /stable/biggest-losers → upsert on symbol | symbol 在全表内唯一(样本 SPEC),6 列按该键 upsert 即可幂等;无法按单条重取,补数须重跑全量。 |
| 落库后自检:symbol 唯一性与 price 空值率 | GET /stable/biggest-losers → count(distinct symbol) / null_ratio(price) | 本表共 6 列。落库后先比对 count(distinct symbol) 与总行数确认无重复;再统计 price(样本 0.0002)的空值比例,判断该批次是否拉到完整截面。 |
在跌幅榜(/stable/biggest-losers)中,首条样本的 price 为 0.0002;批量采集时请按免业务参数校验传参格式。
存储跌幅榜(/stable/biggest-losers)数据时,联合键 (symbol, exchange, name) 能唯一标识每条截面;注意 price(最新价,样本 0.0002)采用原始计价单位。
返回数据
6 个字段本接口示例响应共包含 6 个字段(数值型 3 个,文本/日期/布尔型 3 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "SPEC" | 证券代码 |
price | number | 0.0002 | 最新价 |
name | string | "Spectaire Holdings Inc." | 名称 |
change | number | -0.002 | 涨跌额 |
changesPercentage | number | -90.90909 | 涨跌幅(%) |
exchange | string | "OTC" | 交易所代码 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "SPEC",
"price": 0.0002,
"name": "Spectaire Holdings Inc.",
"change": -0.002,
"changesPercentage": -90.90909,
"exchange": "OTC"
}
]常见问题解答(FAQ)
2 个问题使用「Market Leaders」接口族时,跌幅榜(免业务参数)与 涨幅榜(无必填参数)怎么选?
按输入参数看,/stable/biggest-losers(跌幅榜)为免业务参数,产出 price(0.0002)等 6 列;/stable/biggest-gainers(Biggest Stock Gainers(涨幅榜))为无必填参数,产出 6 列。
在自动化流水线中对接跌幅榜(/stable/biggest-losers),怎样平衡拉取深度与请求效率?
最佳实践是直接请求无参端点 /stable/biggest-losers 拉取全表快照并缓存;解析响应中的 price(如 0.0002)前,请确保对异常空值和网络超时设置退避重试。
同模块相关接口对比
Market Leaders本接口路径 /stable/biggest-losers,无必填参数。 同一模块「Market Leaders」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。