SearchCtrl+K

APIs/Commodity APIs/Commodities Time Series API/Reference

Commodity Time Series API Reference

Retrieve daily OHLC (open, high, low, close) price data for any supported commodity over a date range of up to 365 days. Non-trading days are automatically excluded from the response.

GEThttps://api.apifreaks.com/v1.0/commodity/time-series

Test

Pass one or more commodity symbols with a startDate and endDate in YYYY-MM-DD format. The response is a date-indexed map with OHLC data for each trading day within the range.

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/time-series?symbols=XAU&startDate=2025-01-01&endDate=2025-01-10' \
  -H 'X-apiKey: API-KEY'

Response

{
  "success": true,
  "startDate": "2025-01-06",
  "endDate": "2025-01-10",
  "rates": {
    "2025-01-06": {
      "XAU": {
        "open": 2649.01,
        "high": 2651.33,
        "low": 2645.36,
        "close": 2646.91
      }
    },
    "2025-01-07": {
      "XAU": {
        "open": 2662.45,
        "high": 2663.06,
        "low": 2655.66,
        "close": 2658.9
      }
    },
    "2025-01-08": {
      "XAU": {
        "open": 2669.69,
        "high": 2674.68,
        "low": 2668.58,
        "close": 2671.8
      }
    },
    "2025-01-09": {
      "XAU": {
        "open": 2669.89,
        "high": 2697.87,
        "low": 2663.16,
        "close": 2685.61
      }
    },
    "2025-01-10": {
      "XAU": {
        "open": 2669.93,
        "high": 2697.85,
        "low": 2663.61,
        "close": 2689.44
      }
    }
  }
}

API Request

Query Parameters

All three parameters are required. The maximum date range is 365 days.

formatoptionalStringdefault: json

Response format: 'json'.

symbolsrequiredString

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

startDaterequiredString

Start date for the time series. Format: YYYY-MM-DD.

endDaterequiredString

End date for the time series. Format: YYYY-MM-DD. Maximum range is 365 days.

API Response Schema

A successful request returns a 200 OK with a date-indexed map of daily OHLC prices for each requested symbol.

success

Booleanmandatory

true for successful requests.

startDate

Stringmandatory

Start date of the time series. Format: YYYY-MM-DD.

endDate

Stringmandatory

End date of the time series. Format: YYYY-MM-DD.

Date-indexed map where each key is a date and the value contains commodity OHLC data for that day.

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: The provided start date or end date does not exist.

400

start date cannot be after end date

400

Date range exceeds the allowed limit.

404

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

404

No data found for the specified date range

Commodity Time Series API Reference

Retrieve daily OHLC (open, high, low, close) price data for any supported commodity over a date range of up to 365 days. Non-trading days are automatically excluded from the response.

GEThttps://api.apifreaks.com/v1.0/commodity/time-series

Test

Pass one or more commodity symbols with a startDate and endDate in YYYY-MM-DD format. The response is a date-indexed map with OHLC data for each trading day within the range.

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/time-series?symbols=XAU&startDate=2025-01-01&endDate=2025-01-10' \
  -H 'X-apiKey: API-KEY'

Response

{
  "success": true,
  "startDate": "2025-01-06",
  "endDate": "2025-01-10",
  "rates": {
    "2025-01-06": {
      "XAU": {
        "open": 2649.01,
        "high": 2651.33,
        "low": 2645.36,
        "close": 2646.91
      }
    },
    "2025-01-07": {
      "XAU": {
        "open": 2662.45,
        "high": 2663.06,
        "low": 2655.66,
        "close": 2658.9
      }
    },
    "2025-01-08": {
      "XAU": {
        "open": 2669.69,
        "high": 2674.68,
        "low": 2668.58,
        "close": 2671.8
      }
    },
    "2025-01-09": {
      "XAU": {
        "open": 2669.89,
        "high": 2697.87,
        "low": 2663.16,
        "close": 2685.61
      }
    },
    "2025-01-10": {
      "XAU": {
        "open": 2669.93,
        "high": 2697.85,
        "low": 2663.61,
        "close": 2689.44
      }
    }
  }
}

API Request

Query Parameters

All three parameters are required. The maximum date range is 365 days.

formatoptionalStringdefault: json

Response format: 'json'.

symbolsrequiredString

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

startDaterequiredString

Start date for the time series. Format: YYYY-MM-DD.

endDaterequiredString

End date for the time series. Format: YYYY-MM-DD. Maximum range is 365 days.

API Response Schema

A successful request returns a 200 OK with a date-indexed map of daily OHLC prices for each requested symbol.

success

Booleanmandatory

true for successful requests.

startDate

Stringmandatory

Start date of the time series. Format: YYYY-MM-DD.

endDate

Stringmandatory

End date of the time series. Format: YYYY-MM-DD.

Date-indexed map where each key is a date and the value contains commodity OHLC data for that day.

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: The provided start date or end date does not exist.

400

start date cannot be after end date

400

Date range exceeds the allowed limit.

404

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

404

No data found for the specified date range

Quick Links

Quick Links

Commodity Time Series API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Error Status & Codes

Quick Links

Quick Links

Commodity Time Series API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Error Status & Codes

Commodity Time Series 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

Historical Commodity Prices API

Commodity Fluctuation API

Commodity Symbols

Commodity Time Series 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

Historical Commodity Prices API

Commodity Fluctuation API

Commodity Symbols