All Commodities Quotes大宗商品批量报价
该接口一次请求即可返回多种大宗商品的实时行情：最新价格、涨跌变化、成交量等关键指标，适合需要同时监控多个商品品种的投资者、交易员和分析师。
https://quote-fmp.com/stable/batch-commodity-quotes数据更新周期
Real-Time · 实时更新
接口说明
- 批量报价：单次接口调用返回多种商品的报价，大幅简化多品种行情追踪，调用后可返回
price（最新价）、change（涨跌额）与volume（成交量） 等关键项，满足策略底表自动化更新需求。 - 实时更新：价格即时更新，始终基于最新的市场数据，串联
price（最新价）与change（涨跌额） 等返回指标，便于搭建按日或按季刷新的自动化投研看板。 - 市场指标：除价格外还提供涨跌变化、成交量等附加指标，在策略信号生成环节，与「大宗商品快速报价」配合使用可有效过滤单指标噪音。
- 配套投研接口：Commodities List（大宗商品清单） · Light Chart（大宗商品精简日线） · Forex Quote（外汇实时报价） · COT Report（COT 持仓报告）
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
short | boolean | 可选 | true | 是否返回精简字段集：true 返回核心字段（适用于批量行情，减小响应体积），false 返回完整字段。 |
调用代码示例
Python 关键代码上方代码调用 /stable/batch-commodity-quotes（可选 short），将大宗商品批量报价的 price（最新价）、change（涨跌额）、volume（成交量） 载入 DataFrame。
resp = requests.get(
"https://quote-fmp.com/stable/batch-commodity-quotes",
params={"short": "true", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 price（最新价）
df["price"] = pd.to_numeric(df["price"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 拉取大宗商品批量报价完整字段模式（short=false） | short=false | 设 short=false 请求 /stable/batch-commodity-quotes，返回包含 price、change、volume（price=16.91）在内的全量字段。 |
| 拉取大宗商品批量报价轻量级快照模式（short=true） | short=true | 设 short=true 调用 /stable/batch-commodity-quotes，仅保留核心价格与成交量以加速批量刷屏。 |
执行 /stable/batch-commodity-quotes 拉取大宗商品批量报价（可选 short），响应涵盖 price（16.91）等 4 列；作为前置白名单或快照使用时建议每日定时刷新。
/stable/batch-commodity-quotes 产出的 4 项字段（含 price=16.91、change=0.02）在写入宽表前，应按 (symbol) 执行去重校验。
返回数据
4 个字段本接口示例响应共包含 4 个字段（数值型 3 个，文本/日期/布尔型 1 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "DCUSD" | 证券代码 |
price | number | 16.91 | 最新价 |
change | number | 0.02 | 涨跌额 |
volume | number | 615 | 成交量 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "DCUSD",
"price": 16.91,
"change": 0.02,
"volume": 615
}
]常见问题解答（FAQ）
2 个问题大宗商品批量报价与 大宗商品报价 的端点路径（/stable/batch-commodity-quotes vs /stable/quote）和参数约束分别是怎样的？
调用 /stable/batch-commodity-quotes 获取大宗商品批量报价时（可选 short），您将拿到 price=16.91 等 4 列数据；而调用 Commodities Quote（大宗商品报价）则会拿到 17 列数据。
调用 /stable/batch-commodity-quotes 获取大宗商品批量报价，怎样根据参数特性控制单次返回的记录范围？
针对 大宗商品批量报价（/stable/batch-commodity-quotes），请传入精确匹配的 short 参数调用 /stable/batch-commodity-quotes；提取 price（16.91）与 change 后即可完成当期截面对齐。
同模块相关接口对比
Quotes本接口路径 /stable/batch-commodity-quotes，无必填参数。 同一模块「Quotes」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。