Commodities List大宗商品清单
该接口返回可交易商品的完整清单：覆盖能源（石油、天然气）、金属（黄金、白银）、农产品（玉米、小麦）等板块，每条记录含代码、交易月份与关联币种，用于商品市场的检索与选品。
https://quote-fmp.com/stable/commodities-list数据更新周期
N/A · 不适用固定周期
接口说明
- 商品覆盖面广：查看能源（石油、天然气）、金属（黄金、白银）、农业（玉米、小麦）等板块的所有可用商品，多样的覆盖让各类市场的查找与分析更便捷。
- 市场洞察：附有交易月份与币种数据，投资者和分析师可以更好地理解商品板块的全球市场趋势与定价结构，参考
name（名称）与exchange（交易所代码） 等披露数值，能直观评估标的在同类资产中的相对排位。 - 数据更新：随时掌握商品的最新信息，辅助宏观通胀预期跟踪、商品期货 CTA 趋势回测与产业链上下游原材料成本传导分析。
- 配套投研接口：5-Minute Interval Commodities Chart（大宗商品5分钟分时） · 1-Hour Interval Commodities Chart（大宗商品1小时分时） · COT Analysis By Dates（COT 报告分析） · Economics Indicators（经济指标数据）
调用代码示例
Python 关键代码按示例请求 /stable/commodities-list 获取大宗商品清单（仅 apikey），DataFrame 包含 name（名称）、exchange（交易所代码）、tradeMonth（交易月份）（name=Soybean Meal Futures）。
resp = requests.get(
"https://quote-fmp.com/stable/commodities-list",
params={"apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 大宗商品清单 核心列：symbol, name, exchange, tradeMonth
df = df[["symbol", "name", "exchange", "tradeMonth"]].dropna(how="all")参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 一次性拉取全量大宗商品清单初始化本地主表 | GET /stable/commodities-list（免参数） | 直接请求 /stable/commodities-list 即返回全表，含 name、exchange、tradeMonth 等 5 列；建库或每日全量覆盖时无需拼接任何 Query 参数。 |
| 以 symbol 为唯一键覆盖写入，避免全表重复 | GET /stable/commodities-list → upsert on symbol | 全表每轮返回 symbol（样本 ZMUSD）等 5 列，落库时以 symbol 作唯一键覆盖；同模块无参数相近的接口，单点补数只能重拉全表。 |
| 落库后自检：symbol 唯一性与 name 空值率 | GET /stable/commodities-list → count(distinct symbol) / null_ratio(name) | 5 列落库完成后，用 count(distinct symbol) 对账行数；name（如 Soybean Meal Futures）若大面积为空，说明本次全表拉取不完整，需要重跑。 |
在量化流水线中调用 /stable/commodities-list（大宗商品清单，免业务参数），拿到的 name（Soybean Meal Futures）需先经过非空校验再送入下游模块。
/stable/commodities-list 单行含 5 个属性（如 name=Soybean Meal Futures）；PostgreSQL 或 ClickHouse 建表推荐以 (symbol, exchange, name) 为主键。
返回数据
5 个字段本接口示例响应共包含 5 个字段（数值型 0 个，文本/日期/布尔型 5 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "ZMUSD" | 证券代码 |
name | string | "Soybean Meal Futures" | 名称 |
exchange | null | null | 交易所代码 |
tradeMonth | string | "Dec" | 交易月份 |
currency | string | "USD" | 计价币种 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "ZMUSD",
"name": "Soybean Meal Futures",
"exchange": null,
"tradeMonth": "Dec",
"currency": "USD"
}
]常见问题解答（FAQ）
2 个问题在对接「Commodities」数据线时，大宗商品清单与 大宗商品报价 各自解决什么问题？
大宗商品清单 通过 /stable/commodities-list（免业务参数）返回 name（名称）、exchange（交易所代码）等 5 列明细；同模块的 Commodities Quote（大宗商品报价） 则通过 /stable/quote（必填 symbol）提供配套数据。
想要完整归档大宗商品清单，请求 /stable/commodities-list 时在参数调度上有什么最佳实践？
在采集 大宗商品清单 时，可免过滤参数访问 /stable/commodities-list 一次性导出完整截面；若遇到休市日或未披露窗口返回 []，脚本应记录水位线并平滑跳过。
同分类关联接口对比
大宗商品本接口路径 /stable/commodities-list（所属子模块「Commodities」仅此 1 个接口），无必填参数。 下表列出同属「大宗商品」大类下的 6 个关联接口，方便横向对比与上下游联动：
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 大宗商品报价Commodities Quote | /stable/quote | 全球各大交易所交易的全部大宗商品报价，最新价、最高价、最低价、开盘价等一手掌握 |
| 大宗商品快速报价Commodities Quote Short | /stable/quote-short | 各类大宗商品的最新价格、近期涨跌与成交量等关键信息 |
| 大宗商品批量报价All Commodities Quotes | /stable/batch-commodity-quotes | 一次请求即可返回多种大宗商品的实时行情，最新价格、涨跌变化、成交量等关键指标 |
| 大宗商品精简日线Light Chart | /stable/historical-price-eod/light | 各类商品的历史日线价格，收盘价与成交量等关键数据一并获取，可回溯任意时间段的价格变化 |
| 大宗商品全量日线Full Chart | /stable/historical-price-eod/full | 商品完整的历史日线行情，开盘价、最高价、最低价、收盘价、成交量与涨跌变化一并获取 |
| 大宗商品1分钟分时1-Minute Interval Commodities Chart | /stable/historical-chart/1min | 商品逐分钟的价格数据，每分钟的开盘价、最高价、最低价、收盘价与成交量，粒度最细 |