Historical Commodity Prices API - Gold, Oil, Cocoa & More

The Commodity API gives you clean, accurate, and real-time pricing for over 520 commodities - from crude oil and gold to wheat, cocoa, and copper. Whether you're forecasting markets or feeding financial dashboards, this API brings you every price point. Pick any date, and each commodity comes back with its open, high, low, and close, or the last earlier price and its date if the market was closed that day.

Try Playground Get Free API Key

10K Free Credits, No Credit Card Required

Features

Instant Access to 520+ Commodities

Bullions, Metals, energy, agriculture, industrial goods, livestock, and more - all under one endpoint.

30+ Years of Historical Data

Go back to 1990. Understand trends, not just today’s numbers.

Open, High, Low, and Close

Each commodity comes back with its opening, highest, lowest, and closing price for the day. For commodities published monthly, only the closing price is available, so read close for those.

The Last Available Price When a Day Has None

Weekends, holidays, and slow-publishing series all leave gaps. When a commodity has no price on the date you ask for, you get the last price before it, and rates.{symbol}.date shows the day that price is actually from.

Daily Settlement for Futures Delivery Months

Individual futures months like WTIOIL-FUT-DEC27 have one row per trading day, and their close is the exchange's daily settlement price, updated if the final figure differs from the preliminary one. Contract month history starts in October 2026, so use the continuous symbol, like WTIOIL-FUT, for anything older.

History for Retired and Expired Symbols

A deprecated symbol keeps its history up to the deprecation date, and an expired futures month keeps its daily history up to expiry. Symbols are never reused, so old reports stay reproducible.

API Endpoint

GEThttps://api.apifreaks.com/v2.0/commodity/rates/historical

Test

Explore the complete API reference with detailed request parameters, response fields, error codes, and code examples visit API Reference.

Language

$ pip install requests
import requests 

url = "https://api.apifreaks.com/v2.0/commodity/rates/historical?symbols=WTIOIL-SPOT%2CXAU&date=2025-01-10&apiKey=API-KEY"

payload = {}
headers = {
	'X-apiKey': 'API-KEY'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

How-To-Guides

Retrieve Historical Commodity Prices

It's as simple as: Pick a symbol, choose a date, get the price.

Here's how it works:

Each commodity has a unique symbol. For example:

XAU is for Gold (USD per troy ounce)
WTIOIL-SPOT is for SPOT Crude Oil (USD per barrel)
CC is for Cocoa (USD per metric ton)

Use any date since January 1, 1990 and you will be shown the results for the requested date point.

There's nothing else to configure. It's just reliable price history that works for people who need real answers - not just raw feeds.


$ curl -X 'GET'   'https://api.apifreaks.com/v2.0/commodity/rates/historical?symbols=WTIOIL-SPOT%2CXAU&date=2025-01-10&apiKey=API-KEY'
# Response
 {
  "success": true,
  "date": "2025-01-10",
  "rates": {
    "WTIOIL-SPOT": {
      "date": "2025-01-10",
      "open": 73.77,
      "high": 77.16,
      "low": 73.55,
      "close": 75.97
    },
    "XAU": {
      "date": "2025-01-10",
      "open": 2669.93,
      "high": 2697.85,
      "low": 2663.61,
      "close": 2689.44
    }
  }
}

If some of the requested symbols are invalid, the API returns a 206 Partial Content response with the resolved symbols in rates and an additional unresolved object explaining which symbols were skipped. No credits are charged for unresolved symbols. If none of the requested symbols are valid, a 404 SYMBOL_NOT_FOUND error is returned instead, with the same unresolved object.

Handle Mistyped Symbols

Send your symbol list as you have it. The response answers what it can and explains the rest.


$ curl -X 'GET'   'https://api.apifreaks.com/v2.0/commodity/rates/historical?apiKey=API-KEY&symbols=xau,wtioil-fut,zw,pl&date=2024-01-04'
# Response
{
  "success": true,
  "date": "2024-01-04",
  "rates": {
    "WTIOIL-FUT": {
      "date": "2024-01-04",
      "open": 72.28,
      "high": 72.88,
      "low": 72.21,
      "close": 72.73
    },
    "XAU": {
      "date": "2024-01-04",
      "open": 2042.92,
      "high": 2050.79,
      "low": 2036.04,
      "close": 2044.18
    },
    "XPT": {
      "date": "2024-01-04",
      "open": 972.4,
      "high": 976.95,
      "low": 953.25,
      "close": 956.95
    }
  },
  "unresolved": {
    "ZW": {
      "message": "Did you mean ZW-SPOT (Wheat Spot) or ZW-FUT (Wheat Futures)?",
      "suggestions": [

The lowercase symbols were matched as usual. PL was answered as XPT, and ZW wasn't answered because it could mean wheat spot or wheat futures, so this response has a 206 status. If every symbol is valid but none has a price on or before the date, the API returns a 404.

Frequently Asked Questions

Each commodity starts from its own first date, and the longest series, like gold, go back to 1980. Futures delivery months start in October 2026, so use the continuous futures symbol for older futures prices.

You get the last price before that date. Check rates.{symbol}.date to see which day the price is from.

No. Commodities published monthly only have a closing price, so use close for those.

Yes. Use the contract symbol, like WTIOIL-FUT-DEC27. Its close is the exchange's daily settlement, and its history stays available after the contract expires.

Historical prices come in each commodity's own currency, which you can see with the Commodity Symbols endpoint. Most commodities are priced in USD.

For daily prices across a range of up to a year, use the APIFreaks Commodities Time Series API. For just the change between two dates, use the APIFreaks Commodity Fluctuation API.

Pricing

To use the Historical Commodity Prices API, API credits are required. We only charge for successful queries, defined by a 2xx status code. If a request results in a 4xx or 5xx status code, no credits will be deducted, and any credits already charged will be refunded.

For each successful request, 40 credits will be charged as a base fee, plus 1 additional credit per commodity symbol requested.

Utilize the Credits Usage API to efficiently monitor your recent consumption of both one-off and subscription credits. This API provides a streamlined way to track and manage your credit usage, helping you stay informed about your remaining balance and optimize your resource allocation effectively.

Historical Commodity Prices, Delivered Simply.

Features

Instant Access to 520+ Commodities

30+ Years of Historical Data

Open, High, Low, and Close

The Last Available Price When a Day Has None

Daily Settlement for Futures Delivery Months

History for Retired and Expired Symbols

API Endpoint

How-To-Guides

Retrieve Historical Commodity Prices

Handle Mistyped Symbols

Frequently Asked Questions

How far back does the data go?

What if I ask for a weekend or a holiday?

Do monthly commodities have open, high, and low prices?

Can I get historical prices for a futures delivery month?

Are historical prices available in other currencies?

Which endpoint should I use for a date range?

Pricing

Price Estimation Calculator

Historical Commodity Prices, Delivered Simply.

Features

Instant Access to 520+ Commodities

30+ Years of Historical Data

Open, High, Low, and Close

The Last Available Price When a Day Has None

Daily Settlement for Futures Delivery Months

History for Retired and Expired Symbols

API Endpoint

How-To-Guides

Retrieve Historical Commodity Prices

Handle Mistyped Symbols

Frequently Asked Questions

How far back does the data go?

What if I ask for a weekend or a holiday?

Do monthly commodities have open, high, and low prices?

Can I get historical prices for a futures delivery month?

Are historical prices available in other currencies?

Which endpoint should I use for a date range?

Pricing

Price Estimation Calculator