SearchCtrl+K

APIs/Commodity APIs/Historical Commodity Prices API/Reference

Historical Commodity Prices API Reference

Retrieve OHLC (open, high, low, close) price data for any supported commodity on a specific date. Data is available from January 1990 onwards for 130+ commodities.

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

Test

Pass one or more comma-separated commodity symbols and a date in YYYY-MM-DD format. The response contains the opening, high, low, and closing price for each symbol on that date.

Getting Started

Authentication

Authorize every request with your API key, passed either as a header or as a query parameter:

Header - X-apiKey
Query parameter - apiKey

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/commodity/rates/historical?symbols=XAU&date=2025-01-10' \
  -H 'X-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
    }
  }
}

API Request

Query Parameters

Both symbols and date are required.

formatoptionalStringdefault: json

Response format: 'json'.

symbolsrequiredString

Comma-separated list of commodity symbols. Visit the supported symbols list for all valid values.

daterequiredString

Date for which the rates are required. Format: YYYY-MM-DD. Data available from 1990 onwards.

API Response Schema

A successful request returns a 200 OK with OHLC data for each requested symbol on the given date.

success

Booleanmandatory

true for successful requests.

date

Stringmandatory

Date for which the commodity prices were fetched. Format: YYYY-MM-DD.

Object where each key is a commodity symbol and the value contains OHLC price data.

Custom Response Headers

Besides the response body, every response carries custom headers you can use to track credit usage, and concurrency usage on endpoints that enforce a concurrency limit. See the Custom Response Headers documentation and the endpoints with concurrency limits for more details.

X-Concurrent-Threadsheaderconcurrency-limited endpoints

Specifies the maximum number of concurrent requests allowed.

X-Concurrent-Threads-Activeheaderconcurrency-limited endpoints

Indicates the number of active concurrent requests being processed.

X-AF-Credits-Costheaderall responses

Specifies the number of credits consumed by the current request.

Error Status & Codes

See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.

400

Invalid Date Format (YYYY-MM-DD).

400

Invalid Date: The provided date does not exist.

404

The symbol is not supported, please visit the documentation for a list of supported symbols

404

no rates found for the specified date

Historical Commodity Prices API Reference

Retrieve OHLC (open, high, low, close) price data for any supported commodity on a specific date. Data is available from January 1990 onwards for 130+ commodities.

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

Test

Pass one or more comma-separated commodity symbols and a date in YYYY-MM-DD format. The response contains the opening, high, low, and closing price for each symbol on that date.

Getting Started

Authentication

Authorize every request with your API key, passed either as a header or as a query parameter:

Header - X-apiKey
Query parameter - apiKey

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/commodity/rates/historical?symbols=XAU&date=2025-01-10' \
  -H 'X-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
    }
  }
}

API Request

Query Parameters

Both symbols and date are required.

formatoptionalStringdefault: json

Response format: 'json'.

symbolsrequiredString

Comma-separated list of commodity symbols. Visit the supported symbols list for all valid values.

daterequiredString

Date for which the rates are required. Format: YYYY-MM-DD. Data available from 1990 onwards.

API Response Schema

A successful request returns a 200 OK with OHLC data for each requested symbol on the given date.

success

Booleanmandatory

true for successful requests.

date

Stringmandatory

Date for which the commodity prices were fetched. Format: YYYY-MM-DD.

Object where each key is a commodity symbol and the value contains OHLC price data.

Custom Response Headers

X-Concurrent-Threadsheaderconcurrency-limited endpoints

Specifies the maximum number of concurrent requests allowed.

X-Concurrent-Threads-Activeheaderconcurrency-limited endpoints

Indicates the number of active concurrent requests being processed.

X-AF-Credits-Costheaderall responses

Specifies the number of credits consumed by the current request.

Error Status & Codes

See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.

400

Invalid Date Format (YYYY-MM-DD).

400

Invalid Date: The provided date does not exist.

404

The symbol is not supported, please visit the documentation for a list of supported symbols

404

no rates found for the specified date

Quick Links

Quick Links

Historical Commodity Prices API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Error Status & Codes

Quick Links

Quick Links

Historical Commodity Prices API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Error Status & Codes

Historical Commodity Prices API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Error Status & Codes

More APIs in This Category

Live Commodity Prices API

Commodity Fluctuation API

Commodities Time Series API

Commodity Symbols

Historical Commodity Prices API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Error Status & Codes

More APIs in This Category

Live Commodity Prices API

Commodity Fluctuation API

Commodities Time Series API

Commodity Symbols