OilPriceAPI Fuel Widgets adds source-dated U.S. retail-fuel data to WordPress as shortcodes or a Gutenberg block.

Fuel Price Ticker

National U.S. diesel and regular gasoline averages. Each result shows its EIA observation week, weekly cadence, unit, and source.

U.S. Diesel Price

The national U.S. diesel retail average, quoted in USD per gallon and labeled with its observation week.

Fuel Surcharge Calculator

Calculates the percentage by which the weekly national diesel average exceeds a base price configured by the site owner. It does not describe the result as an industry standard or a contractual surcharge.

Features

Source date, weekly cadence, currency, unit, and EIA attribution in every successful widget
Dark and light themes
Shortcodes and Gutenberg block
Server-side requests with no remote executable code
One-hour validated cache
Last successful result for up to 48 hours after an error, visibly labeled as a cached copy
Fail-closed handling for unavailable, rate-limited, timed-out, empty, or malformed responses
No API key required for the public EIA series

External service

This plugin uses OilPriceAPI to retrieve the EIA retail-fuel series displayed by the widgets.

The WordPress server sends a GET request to https://www.oilpriceapi.com/api/widgets/fuel-prices at most once per hour while a page containing a widget is requested. OilPriceAPI receives the site server’s IP address and standard HTTP request metadata. The plugin does not send the visitor’s IP address, WordPress user data, page content, or an API credential.

The underlying retail-fuel observations come from the U.S. Energy Information Administration and are public domain at the source. OilPriceAPI delivers and validates the response; it does not grant rights in underlying data.