Title: OilPriceAPI Widgets
Author: Karl Waldman
Published: <strong>জুলাই 5, 2026</strong>
Last modified: জুলাই 5, 2026

---

Search plugins

![](https://ps.w.org/oilpriceapi-widgets/assets/banner-772x250.png?rev=3597074)

![](https://ps.w.org/oilpriceapi-widgets/assets/icon-256x256.png?rev=3597074)

# OilPriceAPI Widgets

 By [Karl Waldman](https://profiles.wordpress.org/kwaldman/)

[Download](https://downloads.wordpress.org/plugin/oilpriceapi-widgets.1.0.1.zip)

 * [Details](https://bn-in.wordpress.org/plugins/oilpriceapi-widgets/#description)
 * [Reviews](https://bn-in.wordpress.org/plugins/oilpriceapi-widgets/#reviews)
 *  [Installation](https://bn-in.wordpress.org/plugins/oilpriceapi-widgets/#installation)
 * [Development](https://bn-in.wordpress.org/plugins/oilpriceapi-widgets/#developers)

 [Support](https://wordpress.org/support/plugin/oilpriceapi-widgets/)

## Description

Give your visitors live energy prices without writing a line of code. OilPriceAPI
Widgets adds four production-ready widgets to any WordPress site, as shortcodes 
or Gutenberg blocks:

#### Oil Price Ticker

Live Brent Crude, WTI, and Natural Gas prices with 24-hour change indicators. Horizontal
or vertical layouts, dark or light theme.

#### Diesel Price Tracker

Current U.S. national and regional retail diesel prices — East Coast, Midwest, Gulf
Coast, Rocky Mountain, West Coast, and California — updated weekly from EIA data.

#### Fuel Surcharge Calculator

Industry-standard fuel surcharge calculation from the current diesel price and your
configurable base price. Used by trucking and logistics companies to publish surcharge
schedules.

#### Carbon Cost Calculator

CO2 emissions and carbon cost estimates based on EPA emission factors and a configurable
carbon price. Useful for ESG reporting and sustainability content.

All four widgets work immediately after install — **no API key, no account, no configuration
required**. Prices come from [OilPriceAPI](https://www.oilpriceapi.com/?utm_source=wordpress-plugin&utm_medium=readme&utm_campaign=description),
the commodity price API used by energy, logistics, and fintech teams.

#### Features

 * **No API key required** — widgets work immediately after install
 * **Dark and light themes** — match your site design
 * **Lightweight** — each widget is under 30KB, loaded async, only on pages that
   use it
 * **Auto-updating** — prices refresh every 5 minutes
 * **Shortcodes and Gutenberg block** — use either method
 * **Configurable defaults** — set once in Settings > OilPriceAPI, override per 
   widget
 * **Responsive** — works on mobile and desktop

#### For developers

Need the raw data behind the widgets — historical prices, more commodities, or programmatic
access?

 * [Get a free API key](https://www.oilpriceapi.com/signup?utm_source=wordpress-plugin&utm_medium=readme&utm_campaign=developers)—
   the free tier includes 200 requests/month
 * PHP SDK: `composer require oilpriceapi/oilpriceapi`
 * [API documentation](https://docs.oilpriceapi.com/?utm_source=wordpress-plugin&utm_medium=readme)
 * [Interactive API explorer](https://api.oilpriceapi.com/swagger)

### Also Available As

OilPriceAPI is available across many platforms:

 * **Python SDK**: [pypi.org/project/oilpriceapi](https://pypi.org/project/oilpriceapi/)—
   Python client with Pandas integration
 * **Node.js SDK**: [npmjs.com/package/oilpriceapi](https://www.npmjs.com/package/oilpriceapi)—
   TypeScript/JavaScript SDK
 * **PHP SDK**: [packagist.org/packages/oilpriceapi/oilpriceapi](https://packagist.org/packages/oilpriceapi/oilpriceapi)—`
   composer require oilpriceapi/oilpriceapi`
 * **Go SDK**: [github.com/OilpriceAPI/oilpriceapi-go](https://github.com/OilpriceAPI/oilpriceapi-go)—
   Go client
 * **MCP Server**: [github.com/OilpriceAPI/mcp-server](https://github.com/OilpriceAPI/mcp-server)—
   oil prices in Claude and other AI assistants
 * **Google Sheets Add-on**: Custom functions like =OILPRICE(“BRENT_CRUDE_USD”)
 * **Excel Add-in**: Energy price comparison in Excel

Get your free API key at [oilpriceapi.com/signup](https://www.oilpriceapi.com/signup?utm_source=wordpress-plugin&utm_medium=readme&utm_campaign=also-available).

## Blocks

This plugin provides 1 block.

 *   OilPriceAPI Widget Embed live oil prices, diesel prices, fuel surcharge calculator,
   or carbon cost calculator.

## Installation

 1. Upload the `oilpriceapi-widget` folder to `/wp-content/plugins/`
 2. Activate the plugin through the Plugins menu
 3. Use shortcodes in your posts/pages or add the Gutenberg block

#### Quick Start

Add any of these shortcodes to a post or page:

 * `[oilpriceapi_ticker]` — Oil price ticker
 * `[oilpriceapi_diesel]` — Diesel prices
 * `[oilpriceapi_fuel_surcharge]` — Fuel surcharge calculator
 * `[oilpriceapi_carbon]` — Carbon cost calculator

Or search for “OilPriceAPI” in the Gutenberg block inserter.

## FAQ

### Do I need an API key?

No. The widgets are completely free and work without any API key or account. They
use the public OilPriceAPI widget endpoints.

### Where does the price data come from?

Oil and natural gas prices come from OilPriceAPI’s live market data feeds. U.S. 
diesel retail prices come from the EIA (U.S. Energy Information Administration) 
and update weekly. Carbon calculations use EPA emission factors.

### How often do prices update?

Prices refresh automatically every 5 minutes while the page is open. Oil prices 
update during market hours (Sunday 5pm ET to Friday 5pm ET). Diesel prices update
weekly from EIA data.

### Can I customize the appearance?

Yes. Each widget supports dark and light themes. The ticker widget also supports
horizontal and vertical layouts. Configure defaults under Settings > OilPriceAPI,
or override per shortcode.

### Will this slow down my site?

No. Widget scripts load asynchronously and only on pages where widgets are used.
Each script is under 30KB with no external dependencies.

### What commodities are supported?

The ticker widget supports Brent Crude, WTI Crude, and Natural Gas. Many more commodities(
gasoline, heating oil, coal, EU carbon allowances, and others) are available through
the full [OilPriceAPI](https://www.oilpriceapi.com/?utm_source=wordpress-plugin&utm_medium=readme&utm_campaign=faq).

### Can I use multiple widgets on the same page?

Yes. You can place different widget types on the same page. Each widget operates
independently.

### I need historical data or programmatic access — what are my options?

Sign up for a [free API key](https://www.oilpriceapi.com/signup?utm_source=wordpress-plugin&utm_medium=readme&utm_campaign=faq)(
200 requests/month included). PHP developers can install the official SDK with `
composer require oilpriceapi/oilpriceapi`, and you can try every endpoint in the
[interactive API explorer](https://api.oilpriceapi.com/swagger).

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“OilPriceAPI Widgets” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Karl Waldman ](https://profiles.wordpress.org/kwaldman/)
 *   [ oilpriceapi ](https://profiles.wordpress.org/oilpriceapi/)

[Translate “OilPriceAPI Widgets” into your language.](https://translate.wordpress.org/projects/wp-plugins/oilpriceapi-widgets)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/oilpriceapi-widgets/),
check out the [SVN repository](https://plugins.svn.wordpress.org/oilpriceapi-widgets/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/oilpriceapi-widgets/)
by [RSS](https://plugins.trac.wordpress.org/log/oilpriceapi-widgets/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.1

 * Compatibility: tested up to WordPress 7.0
 * Documentation: expanded FAQ, developer resources, and ecosystem links
 * No functional changes

#### 1.0.0

 * Initial release
 * Four widgets: Oil Price Ticker, Diesel Price Tracker, Fuel Surcharge Calculator,
   Carbon Cost Calculator
 * Shortcode support with customizable attributes
 * Gutenberg block with sidebar controls
 * Settings page with default configuration
 * Dark and light theme support

## Meta

 *  Version **1.0.1**
 *  Last updated **1 day ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.0 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/oilpriceapi-widgets/)
 * Tags
 * [diesel](https://bn-in.wordpress.org/plugins/tags/diesel/)[fuel surcharge](https://bn-in.wordpress.org/plugins/tags/fuel-surcharge/)
   [widget](https://bn-in.wordpress.org/plugins/tags/widget/)
 *  [Advanced View](https://bn-in.wordpress.org/plugins/oilpriceapi-widgets/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/oilpriceapi-widgets/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/oilpriceapi-widgets/reviews/)

## Contributors

 *   [ Karl Waldman ](https://profiles.wordpress.org/kwaldman/)
 *   [ oilpriceapi ](https://profiles.wordpress.org/oilpriceapi/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/oilpriceapi-widgets/)