Coverage
What you get
| Item | Detail |
|---|---|
| Product code | X-COMMODITIES |
| Coverage | Public-domain spot series: WTI and Brent crude, Henry Hub natural gas (EIA), plus farm and monthly series from USDA and IMF. Daily gold and silver once we license a benchmark. |
| Granularity | Daily, weekly and monthly, depending on the series |
| History | As far back as each public source publishes |
| Delivery | REST and CSV or Parquet files |
| Update speed | Daily, after the source agency publishes |
This product is about spot benchmarks. If you want exchange-traded oil or gold contracts with intraday bars, those live in futures historical data and continuous futures.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | e.g. WTI, BRENT, HENRY-HUB, XAUUSD |
name |
string | yes | e.g. WTI crude oil, Cushing spot |
interval |
string | yes | 1d, 1w, 1mo |
date / timestamp |
string | yes | Price date or time |
value |
number | yes for single-value series | Spot price |
open, high, low, close |
number | optional | Where bars exist |
unit |
string | yes | e.g. USD per barrel |
currency |
string | yes | e.g. USD |
change_percent |
number | optional | Day change |
source |
string | yes | Benchmark publisher, e.g. U.S. EIA |
Example record (illustrative values, not a current price):
{
"symbol": "WTI",
"name": "WTI crude oil, Cushing spot",
"interval": "1d",
"date": "2026-11-17",
"value": 71.36,
"unit": "USD per barrel",
"currency": "USD",
"source": "U.S. Energy Information Administration"
}
Sample data
Sample data
Oil and Natural Gas Spot Prices. Daily WTI, Brent and Henry Hub spot prices, the last 120 trading days of each. The sample keeps the source column names (price, source_series), which map to value and source in the API. First 10 rows:
| symbol | name | date | price | unit | source_series |
|---|---|---|---|---|---|
| WTI | WTI crude oil, Cushing OK | 2026-05-29 | 91.16 | USD/barrel | DCOILWTICO |
| WTI | WTI crude oil, Cushing OK | 2026-06-01 | 95.96 | USD/barrel | DCOILWTICO |
| WTI | WTI crude oil, Cushing OK | 2026-06-02 | 97.47 | USD/barrel | DCOILWTICO |
| WTI | WTI crude oil, Cushing OK | 2026-06-03 | 99.76 | USD/barrel | DCOILWTICO |
| WTI | WTI crude oil, Cushing OK | 2026-06-04 | 96.83 | USD/barrel | DCOILWTICO |
| WTI | WTI crude oil, Cushing OK | 2026-06-05 | 94.32 | USD/barrel | DCOILWTICO |
| WTI | WTI crude oil, Cushing OK | 2026-06-08 | 95 | USD/barrel | DCOILWTICO |
| WTI | WTI crude oil, Cushing OK | 2026-06-09 | 91.9 | USD/barrel | DCOILWTICO |
| WTI | WTI crude oil, Cushing OK | 2026-06-10 | 93.68 | USD/barrel | DCOILWTICO |
| WTI | WTI crude oil, Cushing OK | 2026-06-11 | 91.58 | USD/barrel | DCOILWTICO |
Source: U.S. Energy Information Administration via FRED
Use cases
Use cases
Brent minus WTI spread. Pivot on symbol and subtract WTI from BRENT by date. The spread moves with US export capacity and pipeline bottlenecks around Cushing, and some traders fade it when it stretches.
Energy input for stock models. Join the daily WTI value to airline or refiner bars on date. A rolling 60-day correlation tells you how much of a stock's move is really oil.
Gas seasonality. Group HENRY-HUB by month of date to see the winter heating pattern. Useful context before trading gas futures or utility stocks into the cold season.
Inflation tracking. Energy is the most volatile part of CPI. Pair the monthly average of WTI with the CPI series in our economic data API to see how much of a print came from fuel.
Code
Code examples
Example: daily WTI for 2026.
curl "https://api.marketdata.co/v1/commodities/prices?symbol=WTI&interval=1d&start=2026-01-01" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, Brent minus WTI from the free sample.
import pandas as pd
px = pd.read_csv("us-energy-spot-prices.csv", parse_dates=["date"])
wide = px.pivot(index="date", columns="symbol", values="price")
wide["brent_wti"] = wide["BRENT"] - wide["WTI"]
print(wide["brent_wti"].describe())
Pricing
Pricing
| Plan | Commodity prices |
|---|---|
| Free, $0 | Public spot series (EIA energy, USDA, IMF monthly) |
| Starter, $29/mo | Adds daily gold and silver, once the benchmark licence is in place |
Public series are also a free bulk download. Among the providers we studied, plans that include commodity prices run from $0 to $450 a month.
Side by side
How we compare
13 of the 50 providers we studied sell spot commodity prices, and about half of those give them away, usually by repackaging the same public EIA series. So we don't charge for public data either. Where we differ: every series carries its unit and source, uses the same symbol and date layout as our stock and FX data, and the files are yours to keep. Gold and silver benchmarks are licensed by their administrator, which is the one part we'll charge for.
FAQ
Frequently asked questions
Are these spot or futures prices?
Spot. WTI here is the Cushing, Oklahoma spot price published by the EIA, not a futures contract. For contract prices, see our futures products.
Are prices adjusted?
No. Spot prices are published as reported by the source, in the unit shown on each row. There are no rolls or splits to adjust for.
What time zone are the dates?
Each date is the trading day the source assigns the price to. Daily spot series have no intraday time, so there's no time zone conversion to worry about.
Do you have gold and silver prices?
They are planned for Starter once we license a daily benchmark. The LBMA gold and silver prices are administered by ICE Benchmark Administration, so we can't repackage them for free.
Is the data real-time?
No. These are daily benchmark series, updated after each agency publishes. For intraday oil or gold, use futures bars.
Which formats are available?
JSON from the API, and CSV or Parquet for files. The free sample ZIP contains CSV and JSON.
Keep reading
Related
- Asset hub: Cross-asset data
- Futures: Crude Oil (CL), Gold (GC), Natural Gas (NG)
- Docs: API Reference: Economic Data and Calendars
- Learn: Futures Contract Months and Symbols