OilPriceAPI Docs
GitHub
GitHub
  • Interactive Explorer

    • Interactive API Explorer
  • Price Data

    • API Reference
    • Get Latest Prices
    • Historical Prices
    • Batch Prices
    • Excel Latest Price Gateway
    • Price Widget Endpoints
    • Price Utility Endpoints
    • Natural Gas Intelligence
  • Commodities

    • List Commodities
    • Get Commodity Details
    • Data Publication & Collection Schedules
  • AI Agents (MCP)

    • Get Market Brief
    • Subscriptions / Watches
    • Agent Subscriptions with MCP
  • Marine Fuels

    • Marine Fuel API
    • List Marine Fuel Ports
    • Get Port Details with Prices
    • Bunker Fuels
    • Maritime Fuels
  • Fuel Surcharges

    • Fuel Surcharge API
  • Premium Endpoints

    • All Prices API - One Call, All Commodities
    • Cushing Oil Storage Intelligence API
    • Drilling Intelligence API
    • Marine Fuels API
    • ICE Brent Futures API
    • Benchmark Close
    • Aviation Fuel Pilot
  • Spreads & Margins

    • Spreads & Margins
    • Crack Spreads
    • Basis Spreads
    • Refining Margins
    • Curve Structure
    • Physical Premiums
  • Market Indicators

    • Market Indicators
    • Fuel Switching
    • Price Context
    • Storage Analytics
    • CFTC Positioning
    • Congressional Trades
    • Market Annotations
  • Futures

    • Futures API
    • ICE Brent Futures
    • ICE WTI Futures
    • ICE Gas Oil Futures
    • NYMEX Natural Gas Futures
    • ICE EUA Carbon Futures
    • EU Carbon Futures
    • TTF Gas Futures
    • LNG JKM Futures
    • UK Carbon Futures
  • Dark Data (Premium)

    • Energy Intelligence API
    • Rig Counts
    • Well Permits
    • Well Production Beta
    • Oil Inventories
    • OPEC Production
    • Drilling Productivity
    • Forecasts (STEO)
  • Well Production (Beta)

    • Well Production Data
    • Well Production API Reference
  • Analytics

    • Analytics API
  • Webhooks API

    • Webhooks API Reference
    • Webhook Endpoint Reference
  • Alerts

    • Price Alerts API
  • Account & Billing

    • Account API
    • API Keys
    • Subscriptions
    • Organizations

Natural Gas (NATURAL_GAS_USD)

Status: Available | Source-timestamped

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
SourcePublished market reporting

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": "market_reporting"
  }
}

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: 7/25/26, 6:41 PM