Commodities Quote Short大宗商品快速报价

该接口返回各类大宗商品的最新价格、近期涨跌与成交量等关键信息,适合需要快速看盘、即时决策的投资者与交易者,适用于全球大宗商品趋势跟踪、通胀预期交易模型与跨品种套利分析。

GEThttps://quote-fmp.com/stable/quote-short?symbol=GCUSD

数据更新周期

Real-Time · 实时更新

接口说明

  • 即时价格更新:返回各类大宗商品的价格数据,让你随时与市场同步,传入 symbol 后可提取 price(最新价)、change(涨跌额)与 volume(成交量) 等字段,便于直接写入量化因子库。
  • 市场变动跟踪:实时掌握价格变化,快速应对市场波动,读取 price(最新价)与 change(涨跌额) 等结构化数值后,可直接对接估值模型或风控阈值检查。
  • 成交量洞察:获取最新成交量数据,衡量市场活跃度与流动性,当单一端点维度不足时,可结合「大宗商品报价」拼装出更全面的分析视图。
  • 上下游关联接口:Commodities List(大宗商品清单) · Light Chart(大宗商品精简日线) · COT Report(COT 持仓报告) · COT Analysis By Dates(COT 报告分析)

请求参数

1 个参数
参数类型要求示例说明
symbolstring必填GCUSD大宗商品行情合约代码,例如 GCUSD(黄金)、CLUSD(WTI 原油)、SIUSD(白银)、NGUSD(天然气)。

调用代码示例

Python 关键代码

大宗商品快速报价(/stable/quote-short,必填 symbol)返回 price(最新价)、change(涨跌额)、volume(成交量) 等 4 列(样本 price=4168.3)。

Python(核心参数与字段清洗逻辑)
resp = requests.get(
    "https://quote-fmp.com/stable/quote-short",
    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-short?symbol=GCUSD,产出该标的的 price、change、volume(样本 4168.3)等 4 列明细。
切换主力品种 CLUSD(WTI原油)拉取大宗商品快速报价symbol=CLUSD改传 symbol=CLUSD 访问 /stable/quote-short,提取 WTI原油 的 price、change、volume 做跨品种比对。
参数与空值防守请求 /stable/quote-short(大宗商品快速报价):必填 symbol与返回结构校验

请求 /stable/quote-short 获取大宗商品快速报价需传入必填 symbol;返回数组涵盖 price(4168.3)等 4 列,作主表关联键前请统一大小写与编码格式。

落库主键与口径/stable/quote-short(大宗商品快速报价):price 口径核对与 (symbol) 主键

在 /stable/quote-short 的返回结构中,price(4168.3)构成核心载荷,本地表以 (symbol) 保证幂等入库。

返回数据

4 个字段

本接口示例响应共包含 4 个字段(数值型 3 个,文本/日期/布尔型 1 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。

字段类型示例值说明
symbolstring"GCUSD"证券代码
pricenumber4168.3最新价
changenumber132涨跌额
volumenumber125925成交量
查看响应数据示例(原始 JSON)
[
{
"symbol": "GCUSD",
"price": 4168.3,
"change": 132,
"volume": 125925
}
]

常见问题解答(FAQ)

2 个问题
/stable/quote-short 端点(大宗商品快速报价)的参数设计与同模块的 大宗商品报价 有什么区别?

工程上常将两者配合:用 大宗商品快速报价(/stable/quote-short,必填 symbol)拉取 price 与 change 等 4 列,同时用 Commodities Quote(大宗商品报价)补充 17 列关联信息。

使用 /stable/quote-short 采集大宗商品快速报价构建因子库,推荐的请求切片方式是什么?

采集 /stable/quote-short 的核心技巧是向 /stable/quote-short 传入标准 symbol(港股带 .HK、A 股带 .SS);这能确保 大宗商品快速报价 的 price 与 change 连续完整且无截断遗漏。

同模块相关接口对比

Quotes

本接口路径 /stable/quote-short,必填参数 symbol。 同一模块「Quotes」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。

接口路径核心差异与适用场景
大宗商品报价Commodities Quote/stable/quote全球各大交易所交易的全部大宗商品报价,最新价、最高价、最低价、开盘价等一手掌握
大宗商品批量报价All Commodities Quotes/stable/batch-commodity-quotes一次请求即可返回多种大宗商品的实时行情,最新价格、涨跌变化、成交量等关键指标

Commodity(大宗商品)全部接口目录 →

需要稳定访问 大宗商品快速报价 数据?注册即可获取专属 API Key,免费体验全部接口。
免费试用 1 个月