---
title: "Get NYMEX Natural Gas futures curve"
method: GET
path: "/v1/futures/natural-gas"
tags: ["Futures", "Premium"]
---

# Get NYMEX Natural Gas futures curve

`GET /v1/futures/natural-gas`

Complete NYMEX Henry Hub Natural Gas futures curve with contract prices,
front month identification, and rollover indicators.

**Key Features:**
- `is_front_month`: Boolean flag identifying front month contract
- `days_to_expiry`: Days until contract settlement
- `contract_status`: "front_month", "near_expiry", or "active" on the live curve (expired contracts are filtered out; historical/OHLC endpoints still return "expired" for point-in-time queries)

**Premium Feature** - Futures data access required.

## Response `200`

Natural Gas futures data

- NatGasFuturesResponse
  - `commodity` string
  - `source` string
  - `updated_at` string, date-time
  - `contracts` object[]
    - `contract_month` string
    - `last_price` number
    - `currency` string
    - `unit` string
    - `days_to_expiry` integer
    - `contract_status` 'front_month' | 'near_expiry' | 'active' | 'expired' — Contract lifecycle state. "expired" is returned only by historical/OHLC endpoints; the live curve filters expired contracts out.
    - `is_front_month` boolean
    - `expiry_date` string, date
    - `updated_at` string, date-time
  - `metadata` object
    - `total_contracts` integer
    - `front_month_contract` string
    - `data_source` string
    - `enhanced_data` boolean

## Other responses

- `401` — Unauthorized
- `403` — Premium access required
- `500` — Unexpected server error. Retry transient failures with bounded backoff and retain the request ID when contacting support.

---

[API](https://skmtc.net/oilpriceapi/apis/oil-price-api-v1.md) · [All operations](https://skmtc.net/oilpriceapi/apis/oil-price-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oilpriceapi/oil-price-api-v1/revisions/5a5ce424cacc/schema)