SearchCtrl+K

APIs/Commodity APIs/Commodity Fluctuation API/Reference

Commodity Fluctuation API Reference

Calculate price change and percentage movement for any commodity over a custom date range. Returns the opening price, closing price, absolute change, and percentage change for each symbol.

GEThttps://api.apifreaks.com/v1.0/commodity/fluctuation

Test

Pass one or more commodity symbols with a startDate and endDate in YYYY-MM-DD format. The response contains the start and end prices plus the absolute and percentage change for each symbol.

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

Response

{
  "success": true,
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "rates": {
    "WTIOIL-SPOT": {
      "startRate": 72.02,
      "endRate": 75.81,
      "change": 3.79,
      "changePercent": 5.26
    },
    "XAU": {
      "startRate": 2063.63,
      "endRate": 2039.83,
      "change": -23.8,
      "changePercent": -1.15
    }
  }
}

API Request

Query Parameters

All three parameters are required. The startDate must not be after endDate.

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 fluctuation range. Format: YYYY-MM-DD.

endDaterequiredString

End date for the fluctuation range. Format: YYYY-MM-DD.

API Response Schema

A successful request returns a 200 OK with fluctuation data for each requested symbol over the specified date range.

success

Booleanmandatory

true for successful requests.

startDate

Stringmandatory

Start date of the fluctuation interval. Format: YYYY-MM-DD.

endDate

Stringmandatory

End date of the fluctuation interval. Format: YYYY-MM-DD.

Object where each key is a commodity symbol and the value contains fluctuation metrics.

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

400

Start date cannot be after end date

404

No data found for the given date range

Commodity Fluctuation API Reference

Calculate price change and percentage movement for any commodity over a custom date range. Returns the opening price, closing price, absolute change, and percentage change for each symbol.

GEThttps://api.apifreaks.com/v1.0/commodity/fluctuation

Test

Pass one or more commodity symbols with a startDate and endDate in YYYY-MM-DD format. The response contains the start and end prices plus the absolute and percentage change for each symbol.

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

Response

{
  "success": true,
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "rates": {
    "WTIOIL-SPOT": {
      "startRate": 72.02,
      "endRate": 75.81,
      "change": 3.79,
      "changePercent": 5.26
    },
    "XAU": {
      "startRate": 2063.63,
      "endRate": 2039.83,
      "change": -23.8,
      "changePercent": -1.15
    }
  }
}

API Request

Query Parameters

All three parameters are required. The startDate must not be after endDate.

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 fluctuation range. Format: YYYY-MM-DD.

endDaterequiredString

End date for the fluctuation range. Format: YYYY-MM-DD.

API Response Schema

A successful request returns a 200 OK with fluctuation data for each requested symbol over the specified date range.

success

Booleanmandatory

true for successful requests.

startDate

Stringmandatory

Start date of the fluctuation interval. Format: YYYY-MM-DD.

endDate

Stringmandatory

End date of the fluctuation interval. Format: YYYY-MM-DD.

Object where each key is a commodity symbol and the value contains fluctuation metrics.

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

400

Start date cannot be after end date

404

No data found for the given date range

Quick Links

Quick Links

Commodity Fluctuation 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 Fluctuation API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Error Status & Codes

Commodity Fluctuation 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

Commodities Time Series API

Commodity Symbols

Commodity Fluctuation 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

Commodities Time Series API

Commodity Symbols