HO1: NY Harbor ULSD (heating oil) futures symbol and API code

Latest HEATING_OIL_USD value

HEATING_OIL_USD is a market-reported price for the front-month contract, captured from published market sources several times an hour on trading days. It is not an official exchange settlement price, it is not the exchange's own data feed, and it is not the HO1 quote itself. Expect small differences from both, and read the source timestamp before comparing.

OilPriceAPI grants no rights in source data. Check the terms for each source before public display or redistribution. Data use.

What HO1 means

HO1 is how Bloomberg labels the generic first HO future. HO is the product code the exchange gives its NY Harbor ULSD futures, and the 1 means the nearest contract month.

The exchange names the contract NY Harbor ULSD (ultra-low sulfur diesel) and still refers to it as Heating Oil as well, which is why the code is HO.

The contract behind HO1

Source: the exchange's NY Harbor ULSD futures contract specs. The exchange can change these terms; its page is the record.

HEATING_OIL_USD is a wholesale futures-market price for diesel-grade fuel at New York Harbor. It is not a delivered residential heating oil price; that series is HEATING_OIL_RESIDENTIAL_USD.

Month codes for a single contract

HO1 follows the nearest month. One specific contract is written as the product code, a month letter and the year. HOZ6 is the December 2026 contract: HO for the product, Z for December, 6 for the year.

• F January
• G February
• H March
• J April
• K May
• M June
• N July
• Q August
• U September
• V October
• X November
• Z December

Source: the exchange group's contract month codes.

Get HEATING_OIL_USD from the API

There is no HO1 code in the API. Request HEATING_OIL_USD from the latest-prices endpoint:

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

The same request in Python, standard library only:

import json
import urllib.request

request = urllib.request.Request(
    "https://api.oilpriceapi.com/v1/prices/latest?by_code=HEATING_OIL_USD",
    headers={"Authorization": "Token YOUR_API_KEY"},
)
with urllib.request.urlopen(request, timeout=10) as response:
    quote = json.load(response)["data"]

print(quote["price"], quote["as_of"], quote["contract_month"])

• as_of is when the value was observed. Compare it with the time on the quote you are checking against.
• contract_month names the delivery month the value refers to. Read it rather than assuming, especially in the days before a contract stops trading.
• For the physical spot price rather than futures, the API names ULSD_DIESEL_USD as the counterpart series.

Latest prices are available on the free plan. Price history and futures curves by contract month need a paid plan; see pricing. Response fields are documented in the latest-prices API reference.