eia_petroleum
Retrieve current and historical petroleum price data including crude oil, gasoline, diesel, and heating oil from U.S. government sources to analyze energy market trends.
Instructions
Get petroleum/oil prices — crude oil spot prices (WTI, Brent), retail gasoline prices, diesel, heating oil.
Product codes:
EPCBRENT: Brent crude oil spot price
EPCWTI: WTI crude oil spot price
EMM_EPMRU_PTE_NUS_DPG: US regular gasoline retail
EMM_EPMPU_PTE_NUS_DPG: US premium gasoline retail
EMD_EPD2D_PTE_NUS_DPG: US diesel retail
EER_EPJK_PF4_RGC_DPG: US jet fuel spot price
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| product | No | Product type: 'crude' (default — WTI), 'gasoline', 'diesel', 'all'. Or a specific series ID like 'EPCWTI' | |
| frequency | No | Frequency (default: monthly) | |
| start | No | Start date (YYYY-MM or YYYY-MM-DD). Default: 2 years ago | |
| end | No | End date (YYYY-MM or YYYY-MM-DD). Default: latest available | |
| length | No | Max rows to return (API max: 5000). Omit to let date range control volume. | |
| offset | No | Row offset for pagination (use with length) |