Commodities Quote Short大宗商品快速报价
该接口返回各类大宗商品的最新价格、近期涨跌与成交量等关键信息,适合需要快速看盘、即时决策的投资者与交易者,适用于全球大宗商品趋势跟踪、通胀预期交易模型与跨品种套利分析。
https://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 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | GCUSD | 大宗商品行情合约代码,例如 GCUSD(黄金)、CLUSD(WTI 原油)、SIUSD(白银)、NGUSD(天然气)。 |
调用代码示例
Python 关键代码大宗商品快速报价(/stable/quote-short,必填 symbol)返回 price(最新价)、change(涨跌额)、volume(成交量) 等 4 列(样本 price=4168.3)。
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;返回数组涵盖 price(4168.3)等 4 列,作主表关联键前请统一大小写与编码格式。
在 /stable/quote-short 的返回结构中,price(4168.3)构成核心载荷,本地表以 (symbol) 保证幂等入库。
返回数据
4 个字段本接口示例响应共包含 4 个字段(数值型 3 个,文本/日期/布尔型 1 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "GCUSD" | 证券代码 |
price | number | 4168.3 | 最新价 |
change | number | 132 | 涨跌额 |
volume | number | 125925 | 成交量 |
查看响应数据示例(原始 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 个, 按粒度与查询维度对比,避免选错接口。