Commodity（大宗商品）

Q: 怎么知道黄金、原油在 FMP 里的代码是什么？

调用 Commodities List（大宗商品清单） 接口即可获取全部支持品种的 symbol、name、currency 和 exchange 清单。

Q: Light Chart（大宗商品精简日线） 和 Full Chart（大宗商品全量日线） 有什么区别？

Light Chart（大宗商品精简日线） 仅返回 date、price、volume 三个核心字段，适合画折线图；Full Chart（大宗商品全量日线） 返回完整 open、high、low、close、volume、vwap，适合 K 线与量化回测。

此类接口提供商品行情信息，包括能源、金属、农产品等品种清单、单品种或全量最新报价，以及日线与 1 分钟、5 分钟、1 小时的分时序列。适合商品行情看板、趋势类策略与跨资产研究；可交易品种以接口返回的清单为准，部分品种的历史深度受上游数据源限制。

典型使用场景

3 个场景

宏观跨资产监控

将黄金、原油、铜价与美债收益率、美元指数放在同一面板跟踪通胀预期。

商品 CTA 策略研究

利用日线与小时线 OHLCV 数据测试趋势跟踪与跨品种比价（如金银比、油气比）。

产业链成本跟踪

结合上游原材料价格走势，辅助资源股与制造业公司毛利率预测。

接口怎么选？

6 项选型对照

大宗商品类别遵循「查目录 → 取实时快照 → 拉历史 K 线」的标准结构：先用 Commodities List（大宗商品清单）拿到代码（如 GCUSD 黄金、CLUSD 原油）与计价货币，再调用对应的报价或图表接口。

分钟级行情提供 1 分钟、5 分钟、1 小时三档粒度，日线提供精简版——Light Chart（大宗商品精简日线）——与完整 OHLCV 版——Full Chart（大宗商品全量日线）——。

你的需求	推荐接口	选择理由
查询支持的大宗商品代码与交易单位	Commodities List大宗商品清单	获取商品 symbol、名称、交易所与货币
获取单个商品品种的完整实时报价	Commodities Quote大宗商品报价	含最新价、涨跌幅、当日高低、52 周区间与均线
获取轻量级价格与成交量快照	Commodities Quote Short大宗商品快速报价	字段精简，适合高频刷新
一次获取全部大宗商品的最新行情	All Commodities Quotes大宗商品批量报价	适合商品行情看板与跨品种涨跌扫描
拉取商品日线完整 OHLCV 历史行情	Full Chart大宗商品全量日线	含开高低收、成交量与 VWAP，适合回测
拉取商品日内分钟级 K 线（1m / 5m / 1h）	5-Minute Interval Commodities Chart大宗商品5分钟分时	按需选择 1-minute / 5-minute / 1-hour 接口

数据覆盖与参数口径

主要品种：黄金、白银、铂金、铜、WTI 原油、布伦特原油、天然气、玉米、大豆、小麦等
历史粒度：日线（Full / Light）+ 分钟线（1min / 5min / 1hour）
联动数据：配合 COT 持仓报告（commitmentoftraders）与宏观经济指标（economics）使用

调用示例

Python 关键代码

示例场景：获取黄金（GCUSD）日线历史行情 · 对应接口：Full Chart（大宗商品全量日线）

Python（核心参数与字段清洗逻辑）

resp = requests.get(
    "https://quote-fmp.com/stable/historical-price-eod/full",
    params={"symbol": "GCUSD", "from": "2026-01-27", "to": "2026-04-27", "apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 open（开盘价）
df["open"] = pd.to_numeric(df["open"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)

先用 Commodities List（大宗商品清单）核对每个品种的计价单位（盎司、桶、蒲式耳等）。
大盘看板直接调用 All Commodities Quotes（大宗商品批量报价）一次拿全品种。

数据注意事项

4 条实盘要点

不同商品的报价单位（美元/金衡盎司、美元/桶、美分/蒲式耳）差异巨大，接入前先调用 Commodities List（大宗商品清单）核对 currency 与合约名称。
分钟线——1-Minute Interval Commodities Chart（大宗商品1分钟分时）、5-Minute Interval Commodities Chart（大宗商品5分钟分时）、1-Hour Interval Commodities Chart（大宗商品1小时分时）——适合日内与波段跟踪，长周期多年度回测请使用 Full Chart（大宗商品全量日线）或 Light Chart（大宗商品精简日线）日线接口。
全市场商品看板刷新请优先调用 All Commodities Quotes（大宗商品批量报价）或 Full Commodities Quotes（大宗商品批量报价）一次拉取全部品种快照。
商品期货在主力合约交割展期附近可能出现价格跳空，连续序列回测时可结合 COT Report（COT 持仓报告）的持仓结构变化综合评估。