WTI 现货
适合美国原油现货研究；必须记录发布日期、单位和来源序列。
能源数据选择指南
免费原油价格 API：WTI 与布伦特指南
先定义基准、时间、单位和证据要求，再选择原油价格接口。
原油价格 API 决策要点
比较供应商之前，先确认使用任务、免费额度的含义、价格基准，以及每个数值必须携带的来源证据。
真实任务
开发者需要可编程调用的原油价格与示例请求，而不是只有图表或行情评论。
“免费”并不统一
免费可能是长期可用但配额较低、限时试用、延迟价格，或只开放有限历史数据。
基准必须匹配
WTI、布伦特、现货、期货结算与盘中报价不是同一种数据。
先核验再接入
确认基准、时间戳、币种、单位、更新间隔、配额和再分发权利。
先确定真正需要的原油价格类型
WTI 现货、布伦特现货和期货合约回答的是不同问题。先确定价格口径，再评估接口。
布伦特现货
适合全球原油基准比较；保留数据序列和观测日期。
期货合约
只有在合约月份、换月规则、结算方式和交易所授权明确时才使用。
WTI、布伦特、现货、期货与结算价分别代表什么
市场上不存在唯一的“国际油价”。原油品质、交割地点、合约月份和价格字段都会改变数值含义。若接口只返回“crude oil”而没有基准与方法说明，就不足以支撑可靠分析。
| 序列或价格 | 代表什么 | 必须保留的上下文 | 常见用途 |
|---|---|---|---|
| WTI | 美国轻质低硫原油基准，交割背景与俄克拉何马州库欣相关。 | 现货或期货、合约月份、来源、单位和时间戳。 | 美国市场与库存研究。 |
| Brent | 与北海原油体系相关、广泛用于国际贸易定价的基准。 | 评估价或期货方法、合约或交付期，以及发布方。 | 全球原油比较与价差研究。 |
| 实物现货价 | 在指定品质、时间与地点条件下交付原油的成交或评估价格。 | 品级、地点、交付窗口、币种、单位和方法。 | 实物贸易、炼化和采购。 |
| 期货报价或结算价 | 某个交易所合约的价格；结算价是交易所按规则确定的日终字段。 | 交易所、代码、合约月份、价格字段、时段和状态。 | 套期保值、估值与期限结构分析。 |
| 近月或连续序列 | 按照展期规则在不同合约之间切换形成的派生历史。 | 展期触发、调整方法、底层合约与展期日期。 | 图表和收益研究，不是直接成交标的。 |
不要把期限结构抹平。若把所有合约都改成同一个 WTI 标签，就会丢失交割月份，也可能掩盖升水、贴水和展期影响。即使前端最终展示连续图表，底层仍应保留单合约数据。
原油价格不能脱离这些字段
benchmark明确 WTI、Brent、Dubai/Oman，或具体期货合约。
price_type区分现货、收盘、结算、买价、卖价和最新成交。
unit通常为美元/桶，但不能靠猜测补全。
observed_at市场观测时间，而不是发起请求的时间。
published_at数据源发布或修订该值的时间。
source保留序列、交易所或供应商身份及授权背景。
数据来源对比
| 来源 | 适合场景 | 必须核对 |
|---|---|---|
| EIA 开放数据 | 美国官方能源序列 | 序列代码、发布频率和修订 |
| FRED WTI | 研究与历史分析 | 底层来源和观测日期 |
| FRED Brent | 跨基准比较 | 非交易日空缺与更新延迟 |
| QVeris 中的 FMP | 面向应用的行情能力 | 套餐、代码规则、时间戳和授权 |
免费原油价格 API 应满足哪些条件
合适的接口不会只返回含义不明的“油价”，而会说明基准和价格类型。需要核对 WTI 或布伦特、现货或期货、实时或延迟，以及是否为日结算价。免费账户也不会自动覆盖行情授权或公开展示限制。
原油实时价格接口真的实时吗？
检查来源时间戳、延迟标记、交易时段和更新间隔。“最新”也可能只是最近一个结算价，而非盘中报价。
原油历史价格 API 是否覆盖 WTI 和布伦特？
检查最早日期、日线或盘中粒度、缺失区间、修订机制，并确认数据代表现货、近月期货还是结算价。
接口是否返回可用的 JSON？
响应应标明基准、价格、币种、单位、时间戳和来源；稳定字段、错误文档、鉴权和限流响应头能降低接入风险。
原油价格 API 用于研究与生产前的质量检查
原油数据除了常见 JSON 接入问题，还容易出现基准替换、合约到期、单位不一致、节假日日历、结算价更正和连续序列展期等风险，需要单独校验。
基准身份
必须保存基准、品级、地点和发布方。即使都按桶计价，也不能在没有说明的情况下用 WTI 或其他原油填补布伦特缺失值。
合约与价格字段
保存合约月份，并区分最新成交、买价、卖价、收盘价和结算价。近月代码在每个日期都要能还原到实际合约。
币种与单位
按发布方原样保存币种和单位。若换算桶、吨或币种，应记录换算系数、假设和汇率时间戳。
时效与交易日历
比较事件时间与入库时间，并结合交易时段、周末和节假日判断。延迟和日终序列必须清楚标注。
展期与历史真实性
保存底层合约与每次展期决定。后复权有助于收益研究，但复权后的历史价格水平属于合成结果。
来源核对与授权
根据序列类型抽样对照 EIA 开放数据、FRED WTI 序列或已获授权的交易所来源，并保留署名、展示和再分发条款。
回测提醒：今天看到的连续序列可能包含更正后的结算价，也可能采用事后确定的展期规则。若结果依赖当时真实可得信息，应按每个决策时点重新构造数据。
免费原油价格 API 选择清单
| 检查项 | 需要确认 | 适合场景 | 常见限制 |
|---|---|---|---|
| 覆盖 | WTI、布伦特、现货、期货、汽油还是柴油？ | 匹配所需基准。 | 只开放一种基准或价格类型。 |
| 时效 | 实时、延迟、日终还是缓存？ | 匹配研究或在线任务。 | 交易所授权限制。 |
| 字段 | 基准、价格、币种、桶单位、时间戳与来源？ | 图表、研究、监控。 | 免费套餐可能不含历史数据。 |
| 接入 | REST、JSON、SDK、API Key、配额和错误文档？ | 可靠应用接入。 | 试用到期或配额变化。 |
可靠的接入顺序
- 01
先写清基准
把“原油价格”拆成基准、价格类型、单位和时效要求。
- 02
执行真实请求
用已知日期和代码测试，并保留原始响应。
- 03
核对三个时间
比较观测时间、发布时间和接收时间。
- 04
保存证据
将来源链接、序列代码、单位和转换规则与数值一起保存。
如何用 Python 调用免费原油价格 API
1. 明确基准和价格类型
先确定 WTI 或布伦特、现货或期货、币种、桶单位、更新频率和历史范围，再比较供应商。
2. 发起一次免费原油价格 API 请求
从供应商官方 cURL 或 Python 示例和免费 API Key 开始。密钥放在源码之外，设置超时并记录配额响应头。
3. 入库前校验原油价格
拒绝缺少基准或时间戳的数据，统一时区，保留供应商原始代码和价格类型，检测过期响应，并抽样与权威来源核对。
4. 在限流范围内重试
对临时故障使用指数退避和抖动，遵守 429 与供应商规则，不能把有限免费配额消耗在高频轮询上。
调用前先检查能力
QVeris 将能力发现与供应商选择分开，让 Agent 在调用前先检查输入和证据要求。 可继续打开Financial Modeling Prep 服务商详情，并通过QVeris REST API 参考核对调用契约。
FAQ
有免费的原油价格 API 吗？
有些供应商为 WTI 和布伦特提供长期可用但配额较低的套餐，或提供试用额度；仍需检查当前配额、延迟、历史范围和授权条款。
如何通过 API 获取原油历史价格？
先确认 WTI 或布伦特、现货或期货口径、最早日期、时间戳与修订机制，再选择日线或盘中数据。
原油价格接口应返回哪些字段？
至少包含基准代码、价格类型、数值、币种、单位、时间戳和来源；只有数据序列支持时才使用 OHLC。
免费油价 API 能用于生产环境吗？
应先验证配额、授权、时效、稳定性、更正机制与公开展示权利，不能仅凭“免费”判断适用性。