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
  • Futures

    • Futures API
    • ICE Brent Futures
    • ICE WTI Futures
    • ICE Gas Oil Futures
    • NYMEX Natural Gas Futures
  • Dark Data (Premium)

    • Dark Data API
    • Rig Counts
    • Oil Inventories
    • OPEC Production
    • Drilling Productivity
    • Forecasts (STEO)
  • Analytics

    • Analytics API
  • Account & Billing

    • Account API

NYMEX Natural Gas Futures

Real-time and historical Natural Gas futures data from NYMEX (Henry Hub).

Endpoints

MethodEndpointDescription
GET/v1/futures/natural-gasCurrent contract prices
GET/v1/futures/natural-gas/historicalHistorical data
GET/v1/futures/natural-gas/ohlcDaily OHLC
GET/v1/futures/natural-gas/intraday5-minute intervals
GET/v1/futures/natural-gas/spreadsCalendar spreads
GET/v1/futures/natural-gas/curveFutures curve
GET/v1/futures/natural-gas/spread-historySpread history

Current Prices

GET /v1/futures/natural-gas

Response

{
  "commodity": "NATURAL_GAS_FUTURES",
  "source": "NYMEX",
  "updated_at": "2025-12-29T14:30:00.000Z",
  "trading_hours": "18:00-17:00 ET",
  "contracts": [
    {
      "contract_month": "2026-02",
      "last_price": 3.425,
      "currency": "USD",
      "unit": "MMBtu",
      "open": 3.395,
      "close": 3.420,
      "high": 3.455,
      "low": 3.380,
      "volume": 234567,
      "change_percent": 0.73
    }
  ]
}

Historical Data

GET /v1/futures/natural-gas/historical

Parameters

ParameterTypeDefaultDescription
fromdate30 days agoStart date
todatetodayEnd date
contractsstringallContract months
formatstringjsonjson or csv

OHLC Data

GET /v1/futures/natural-gas/ohlc

Parameters

ParameterTypeDefaultDescription
daysinteger30Period (1-365)
contractstringfront monthContract month

Intraday Data

GET /v1/futures/natural-gas/intraday

Parameters

ParameterTypeDefaultDescription
datedatetodayTrading date
contractstringfront monthContract month

Calendar Spreads

Natural gas spreads are particularly important for seasonal analysis.

GET /v1/futures/natural-gas/spreads

Parameters

ParameterTypeDefaultDescription
pairsstringconsecutiveSpread pairs
daysinteger30Analysis period

Use Cases

  • Winter/Summer Spreads: Analyze seasonal price differentials
  • Storage Economics: Calculate injection/withdrawal economics
  • Basis Trading: Compare regional price differences

Futures Curve

GET /v1/futures/natural-gas/curve

Parameters

ParameterTypeDefaultDescription
datedatetodayAnalysis date

Seasonal Patterns

Natural gas curves often show:

  • Winter Premium: Higher prices for winter months (Nov-Mar)
  • Shoulder Season Lows: Lower prices in spring/fall
  • Storage Injection: Summer contango for storage fill

Spread History

GET /v1/futures/natural-gas/spread-history

Parameters

ParameterTypeRequiredDescription
front_contractstringYesFront contract
back_contractstringYesBack contract
daysintegerNoHistory period

Quick Example

import requests

response = requests.get(
    "https://api.oilpriceapi.com/v1/futures/natural-gas",
    headers={"Authorization": "Token YOUR_API_KEY"}
)
data = response.json()

print(f"Nat Gas Front Month: ${data['contracts'][0]['last_price']}/MMBtu")

Trading Hours

SessionTime (ET)Time (GMT)
Electronic18:00-17:0023:00-22:00
Settlement14:30 ET19:30 GMT

Related

  • ICE Brent Futures
  • ICE WTI Futures
  • ICE Gas Oil Futures
Last Updated: 12/30/25, 11:36 AM
Prev
ICE Gas Oil Futures