> For the complete documentation index, see [llms.txt](https://doc.duaer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/getting-started/eia-petroleum.md).

# EIA fuel spot prices in Duaer

In Duaer: US EIA: spot prices for WTI and Brent crude, gasoline, diesel, heating oil, jet fuel, and propane. One successful search uses 1 credit.
## What you get

Duaer EIA fuel spot prices reads US Energy Information Administration spot prices for one product, newest first, one row per trading hub. Duaer holds the upstream API key; you only send your Duaer key.

Pick Duaer Data → EIA fuel spot prices in the node creator, or open the [data market](/getting-started/data-market.md). Related: [EIA electricity prices](/getting-started/eia-electricity.md), [US Treasury fiscal data](/getting-started/treasury.md).

## When to use it

- Get the latest WTI or Brent crude price.
- Track weekly diesel prices at US hubs.

## When not to use it

- Electricity prices. Use [EIA electricity prices](/getting-started/eia-electricity.md).
- Currency rates. Use [Exchange rates](/getting-started/exchange-rates.md).

## Search on the canvas

1. Open the node creator and pick Duaer Data → EIA fuel spot prices.
2. Fill Product (such as wti). Optional: Frequency (daily, weekly, or monthly).
3. Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

## Call the API

- GET https://api.duaer.com/v1/data/eia-petroleum?product=wti
- Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

## Call skill

Same text as Copy skill.

```
---
name: duaer-eia-petroleum
description: >-
  Duaer EIA fuel spot prices. US EIA: spot prices for WTI and Brent crude, gasoline, diesel, heating oil, jet fuel, and propane.
  One successful search uses 1 Duaer credit.
---

# Duaer EIA fuel spot prices

Duaer EIA fuel spot prices reads US Energy Information Administration spot prices for one product, newest first, one row per trading hub. Duaer holds the upstream API key; you only send your Duaer key.

## When to use

- Get the latest WTI or Brent crude price.
- Track weekly diesel prices at US hubs.

## When not to use

- Electricity prices. Use https://skills.duaer.com/eia-electricity.md.
- Currency rates. Use https://skills.duaer.com/exchange-rates.md.

## Call

`GET https://api.duaer.com/v1/data/eia-petroleum?product=wti`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `product`.

- `product` — `wti`, `brent`, `gasoline`, `reformulated-gasoline`, `diesel`, `heating-oil`, `jet`, or `propane`. Default wti.
- `frequency` — Optional. `daily`, `weekly`, or `monthly`. Default daily.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/eia-petroleum?product=wti` — daily WTI crude prices.
- `GET https://api.duaer.com/v1/data/eia-petroleum?product=diesel&frequency=weekly` — weekly diesel prices by hub.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `period`, `series`, `product` — date and EIA series.
- `value`, `units` — price, such as $/BBL or $/GAL.
- `area` — trading hub when EIA names one.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/eia-electricity.md — Duaer EIA electricity prices
- https://skills.duaer.com/treasury.md — Duaer US Treasury fiscal data

```
## Questions

### How many credits does a EIA fuel spot prices search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

### Why does one product return several rows in Duaer EIA fuel spot prices?

Some products trade at several hubs, such as New York Harbor and the Gulf Coast. Duaer returns one row per hub.

## Related

- [EIA electricity prices in Duaer](https://doc.duaer.com/getting-started/eia-electricity.md)
- [US Treasury fiscal data in Duaer](https://doc.duaer.com/getting-started/treasury.md)