WTI spot
Use for U.S. physical-market reference work; record the publication date and unit.
ENERGY DATA DECISION GUIDE能源数据选择指南
Free Oil Price API: WTI & Brent Guide免费原油价格 API：WTI 与布伦特指南
Define the benchmark, clock, unit, and evidence contract before choosing an oil-price endpoint.
先定义基准、时间、单位和证据要求，再选择原油价格接口。
Oil API decision snapshot原油价格 API 决策要点
Before comparing providers, settle the job, the meaning of free access, the benchmark, and the evidence each value must carry.
比较供应商之前，先确认使用任务、免费额度的含义、价格基准，以及每个数值必须携带的来源证据。
Search task
Developers want a usable free oil price API and sample request, not only a commodity chart or market commentary.
“Free” varies
A free tier can mean a permanent monthly quota, a time-limited trial, delayed prices, or restricted history.
Benchmark fit matters
WTI and Brent spot prices, futures, daily settlements, and intraday quotes are different datasets.
Verify first
Confirm benchmark, timestamp, currency, unit, update interval, API limits, and redistribution rights.
真实任务
开发者需要可编程调用的原油价格与示例请求，而不是只有图表或行情评论。
“免费”并不统一
免费可能是长期可用但配额较低、限时试用、延迟价格，或只开放有限历史数据。
基准必须匹配
WTI、布伦特、现货、期货结算与盘中报价不是同一种数据。
先核验再接入
确认基准、时间戳、币种、单位、更新间隔、配额和再分发权利。
Start with the price you actually need先确定真正需要的原油价格类型
WTI spot, Brent spot, and futures answer different questions. Pick the price contract first, then evaluate the endpoint.
WTI 现货、布伦特现货和期货合约回答的是不同问题。先确定价格口径，再评估接口。
Brent spot
Use for global crude comparisons; keep the source series and observation date.
Futures
Use when contract month, roll rule, settlement type, and exchange license are explicit.
WTI 现货
适合美国原油现货研究；必须记录发布日期、单位和来源序列。
布伦特现货
适合全球原油基准比较；保留数据序列和观测日期。
期货合约
只有在合约月份、换月规则、结算方式和交易所授权明确时才使用。
WTI, Brent, spot, futures, and settlement prices mean different thingsWTI、布伦特、现货、期货与结算价分别代表什么
There is no single universal oil price. Crude grade, delivery location, contract month and price field all change the meaning. A provider that labels one number “crude oil” without benchmark and methodology is not sufficient for reliable analysis.
市场上不存在唯一的“国际油价”。原油品质、交割地点、合约月份和价格字段都会改变数值含义。若接口只返回“crude oil”而没有基准与方法说明，就不足以支撑可靠分析。
| Series or price序列或价格 | What it represents代表什么 | Required context必须保留的上下文 | Typical use常见用途 |
|---|---|---|---|
| WTI | A US light sweet crude benchmark with delivery context centered on Cushing, Oklahoma.美国轻质低硫原油基准，交割背景与俄克拉何马州库欣相关。 | Spot or futures, contract month, source, unit and timestamp.现货或期货、合约月份、来源、单位和时间戳。 | US market and inventory analysis.美国市场与库存研究。 |
| Brent | A North Sea-linked benchmark widely used for international crude pricing.与北海原油体系相关、广泛用于国际贸易定价的基准。 | Assessment or futures methodology, contract or delivery period, and publisher.评估价或期货方法、合约或交付期，以及发布方。 | Global crude comparisons and differentials.全球原油比较与价差研究。 |
| Physical spot实物现货价 | A price or assessment for crude delivered under specified grade, timing and location terms.在指定品质、时间与地点条件下交付原油的成交或评估价格。 | Grade, location, delivery window, currency, unit and methodology.品级、地点、交付窗口、币种、单位和方法。 | Physical trade, refining and procurement.实物贸易、炼化和采购。 |
| Futures quote or settlement期货报价或结算价 | A value for one exchange contract; settlement is an exchange-defined end-of-day field.某个交易所合约的价格；结算价是交易所按规则确定的日终字段。 | Exchange, symbol, contract month, quote field, session and status.交易所、代码、合约月份、价格字段、时段和状态。 | Hedging, valuation and curve analysis.套期保值、估值与期限结构分析。 |
| Front-month or continuous series近月或连续序列 | A derived history that switches contracts according to a roll rule.按照展期规则在不同合约之间切换形成的派生历史。 | Roll trigger, adjustment method, source contracts and roll dates.展期触发、调整方法、底层合约与展期日期。 | Charts and return research, not direct execution.图表和收益研究，不是直接成交标的。 |
Do not remove the curve. Replacing every contract with a generic WTI label loses delivery month and can hide contango, backwardation and roll effects. Keep contract-level data even if the interface later displays a continuous chart.
不要把期限结构抹平。若把所有合约都改成同一个 WTI 标签，就会丢失交割月份，也可能掩盖升水、贴水和展期影响。即使前端最终展示连续图表，底层仍应保留单合约数据。
Oil price fields that must travel together原油价格不能脱离这些字段
benchmarkWTI, Brent, Dubai/Oman, or a named futures contract.
price_typeSpot, close, settlement, bid, ask, or last trade.
unitUsually USD per barrel; never infer it silently.
observed_atThe market observation time, not merely your request time.
published_atWhen the source released or revised the value.
sourceSeries, exchange, or provider identity and license context.
benchmark明确 WTI、Brent、Dubai/Oman，或具体期货合约。
price_type区分现货、收盘、结算、买价、卖价和最新成交。
unit通常为美元/桶，但不能靠猜测补全。
observed_at市场观测时间，而不是发起请求的时间。
published_at数据源发布或修订该值的时间。
source保留序列、交易所或供应商身份及授权背景。
Source comparison数据来源对比
| Source | Best for | What to verify |
|---|---|---|
| EIA Open Data | Official U.S. energy series | Series code, release cadence, revisions |
| FRED WTI | Research and historical analysis | Underlying source and observation date |
| FRED Brent | Cross-benchmark research | Calendar gaps and update lag |
| FMP in QVeris | Application-oriented market capability | Plan, symbol convention, timestamps, license |
| 来源 | 适合场景 | 必须核对 |
|---|---|---|
| EIA 开放数据 | 美国官方能源序列 | 序列代码、发布频率和修订 |
| FRED WTI | 研究与历史分析 | 底层来源和观测日期 |
| FRED Brent | 跨基准比较 | 非交易日空缺与更新延迟 |
| QVeris 中的 FMP | 面向应用的行情能力 | 套餐、代码规则、时间戳和授权 |
What a free oil price API must provide免费原油价格 API 应满足哪些条件
The right API identifies the benchmark and price type instead of returning an unexplained “oil price.” Verify whether a value is WTI or Brent, spot or futures, live, delayed, or a daily settlement. A free account does not override market-data licenses or public-display restrictions.
合适的接口不会只返回含义不明的“油价”，而会说明基准和价格类型。需要核对 WTI 或布伦特、现货或期货、实时或延迟，以及是否为日结算价。免费账户也不会自动覆盖行情授权或公开展示限制。
Is the real-time oil price API actually live?
Check the source timestamp, stated delay, trading-session rules, and update interval. “Latest” can mean the latest available settlement rather than an intraday quote.
Does the historical crude oil price API cover WTI and Brent?
Check the first available date, daily or intraday granularity, missing periods, revisions, and whether the series represents spot prices, front-month futures, or settlements.
Does the API return usable JSON?
A useful response identifies benchmark, price, currency, unit, timestamp, and source. Stable field names, documented errors, authentication, and rate-limit headers reduce integration risk.
原油实时价格接口真的实时吗？
检查来源时间戳、延迟标记、交易时段和更新间隔。“最新”也可能只是最近一个结算价，而非盘中报价。
原油历史价格 API 是否覆盖 WTI 和布伦特？
检查最早日期、日线或盘中粒度、缺失区间、修订机制，并确认数据代表现货、近月期货还是结算价。
接口是否返回可用的 JSON？
响应应标明基准、价格、币种、单位、时间戳和来源；稳定字段、错误文档、鉴权和限流响应头能降低接入风险。
Oil price API quality checks for research and production原油价格 API 用于研究与生产前的质量检查
Oil data has additional failure modes beyond ordinary JSON handling: benchmark substitution, contract expiry, unit mismatches, holiday schedules, settlement corrections and continuously rolled history. Validate these explicitly.
原油数据除了常见 JSON 接入问题，还容易出现基准替换、合约到期、单位不一致、节假日日历、结算价更正和连续序列展期等风险，需要单独校验。
Benchmark identity
Require benchmark, grade, location and publisher. Do not fill a missing Brent value with WTI or another crude merely because all are quoted per barrel.
Contract and price field
Store contract month and distinguish last trade, bid, ask, close and settlement. A front-month alias must resolve to the actual contract on every date.
Currency and unit
Persist currency and unit exactly as published. If converting barrels, tonnes or currencies, record the factor, assumptions and FX timestamp.
Freshness and calendars
Compare event time with ingestion time and respect market sessions, weekends and holidays. Label delayed and end-of-day series clearly.
Rolls and historical truth
Save source contracts and roll decisions. Back-adjustment can help return analysis, but adjusted historical price levels are synthetic.
Reconciliation and rights
Sample against EIA Open Data, FRED's WTI series, or the licensed exchange source appropriate to the series, and retain attribution, display and redistribution terms.
基准身份
必须保存基准、品级、地点和发布方。即使都按桶计价，也不能在没有说明的情况下用 WTI 或其他原油填补布伦特缺失值。
合约与价格字段
保存合约月份，并区分最新成交、买价、卖价、收盘价和结算价。近月代码在每个日期都要能还原到实际合约。
币种与单位
按发布方原样保存币种和单位。若换算桶、吨或币种，应记录换算系数、假设和汇率时间戳。
时效与交易日历
比较事件时间与入库时间，并结合交易时段、周末和节假日判断。延迟和日终序列必须清楚标注。
展期与历史真实性
保存底层合约与每次展期决定。后复权有助于收益研究，但复权后的历史价格水平属于合成结果。
来源核对与授权
根据序列类型抽样对照 EIA 开放数据、FRED WTI 序列或已获授权的交易所来源，并保留署名、展示和再分发条款。
Backtest warning: today's cleaned continuous series can contain revised settlements and a roll convention chosen with hindsight. Reconstruct the series using information available at each decision time when results depend on exact historical availability.
回测提醒：今天看到的连续序列可能包含更正后的结算价，也可能采用事后确定的展期规则。若结果依赖当时真实可得信息，应按每个决策时点重新构造数据。
Compare free oil price API options免费原油价格 API 选择清单
| Check检查项 | Questions to ask需要确认 | Good for适合场景 | Common limit常见限制 |
|---|---|---|---|
| Coverage覆盖 | WTI, Brent, spot, futures, gasoline, or diesel?WTI、布伦特、现货、期货、汽油还是柴油？ | Matching the required benchmark.匹配所需基准。 | One benchmark or price type only.只开放一种基准或价格类型。 |
| Freshness时效 | Real time, delayed, end of day, or cached?实时、延迟、日终还是缓存？ | Matching research or live workflows.匹配研究或在线任务。 | Exchange entitlement.交易所授权限制。 |
| Fields字段 | Benchmark, price, currency, barrel unit, timestamp, source?基准、价格、币种、桶单位、时间戳与来源？ | Charts, research, monitoring.图表、研究、监控。 | Free tier may omit history.免费套餐可能不含历史数据。 |
| Access接入 | REST, JSON, SDK, API key, quota, and documented errors?REST、JSON、SDK、API Key、配额和错误文档？ | Reliable application integration.可靠应用接入。 | Trials expire; quotas change.试用到期或配额变化。 |
A defensible integration sequence可靠的接入顺序
- 01
Name the benchmark
Turn “oil price” into a benchmark, price type, unit, and required freshness.
- 02
Call one real request
Test a known date and symbol; retain the raw response.
- 03
Validate clocks
Compare observation, publication, and receipt times.
- 04
Store evidence
Persist source URL, series code, unit, and transformation rule with the value.
- 01
先写清基准
把“原油价格”拆成基准、价格类型、单位和时效要求。
- 02
执行真实请求
用已知日期和代码测试，并保留原始响应。
- 03
核对三个时间
比较观测时间、发布时间和接收时间。
- 04
保存证据
将来源链接、序列代码、单位和转换规则与数值一起保存。
How to use a free oil price API in Python如何用 Python 调用免费原油价格 API
1. Define the benchmark and price type
Choose WTI or Brent, spot or futures, currency, barrel unit, update frequency, and history range before comparing providers.
2. Test one free oil price API request
Start with the provider’s official cURL or Python example and a free API key. Keep credentials outside source code, set a timeout, and record quota headers.
3. Validate before storing the data
Reject missing timestamps, normalize timezones, preserve the raw symbol, detect stale responses, and compare a small sample with an official exchange or licensed vendor reference.
4. Add retries without breaking rate limits
Retry transient failures with exponential backoff and jitter. Respect 429 responses and provider guidance; do not turn a small free quota into a polling loop.
1. 明确基准和价格类型
先确定 WTI 或布伦特、现货或期货、币种、桶单位、更新频率和历史范围，再比较供应商。
2. 发起一次免费原油价格 API 请求
从供应商官方 cURL 或 Python 示例和免费 API Key 开始。密钥放在源码之外，设置超时并记录配额响应头。
3. 入库前校验原油价格
拒绝缺少基准或时间戳的数据，统一时区，保留供应商原始代码和价格类型，检测过期响应，并抽样与权威来源核对。
4. 在限流范围内重试
对临时故障使用指数退避和抖动，遵守 429 与供应商规则，不能把有限免费配额消耗在高频轮询上。
Inspect the capability before calling it调用前先检查能力
QVeris separates capability discovery from provider selection, so an agent can inspect inputs and evidence before a call. Continue with Financial Modeling Prep provider details, then confirm the calling contract in the QVeris REST API reference.
QVeris 将能力发现与供应商选择分开，让 Agent 在调用前先检查输入和证据要求。 可继续打开Financial Modeling Prep 服务商详情，并通过QVeris REST API 参考核对调用契约。
FAQ
Is there a free API for oil prices?
Yes. Some providers offer a permanent low-volume tier or a trial for WTI and Brent. Check current quotas, delays, history, and license terms.
Can I get historical crude oil prices by API?
Yes, but daily and intraday coverage varies. Confirm the benchmark, spot or futures methodology, earliest date, timestamp, and revision policy.
What should an oil price API return?
At minimum: benchmark code, price type, value, currency, unit, timestamp, and source. Add OHLC data only when the series supports it.
Can I use a free oil price API in production?
Only after verifying quota, license, freshness, reliability, corrections, and public-display rights. Free access alone does not prove production suitability.
有免费的原油价格 API 吗？
有些供应商为 WTI 和布伦特提供长期可用但配额较低的套餐，或提供试用额度；仍需检查当前配额、延迟、历史范围和授权条款。
如何通过 API 获取原油历史价格？
先确认 WTI 或布伦特、现货或期货口径、最早日期、时间戳与修订机制，再选择日线或盘中数据。
原油价格接口应返回哪些字段？
至少包含基准代码、价格类型、数值、币种、单位、时间戳和来源；只有数据序列支持时才使用 OHLC。
免费油价 API 能用于生产环境吗？
应先验证配额、授权、时效、稳定性、更正机制与公开展示权利，不能仅凭“免费”判断适用性。