SearchCtrl+K

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.

GET

https://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

Pass your API key as the apiKey parameter in every request.

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 Parameters

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

symbolsrequiredArray

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.

rates

Mapmandatory

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

rates.[DATE]

Mapmandatory

Map of commodity symbols for the specified trading date.

rates.[DATE].[SYMBOL]

Mapmandatory

OHLC price data for the specified commodity on the given date.

rates.[DATE].[SYMBOL].open

Numbermandatory

Opening price on the given date.

rates.[DATE].[SYMBOL].high

Numbermandatory

Highest price on the given date.

rates.[DATE].[SYMBOL].low

Numbermandatory

Lowest price on the given date.

rates.[DATE].[SYMBOL].close

Numbermandatory

Closing price on the given date.

Error Status & Codes

The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.

400

please pass correct parameters

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

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.

GET

https://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

Pass your API key as the apiKey parameter in every request.

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 Parameters

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

symbolsrequiredArray

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.

rates

Mapmandatory

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

rates.[DATE]

Mapmandatory

Map of commodity symbols for the specified trading date.

rates.[DATE].[SYMBOL]

Mapmandatory

OHLC price data for the specified commodity on the given date.

rates.[DATE].[SYMBOL].open

Numbermandatory

Opening price on the given date.

rates.[DATE].[SYMBOL].high

Numbermandatory

Highest price on the given date.

rates.[DATE].[SYMBOL].low

Numbermandatory

Lowest price on the given date.

rates.[DATE].[SYMBOL].close

Numbermandatory

Closing price on the given date.

Error Status & Codes

The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.

400

please pass correct parameters

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