1-Hour Interval Commodities Chart大宗商品1小时分时
该接口提供商品 1 小时周期的分时行情:每小时的开盘价、最高价、最低价、收盘价与成交量,兼顾日内波动捕捉与噪音过滤,适合中期交易策略与市场分析。
https://quote-fmp.com/stable/historical-chart/1hour?symbol=GCUSD数据更新周期
Real-Time · 实时更新
接口说明
- 小时级趋势监控:以小时为更新粒度跟踪商品的价格波动与趋势,更清晰地把握当日市场方向,传入
symbol后可同步open(开盘价)、low(最低价)与high(最高价) 等明细数据,支撑多维度选股与面板回归分析。 - 详细价格信息:获取每小时的开盘、最高、最低、收盘价与成交量,了解特定时间段内的市场活跃度,围绕
low(最低价)与high(最高价) 等字段,可在回测中还原历史任意时点的真实截面。 - 中期策略支持:利用小时级数据发现日内趋势,帮助交易员做出更有依据的决策、打磨中期策略,实务中常与同模块的「大宗商品1分钟分时」联合调用,先做广度筛查再下钻单标明细。
- 上下游关联接口:Commodities List(大宗商品清单) · Commodities Quote(大宗商品报价) · COT Report(COT 持仓报告) · COT Analysis By Dates(COT 报告分析)
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | GCUSD | 大宗商品行情合约代码,例如 GCUSD(黄金)、CLUSD(WTI 原油)、SIUSD(白银)、NGUSD(天然气)。 |
from | date | 可选 | 2024-01-01 | 查询起始日期,格式 YYYY-MM-DD,包含当天。 |
to | date | 可选 | 2024-03-01 | 查询结束日期,格式 YYYY-MM-DD,包含当天。 |
调用代码示例
Python 关键代码大宗商品1小时分时(/stable/historical-chart/1hour,必填 symbol)返回 open(开盘价)、low(最低价)、high(最高价) 等 6 列(样本 open=4169.3)。
resp = requests.get(
"https://quote-fmp.com/stable/historical-chart/1hour",
params={"symbol": "GCUSD", "from": "2024-01-01", "to": "2024-03-01", "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)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 定向上游请求 GCUSD 大宗商品1小时分时(symbol=GCUSD) | symbol=GCUSD | 请求 /stable/historical-chart/1hour?symbol=GCUSD,产出该标的的 open、low、high(样本 4169.3)等 6 列明细。 |
| 截取 2024-01-01 至 2024-12-31 归档 GCUSD 大宗商品1小时分时 | symbol=GCUSD&from=2024-01-01&to=2024-12-31 | 设置起止日期边界调用 /stable/historical-chart/1hour,拉回 GCUSD 指定历史窗口的 open、low、high(如 4169.3)。 |
| 切换主力品种 CLUSD(WTI原油)拉取大宗商品1小时分时 | symbol=CLUSD | 改传 symbol=CLUSD 访问 /stable/historical-chart/1hour,提取 WTI原油 的 open、low、high 做跨品种比对。 |
请求 /stable/historical-chart/1hour 获取大宗商品1小时分时需传入必填 symbol;返回数组涵盖 open(4169.3)与 low(4166),做时间序列差分前请先核对排序方向。
在 /stable/historical-chart/1hour 的返回结构中,open(4169.3)构成核心载荷,本地表以 (symbol, date) 保证幂等入库。
返回数据
6 个字段本接口示例响应共包含 6 个字段(数值型 5 个,文本/日期/布尔型 1 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
date | string | "2026-07-30 13:00:00" | 日期 |
open | number | 4169.3 | 开盘价 |
low | number | 4166 | 最低价 |
high | number | 4170 | 最高价 |
close | number | 4166.8 | 收盘价 |
volume | number | 690 | 成交量 |
查看响应数据示例(原始 JSON)
[
{
"date": "2026-07-30 13:00:00",
"open": 4169.3,
"low": 4166,
"high": 4170,
"close": 4166.8,
"volume": 690
}
]常见问题解答(FAQ)
2 个问题/stable/historical-chart/1hour 端点(大宗商品1小时分时)的参数设计与同模块的 大宗商品1分钟分时 有什么区别?
工程上常将两者配合:用 大宗商品1小时分时(/stable/historical-chart/1hour,必填 symbol)拉取 open 与 low 等 6 列,同时用 1-Minute Interval Commodities Chart(大宗商品1分钟分时)补充 6 列关联信息。
使用 /stable/historical-chart/1hour 采集大宗商品1小时分时构建因子库,推荐的请求切片方式是什么?
采集 /stable/historical-chart/1hour 的核心技巧是利用 from 至 to 闭区间对 /stable/historical-chart/1hour 做分段回溯;这能确保 大宗商品1小时分时 的 open 与 low 连续完整且无截断遗漏。
同模块相关接口对比
Intraday本接口路径 /stable/historical-chart/1hour,必填参数 symbol。 同一模块「Intraday」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。