Light Chart大宗商品精简日线
该接口提供各类商品的历史日线价格：收盘价与成交量等关键数据一并获取，可回溯任意时间段的价格变化，用于趋势跟踪与决策支持。
https://quote-fmp.com/stable/historical-price-eod/light?symbol=GCUSD数据更新周期
5-15 Minutes · 约 5~15 分钟更新
接口说明
- 日线价格：获取商品的准确历史价格，包含成交量等关键指标，用于分析市场随时间的表现，传入
symbol后可拉取price（最新价）、volume（成交量） 等指标，为基本面与量价研究提供标准输入。 - 完整历史数据：访问商品在任意所选时期内价格变化的详细记录，对照
price（最新价）与volume（成交量） 等历史记录，可检验策略信号在不同市场周期下的稳健性。 - 成交量洞察：价格信息之外附有成交量数据，可评估各商品的交易活跃度，针对深度投研场景，搭配同模块的「大宗商品全量日线」能进一步拓宽样本对比维度。
- 配套投研接口：1-Hour Interval Commodities Chart（大宗商品1小时分时） · Commodities List（大宗商品清单） · COT Analysis By Dates（COT 报告分析） · Economics Indicators（经济指标数据）
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | GCUSD | 大宗商品行情合约代码，例如 GCUSD（黄金）、CLUSD（WTI 原油）、SIUSD（白银）、NGUSD（天然气）。 |
from | date | 可选 | 2026-01-27 | 查询起始日期，格式 YYYY-MM-DD，包含当天。 |
to | date | 可选 | 2026-04-27 | 查询结束日期，格式 YYYY-MM-DD，包含当天。 |
调用代码示例
Python 关键代码按示例请求 /stable/historical-price-eod/light 获取大宗商品精简日线（必填 symbol），DataFrame 包含 price（最新价）、volume（成交量）、symbol（证券代码）（price=4170）。
resp = requests.get(
"https://quote-fmp.com/stable/historical-price-eod/light",
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 升序重排并数值化 price（最新价）
df["price"] = pd.to_numeric(df["price"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 查询 GCUSD 的大宗商品精简日线明细（symbol=GCUSD） | symbol=GCUSD | 向 /stable/historical-price-eod/light 传 symbol=GCUSD，返回包含 price、volume、symbol（如 price=4170）在内的 4 项字段。 |
| 按年度日期边界拉取 GCUSD 大宗商品精简日线历史序列 | symbol=GCUSD&from=2024-01-01&to=2024-12-31 | 在 /stable/historical-price-eod/light 中组合 symbol=GCUSD 与日期范围，过滤出 2024 全年的 price、volume、symbol 明细记录。 |
| 切换主力品种 CLUSD（WTI原油）拉取大宗商品精简日线 | symbol=CLUSD | 改传 symbol=CLUSD 访问 /stable/historical-price-eod/light，提取 WTI原油 的 price、volume、symbol 做跨品种比对。 |
在量化流水线中调用 /stable/historical-price-eod/light（大宗商品精简日线，必填 symbol），拿到的 price（4170）与 symbol（GCUSD）需先经过非空校验再送入因子矩阵。
/stable/historical-price-eod/light 单行含 4 个属性（如 price=4170）；PostgreSQL 或 ClickHouse 建表推荐以 (symbol, date) 为排序主键。
返回数据
4 个字段本接口示例响应共包含 4 个字段（数值型 2 个，文本/日期/布尔型 2 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "GCUSD" | 证券代码 |
date | string | "2026-07-30" | 日期 |
price | number | 4170 | 最新价 |
volume | number | 126573 | 成交量 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "GCUSD",
"date": "2026-07-30",
"price": 4170,
"volume": 126573
}
]常见问题解答（FAQ）
2 个问题在对接「End Of Day」数据线时，大宗商品精简日线与 大宗商品全量日线 各自解决什么问题？
大宗商品精简日线 通过 /stable/historical-price-eod/light（必填 symbol）返回 price（最新价）、volume（成交量）等 4 列明细；同模块的 Full Chart（大宗商品全量日线） 则通过 /stable/historical-price-eod/full（必填 symbol）提供配套数据。
想要完整归档大宗商品精简日线，请求 /stable/historical-price-eod/light 时在参数调度上有什么最佳实践？
在采集 大宗商品精简日线 时，可在 /stable/historical-price-eod/light 中传入 from/to 日期区间分批拉取；若遇到休市日或未披露窗口返回 []，脚本应记录水位线并平滑跳过。
同模块相关接口对比
End Of Day本接口路径 /stable/historical-price-eod/light，必填参数 symbol。 同一模块「End Of Day」下共 2 个接口，下表列出其余 1 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 大宗商品全量日线Full Chart | /stable/historical-price-eod/full | 商品完整的历史日线行情，开盘价、最高价、最低价、收盘价、成交量与涨跌变化一并获取 |