Commodities Quote大宗商品报价
该接口返回全球各大交易所交易的全部大宗商品报价：最新价、最高价、最低价、开盘价等一手掌握，帮助投资者跟踪市场动向、发现投资机会。
https://quote-fmp.com/stable/quote?symbol=GCUSD数据更新周期
Real-Time · 实时更新
接口说明
- 商品价格：获取大宗商品报价，包括当前价格、最高价、最低价和开盘价，传入
symbol后可交付name（名称）、price（最新价）与changePercentage（涨跌幅（%）） 等结构化信息，降低多资产投研系统的数据接入复杂度。 - 跟踪市场动向：持续观察商品价格随时间的波动，把握趋势、做出有依据的判断，依据
price（最新价）与changePercentage（涨跌幅（%）） 等字段的变化斜率，可及时捕捉基本面或交易面边际变化。 - 发现投资机会：利用细致的商品价格数据，挖掘全球市场中的潜在投资机会，自动化脚本中可与「大宗商品批量报价」按序调取，一次性补齐该业务模块的核心字段。
- 关联数据线接口：1-Minute Interval Commodities Chart（大宗商品1分钟分时） · 5-Minute Interval Commodities Chart（大宗商品5分钟分时） · Treasury Rates（美国国债收益率） · Forex Quote（外汇实时报价）
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | GCUSD | 大宗商品行情合约代码，例如 GCUSD（黄金）、CLUSD（WTI 原油）、SIUSD（白银）、NGUSD（天然气）。 |
调用代码示例
Python 关键代码执行 /stable/quote 查询大宗商品报价（必填 symbol），直接产出 name（名称）、price（最新价）、changePercentage（涨跌幅（%）） 等 17 项字段。
resp = requests.get(
"https://quote-fmp.com/stable/quote",
params={"symbol": "GCUSD", "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 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 获取 GCUSD 最新大宗商品报价记录 | symbol=GCUSD | 通过 symbol=GCUSD 访问 /stable/quote，一次拿齐 大宗商品报价 的 name、price、changePercentage 等核心列。 |
| 切换主力品种 CLUSD（WTI原油）拉取大宗商品报价 | symbol=CLUSD | 改传 symbol=CLUSD 访问 /stable/quote，提取 WTI原油 的 name、price、changePercentage 做跨品种比对。 |
大宗商品报价（路径 /stable/quote，必填 symbol）输出 name（名称）等 17 列；在做多表横截面关联时，请确保主键字段类型一致。
在为大宗商品报价（/stable/quote）设计表结构时，以 (symbol, exchange, name) 唯一锁定记录，并对 price（最新价）与 changePercentage（涨跌幅（%）） 保留完整浮点精度。
返回数据
17 个字段本接口示例响应共包含 17 个字段（数值型 13 个，文本/日期/布尔型 4 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "GCUSD" | 证券代码 |
name | string | "Gold Futures" | 名称 |
price | number | 4168.3 | 最新价 |
changePercentage | number | 3.27032 | 涨跌幅（%） |
change | number | 132 | 涨跌额 |
volume | number | 125925 | 成交量 |
dayLow | number | 4085 | 当日最低价 |
dayHigh | number | 4180.2 | 当日最高价 |
yearHigh | number | 5626.8 | 52 周最高 |
yearLow | number | 3331.4 | 52 周最低 |
marketCap | null | null | 总市值 |
priceAvg50 | number | 4181.37 | 50 日均价 |
priceAvg200 | number | 4588.81 | 200 日均价 |
exchange | string | "COMMODITY" | 交易所代码 |
open | number | 4126.7 | 开盘价 |
previousClose | number | 4036.3 | 昨收价 |
timestamp | number | 1785430211 | 时间戳 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "GCUSD",
"name": "Gold Futures",
"price": 4168.3,
"changePercentage": 3.27032,
"change": 132,
"volume": 125925,
"dayLow": 4085,
"dayHigh": 4180.2,
"yearHigh": 5626.8,
"yearLow": 3331.4,
"marketCap": null,
"priceAvg50": 4181.37,
"priceAvg200": 4588.81,
"exchange": "COMMODITY",
"open": 4126.7,
"previousClose": 4036.3,
"timestamp": 1785430211
}
]常见问题解答（FAQ）
2 个问题在「Quotes」分类下，大宗商品报价（17 个字段）与 大宗商品快速报价 的核心差异点是什么？
大宗商品报价 与 Commodities Quote Short（大宗商品快速报价） 分别映射 /stable/quote（必填 symbol，含 name 等 17 列）与 /stable/quote-short（必填 symbol，含 4 列），可按研究粒度灵活选用。
实盘任务调用 /stable/quote 拉取大宗商品报价时，如何规范化控制查询边界与重试节奏？
您只需传入目标证券 symbol 访问 /stable/quote 采集单票数据；配合空数组 [] 短路判断，即可构建零人工干预的 大宗商品报价（name）自动化同步任务。
同模块相关接口对比
Quotes本接口路径 /stable/quote，必填参数 symbol。 同一模块「Quotes」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。