Oil Price API Documentation - Quick Start in 5 Minutes | REST API
GitHub
GitHub
  • Interactive Explorer

    • Interactive API Explorer
  • Price Data

    • API Reference
    • Get Latest Prices
    • Historical Prices
  • Commodities

    • List Commodities
    • Get Commodity Details
  • Marine Fuels

    • List Marine Fuel Ports
    • Get Port Details with Prices
  • Premium Endpoints

    • All Prices API - One Call, All Commodities
    • Cushing Oil Storage Intelligence API
    • Drilling Intelligence API
    • Marine Fuels API
    • ICE Brent Futures API

Natural Gas (NATURAL_GAS_USD)

Status: ✅ Available | ⚡ Real-time | 📊 Live Data

Henry Hub Natural Gas is the pricing point for natural gas futures contracts traded on the New York Mercantile Exchange (NYMEX) and the de facto benchmark for US natural gas prices.


Quick Reference

PropertyValue
Commodity CodeNATURAL_GAS_USD
NameNatural Gas
CategoryNatural Gas
CurrencyUSD
UnitUSD/mmBtu
Current Price$3.85

| Last Updated | 2025-12-16T15:24:09Z | | Source | oilprice.ft |


Get Latest Price

GET/v1/prices/latest?by_code=NATURAL_GAS_USD

Request

curl -X GET "https://api.oilpriceapi.com/v1/prices/latest?by_code=NATURAL_GAS_USD" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Accept: application/json"

Response

{
  "status": "success",
  "data": {
    "price": 3.85,
    "formatted": "$3.85",
    "currency": "USD",
    "code": "NATURAL_GAS_USD",
    "created_at": "2025-12-16T15:24:09Z",
    "type": "spot_price",
    
    "source": "oilprice.ft"
  }
}

Get Historical Data

Past 24 Hours

GET /v1/prices/past_day?by_code=NATURAL_GAS_USD

Past 7 Days

GET /v1/prices/past_week?by_code=NATURAL_GAS_USD

Past 30 Days

GET /v1/prices/past_month?by_code=NATURAL_GAS_USD

Past Year

GET /v1/prices/past_year?by_code=NATURAL_GAS_USD

See Historical Prices API for full documentation.


Code Examples

cURL

# Get latest price
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://api.oilpriceapi.com/v1/prices/latest?by_code=NATURAL_GAS_USD"

Python

import requests

api_key = "YOUR_API_KEY"
url = "https://api.oilpriceapi.com/v1/prices/latest"

response = requests.get(
    url,
    params={"by_code": "NATURAL_GAS_USD"},
    headers={"Authorization": f"Token {api_key}"}
)

data = response.json()
print(f"Natural Gas: {data['data']['formatted']}")

JavaScript

const apiKey = 'YOUR_API_KEY';
const code = 'NATURAL_GAS_USD';

fetch(`https://api.oilpriceapi.com/v1/prices/latest?by_code=${code}`, {
  headers: {
    'Authorization': `Token ${apiKey}`
  }
})
  .then(res => res.json())
  .then(data => {
    console.log(`Natural Gas: ${data.data.formatted}`);
  });

Related Endpoints

  • Get All Prices - Get all commodity prices in one call
  • Historical Prices - Time-series data
  • Commodities List - Browse all commodities

Last Updated: 2025-12-16

Last Updated: 12/28/25, 12:24 AM