NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Oil Price API

The Oil Price API provides real-time and historical crude oil prices through a simple REST API. Query the WTI (West Texas Intermediate) and Brent crude benchmarks, plus natural gas, heating oil, and RBOB gasoline, and get clean JSON back from a single GET request.

Available endpoints:

For gold, metals, grains, and 25+ other commodities, see our Commodity Price API.

The API covers these oil & energy benchmarks (sample daily-close prices):

BenchmarktypeSample price
WTI Crudewti$67.82/bbl
Brent Crudebrent$71.45/bbl
Natural Gasnatural_gas$4.12/MMBtu
Heating Oildiesel$2.31/gal
RBOB Gasolinegasoline$2.14/gal
Online
(4.5)

From 8,188 users

2,700+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
365ms396ms416ms691ms1291ms

Didn't find what you were looking for? Suggest an improvement

3 endpoints

https://api.api-ninjas.com/v1/oilprice

Returns the current price for an oil or energy benchmark. Free accounts receive the daily closing price for WTI and Brent; premium members get real-time prices for all benchmarks. For official physical spot prices, see /v1/oilspot; for historical prices, see /v1/oilpricehistorical.

Parameters

  • type  optional

    The benchmark to return. One of wti (default), brent, natural_gas, gasoline, or diesel (No. 2 heating oil / ULSD). Each maps to a benchmark you can also explore on its own page: WTI Crude, Brent Crude, Natural Gas, Heating Oil, RBOB Gasoline.

  • currency  optional Premium only

    ISO 4217 currency code to convert the price into (e.g. EUR, GBP). Defaults to USD.

  • unit  optional Premium only

    Target unit to convert the price into. Must match the benchmark's dimension: crude oil, gasoline, and diesel (priced by volume) accept barrel, gallon, liter, or cubic_meter; natural gas (priced by energy) accepts MMBtu, MWh, GJ, or therm.

  • types  optional Business tier and above, or any annual plan

    Comma-separated list of benchmarks for a batch request (e.g. wti,brent,natural_gas).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

The /v1/oilprice endpoint returns a JSON object with the following fields, or an error if the request is unsuccessful.

  • type

    The requested benchmark (e.g. wti).

  • name

    The display name of the benchmark (e.g. Crude Oil).

  • price

    The current price (daily close on the free tier, real-time on premium).

  • unit

    The quote unit (e.g. barrel, gallon, MMBtu).

  • currency_unit

    The price currency (USD by default).

  • previous_close

    The previous session's closing price.

  • change_24h

    The change versus the previous close.

  • change_24h_percent

    The percent change versus the previous close.

  • high_24h Premium only

    The day's high price.

  • low_24h Premium only

    The day's low price.

  • high_52w Premium only

    The 52-week high price.

  • low_52w Premium only

    The 52-week low price.

  • updated

    The Unix timestamp (in seconds) of the price.

  • futures_contract

    The futures contract price is quoted for (e.g. CLX26, November 2026 WTI).

  • futures_contract_month

    The contract's delivery month (YYYY-MM).

Live Demo

Live demo · no API key required
Query parameters
type

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/oilprice?type=wti
Sample response
{
"unit": "barrel",
"currency_unit": "USD",
"name": "Crude Oil",
"price": 84.8,
"change_24h_percent": -6.25691,
"change_24h": -5.66,
"low_24h": 83.9,
"high_24h": 86.12,
"high_52w": 119.48,
"low_52w": 54.98,
"previous_close": 90.46,
"updated": 1785128296,
"type": "wti",
"futures_contract": "CLU26",
"futures_contract_month": "2026-09"
}

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/oilprice?type=wti" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Premium only

https://api.api-ninjas.com/v1/oilspot

Returns the daily spot price at a benchmark's physical delivery hub, for example WTI at Cushing, Oklahoma, or natural gas at Henry Hub. For the live futures price, see /v1/oilprice.

Update frequency: daily prices, published with a delay, so they trail the futures price by several days. date is the trading day each price is for.

Parameters

  • type  optional

    The benchmark: wti (default), brent, natural_gas, gasoline, or diesel.

  • currency  optional

    ISO 4217 currency code to convert the price into (e.g. EUR). Defaults to USD.

  • unit  optional

    Target unit, in the benchmark's dimension: barrel, gallon, liter, or cubic_meter for oil, gasoline, and diesel; MMBtu, MWh, GJ, or therm for natural gas.

  • types  optional Business tier and above, or any annual plan

    Comma-separated list of benchmarks for a batch request (e.g. wti,brent,natural_gas).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

The /v1/oilspot endpoint returns a JSON object with the following fields, or an error if the request is unsuccessful.

  • type

    The requested benchmark (e.g. wti).

  • name

    The display name of the benchmark.

  • price

    The spot price: the price for immediate delivery.

  • spot_type

    How the spot price is produced: assessed (the daily spot price at the benchmark's delivery hub).

  • date

    The trading day the price is for (YYYY-MM-DD). Daily spot prices are published with a delay, so it trails by several days.

  • benchmark

    The physical spot benchmark: WTI Cushing, Oklahoma; Brent Europe; Henry Hub; New York Harbor conventional regular gasoline; or New York Harbor ultra-low sulfur diesel.

  • previous_close

    The spot price on the previous trading day.

  • change_24h

    The change versus the previous trading day.

  • change_24h_percent

    The percent change versus the previous trading day.

  • updated

    The Unix timestamp (in seconds) of the spot price.

  • unit

    The quote unit (changes when the unit parameter is used).

  • currency_unit

    The price currency (USD by default).

Live Demo

Live demo
Query parameters
type

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/oilspot?type=wti
Sample response
{
"type": "wti",
"name": "WTI Crude Oil",
"price": 85.12,
"spot_type": "assessed",
"date": "2026-07-21",
"benchmark": "WTI Cushing, Oklahoma",
"previous_close": 86.04,
"change_24h": -0.92,
"change_24h_percent": -1.0693,
"updated": 1784667600,
"unit": "barrel",
"currency_unit": "USD"
}

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/oilspot?type=wti" \ -H "X-Api-Key: YOUR_API_KEY"

Premium only

https://api.api-ninjas.com/v1/oilpricehistorical

Returns historical oil price data in OHLCV (Open, High, Low, Close, Volume) format. The data is returned in descending order (most recent first).

Parameters

  • type  optional

    The benchmark: wti (default), brent, natural_gas, gasoline, or diesel.

  • period  optional

    Time interval between data points. Valid values are: 1m, 5m, 15m, 30m, 1h, 4h, 1d. Default is 1h.

  • start  optional

    Start timestamp in Unix format. If not provided, defaults to a recent window for the chosen period.

  • end  optional

    End timestamp in Unix format. If not provided, defaults to current time.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

The /v1/oilpricehistorical endpoint returns a JSON array of OHLCV objects with the following fields, or an error if the request is unsuccessful.

  • open

    The opening price for this time period.

  • low

    The lowest price during this time period.

  • high

    The highest price during this time period.

  • close

    The closing price for this time period.

  • volume

    The trading volume during this time period.

  • time

    The timestamp for this data point in Unix format (in seconds).

  • provisional

    Whether daily-bar volume is still being finalized.

Live Demo

Live demo
Query parameters
type
period
start
end

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/oilpricehistorical?type=wti&period=1h
Sample response
[
{
"open": 67.4,
"low": 67.05,
"high": 68.11,
"close": 67.82,
"volume": 154200,
"time": 1741046400
},
{
"open": 67.91,
"low": 67.2,
"high": 68.05,
"close": 67.4,
"volume": 168300,
"time": 1740960000
},
"..."
]

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/oilpricehistorical?type=wti&period=1h" \ -H "X-Api-Key: YOUR_API_KEY"

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Oil Price API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • The Oil Price API returns real-time and historical prices for the major energy benchmarks: WTI crude oil (type=wti), Brent crude oil (type=brent), natural gas, heating oil (type=diesel), and RBOB gasoline. Use /v1/oilprice for the latest price and /v1/oilpricehistorical for OHLCV history. For metals, grains, and 25+ other commodities, see the Commodity Price API.
  • Yes. Create a free account to get an instant API key and start pulling oil prices at no cost. The free tier returns the daily closing price for WTI (type=wti) and Brent (type=brent); premium plans unlock real-time prices, all five benchmarks, currency and unit conversion, and the historical endpoint. One key works across every API Ninjas endpoint.
  • Send a GET request to /v1/oilprice?type=wti for WTI or type=brent for Brent, passing your key in the X-Api-Key header. The response is a JSON object with type, name, price (USD per barrel), unit, currency_unit, and an updated Unix timestamp. Copy-paste examples in Python, cURL, and Node.js are shown above. Real-time prices require a premium plan; free keys return the daily close.
  • Yes, from a separate endpoint. /v1/oilprice returns the live futures price, with the contract it is quoted for in futures_contract. /v1/oilspot returns the daily spot price at the benchmark's physical delivery hub (for example WTI at Cushing, Oklahoma, or Henry Hub for natural gas), named in benchmark. Daily spot prices are published with a delay, so date tells you which trading day the spot price is for; it typically trails the futures price by several days. /v1/oilspot is available on premium plans.
  • Call /v1/oilpricehistorical with a type plus the optional period (1m, 5m, 15m, 30m, 1h, 4h, 1d; default 1h) and start/end Unix timestamps. It returns OHLCV data (open, high, low, close, volume, time) most-recent-first. The historical endpoint is premium only.
  • Yes. On /v1/oilprice, add the currency parameter (an ISO 4217 code like EUR or GBP) and/or the unit parameter (barrel, gallon, liter, cubic_meter) to convert the price — for example, crude oil per gallon in euros. Conversion is available on premium plans.
  • WTI (West Texas Intermediate) is the primary US crude benchmark, traded on CME/NYMEX; Brent is the global benchmark used to price much of the world's internationally-traded crude, traded on ICE. The two usually differ by a few dollars per barrel (the Brent-WTI spread). Query either from the same API with type=wti or type=brent, or see the dedicated WTI and Brent pages.

Explore API integration use cases for recommended APIs and workflow examples.