Stock Batch Quote股票批量报价
该接口单次请求返回多只股票的实时报价:现价、成交量、日内最高最低价、50 日与 200 日均线等详细数据一并获取,适合跟踪大型投资组合或同时监控多只股票。
https://quote-fmp.com/stable/batch-quote?symbols=AAPL数据更新周期
Real-Time · 实时更新
接口说明
- 投资组合监控:实时跟踪多只股票,适合需要同时监控多个持仓的投资者或投资组合经理,传入
symbols后可下发name(名称)、price(最新价)与changePercentage(涨跌幅(%)) 等标准化字段,可无缝接入实盘风控与预警系统。 - 数据获取高效:不必发起多次调用,单次请求即可获取多家公司的详细股票数据,降低复杂度,借助
price(最新价)与changePercentage(涨跌幅(%)) 等数值,方便研究员在长周期序列上识别趋势拐点。 - 全面的股票洞察:每只股票均可获取详细数据,包括现价、成交量、日内最高/最低价、50 日与 200 日均线等。
- 跨模块关联接口:Aftermarket Quote(盘后报价) · Stock Price Change(股价涨跌) · Global Exchange Market Hours(全球交易所交易时段) · Company Profile Data(公司概况)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbols | string | 必填 | AAPL | 一个或多个证券代码,多个代码用逗号分隔(支持逗号拼接多只标的代码并发查询,单次建议控制在 50~100 只以内) |
调用代码示例
Python 关键代码调用 股票批量报价 端点 /stable/batch-quote(必填 symbols),响应包含 name(名称)、price(最新价)、changePercentage(涨跌幅(%)) 等 17 个属性。
resp = requests.get(
"https://quote-fmp.com/stable/batch-quote",
params={"symbols": "AAPL", "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 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 科技龙头组合(AAPL,MSFT,NVDA)并发查询股票批量报价 | symbols=AAPL,MSFT,NVDA | 在 symbols 中逗号拼接多股代码请求 /stable/batch-quote,一次返回 name、price、changePercentage(如 name=Apple Inc.)。 |
| 跨行业权重股(JPM,BRK-B,XOM)批量拉取股票批量报价 | symbols=JPM,BRK-B,XOM | 单次请求并发刷新金融与能源龙头的 name、price、changePercentage 等 17 个字段。 |
| 港股组合(0700.HK,9988.HK)跨市场批量股票批量报价 | symbols=0700.HK,9988.HK | 组合携带 .HK 后缀的证券代码,从 /stable/batch-quote 批量提取 name、price、changePercentage。 |
调用股票批量报价接口 /stable/batch-quote(必填 symbols),可取回 name 等共 17 项指标;批量轮询时请结合网关 RPM 配额控制并发度。
归档股票批量报价(端点 /stable/batch-quote)推荐采用 (symbol, exchange, name) 作为复合主键;对 price(最新价)等 14 个数值列需防范极端空值。
返回数据
17 个字段本接口示例响应共包含 17 个字段(数值型 14 个,文本/日期/布尔型 3 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
name | string | "Apple Inc." | 名称 |
price | number | 331.85501 | 最新价 |
changePercentage | number | -1.8732 | 涨跌幅(%) |
change | number | -6.33498 | 涨跌额 |
volume | number | 28718014 | 成交量 |
dayLow | number | 329.59 | 当日最低价 |
dayHigh | number | 334.48 | 当日最高价 |
yearHigh | number | 344.57 | 52 周最高 |
yearLow | number | 201.5 | 52 周最低 |
marketCap | number | 4874072686740 | 总市值 |
priceAvg50 | number | 308.5888 | 50 日均价 |
priceAvg200 | number | 277.21344 | 200 日均价 |
exchange | string | "NASDAQ" | 交易所代码 |
open | number | 333.13 | 开盘价 |
previousClose | number | 338.18999 | 昨收价 |
timestamp | number | 1785430812 | 时间戳 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"name": "Apple Inc.",
"price": 331.85501,
"changePercentage": -1.8732,
"change": -6.33498,
"volume": 28718014,
"dayLow": 329.59,
"dayHigh": 334.48,
"yearHigh": 344.57,
"yearLow": 201.5,
"marketCap": 4874072686740,
"priceAvg50": 308.5888,
"priceAvg200": 277.21344,
"exchange": "NASDAQ",
"open": 333.13,
"previousClose": 338.18999,
"timestamp": 1785430812
}
]常见问题解答(FAQ)
2 个问题调用股票批量报价与 股票批量精简报价 有何差异?/stable/batch-quote 重点输出哪些指标?
访问 /stable/batch-quote 拉取股票批量报价(必填 symbols)可拿到 name(Apple Inc.)与 price;若需 /stable/batch-quote-short(必填 symbols)的 4 项数据,可改调 Stock Batch Quote Short(股票批量精简报价)。
如何利用 /stable/batch-quote 的参数机制,高效完成股票批量报价的冷启动回填与盘后同步?
无论冷启动还是增量更新,都可将目标股票池按 50~100 只分批拼入 symbols 调用 /stable/batch-quote;读取 name(样本 Apple Inc.)后建议先过滤无效记录再入库。
同模块相关接口对比
Batch本接口路径 /stable/batch-quote,必填参数 symbols。 同一模块「Batch」下共 4 个接口,下表列出其余 3 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 股票批量精简报价Stock Batch Quote Short | /stable/batch-quote-short | 一次请求返回多只股票的短格式实时报价,只取现价、涨跌与成交量等关键数据,快速掌握市场动向 |
| 盘后批量成交Batch Aftermarket Trade | /stable/batch-aftermarket-trade | 一次请求返回多只股票的盘后交易明细,成交价、成交量与成交时间戳可同时跟踪多家公司 |
| 盘后批量报价Batch Aftermarket Quote | /stable/batch-aftermarket-quote | 一次请求返回多只股票的盘后实时报价,买卖价、成交量等关键盘后数据一并获取 |