Full Commodities Quotes大宗商品批量报价
该接口一次请求即可返回多种大宗商品的实时行情：最新价格、涨跌变化、成交量等关键指标，适合需要同时监控多个商品品种的投资者、交易员和分析师。
https://quote-fmp.com/stable/batch-commodity-quotes数据更新周期
N/A · 不适用固定周期
接口说明
- 批量报价：单次接口调用返回多种商品的报价，大幅简化多品种行情追踪，调用后可调取
price（最新价）、change（涨跌额）与volume（成交量） 等核心数值，方便与本地历史研究库按主键对齐。 - 实时更新：价格即时更新，始终基于最新的市场数据，读取
price（最新价）与change（涨跌额） 等结构化数值后，可直接对接估值模型或风控阈值检查。 - 市场指标：除价格外还提供涨跌变化、成交量等附加指标，自动化脚本中可与「全指数报价」按序调取，一次性补齐该业务模块的核心字段。
- 配套投研接口：Stock Quote（股票报价） · Stock Quote Short（精简报价） · Global Exchange Market Hours（全球交易所交易时段） · Company Profile Data（公司概况）
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
short | boolean | 可选 | true | 是否返回精简字段集：true 返回核心字段（适用于批量行情，减小响应体积），false 返回完整字段。 |
调用代码示例
Python 关键代码按示例请求 /stable/batch-commodity-quotes 获取大宗商品批量报价（可选 short），DataFrame 包含 price（最新价）、change（涨跌额）、volume（成交量）（price=16.91）。
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）需先经过非空校验再送入下游模块。
/stable/batch-commodity-quotes 单行含 4 个属性（如 price=16.91）；PostgreSQL 或 ClickHouse 建表推荐以 (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 个问题在对接「Batch List」数据线时，大宗商品批量报价与 交易所全量报价 各自解决什么问题？
大宗商品批量报价 通过 /stable/batch-commodity-quotes（可选 short）返回 price（最新价）、change（涨跌额）等 4 列明细；同模块的 Exchange Stock Quotes（交易所全量报价） 则通过 /stable/batch-exchange-quote（必填 exchange）提供配套数据。
想要完整归档大宗商品批量报价，请求 /stable/batch-commodity-quotes 时在参数调度上有什么最佳实践？
在采集 大宗商品批量报价 时，可传入精确匹配的 short 参数调用 /stable/batch-commodity-quotes；若遇到休市日或未披露窗口返回 []，脚本应记录水位线并平滑跳过。
同模块相关接口对比
Batch List本接口路径 /stable/batch-commodity-quotes，无必填参数。 同一模块「Batch List」下共 7 个接口，下表列出其余 6 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 交易所全量报价Exchange Stock Quotes | /stable/batch-exchange-quote | 一次返回指定交易所所有上市股票的实时报价，包括价格、成交量与涨跌信息 |
| 公募基金报价Mutual Fund Price Quotes | /stable/batch-mutualfund-quotes | 各类公募基金的实时价格与表现数据，包括最新价格、涨跌变化等关键信息，便于监控基金行情 |
| ETF实时报价ETF Price Quotes | /stable/batch-etf-quotes | 各 ETF 的实时价格与表现数据，包括最新价格、涨跌幅等关键行情信息 |
| 加密货币批量报价Full Cryptocurrency Quotes | /stable/batch-crypto-quotes | 一次请求返回多种加密货币的实时行情，最新价格、涨跌变化与成交量 |
| 外汇批量报价Full Forex Quote | /stable/batch-forex-quotes | 一次请求返回多个货币对的实时报价，价格、涨跌与成交量一并获取 |
| 全指数报价Full Index Quotes | /stable/batch-index-quotes | 一次请求返回全部可用股指的实时报价 |