> ## Documentation Index
> Fetch the complete documentation index at: https://docs.financialdatapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Energy & commodities
> Official energy market data from the US EIA, covering spot prices, inventories, production and refining, in the same observation model as macro.
Financial Data API carries official **energy and commodity** series from the U.S. Energy Information Administration (EIA): benchmark spot prices, stock levels, production, and refining activity. They sit under the `commodities` category and flow through the same observation envelope, freshness gating, and provenance as macro indicators, so an oil-inventory print joins cleanly against CPI, rates, or positioning.
## What data is available
Benchmark energy spot prices — for example WTI and Brent crude, and Henry Hub natural gas.
Refined product spot prices — for example NY Harbor gasoline and distillate.
Stock levels — crude oil, gasoline, distillate, and natural gas inventories.
Production volumes — for example US crude oil production.
Refinery inputs / throughput.
Refinery capacity utilization.
These are global-commodity series, so most carry no `country` (the value is a market benchmark, not a national statistic). The specific product or benchmark is identified in the observation metadata and provenance. The publisher is the U.S. Energy Information Administration.
## Query energy data
```bash cURL theme={"theme":"css-variables"}
# Latest reading for a series
curl "https://api.financialdatapi.com/observations/latest?indicator_id=energy_spot_price" \
-H "x-api-key: $FINANCIALDATA_API_KEY"
# Inventory history
curl "https://api.financialdatapi.com/observations?indicator_id=energy_inventory&limit=20&order=desc" \
-H "x-api-key: $FINANCIALDATA_API_KEY"
```
```typescript TypeScript theme={"theme":"css-variables"}
import { FinancialDataApiClient } from "@financialdatapi/client";
const client = new FinancialDataApiClient({ apiKey: process.env.FINANCIALDATA_API_KEY });
const { data } = await client.getLatestObservations({ indicator_id: "energy_spot_price" });
console.log(data);
```
## Response shape
Each row is a standard public observation. The fields most relevant here:
One of the series above, for example `energy_inventory`.
`commodities`.
The value (price, volume, or percent depending on the series).
For example dollars per barrel, million barrels, or percent.
`U.S. Energy Information Administration`.
The period the reading describes.
The exact benchmark or product (WTI vs Brent, gasoline vs distillate, crude vs natural gas) is carried in the observation metadata. Read it from the row, or trace it with `GET /provenance/observations/{observationId}`.
## Related
CFTC futures positioning, including energy contracts.
Trace any value to its EIA release.