CTRL+K
Know what changed, by how much, and when. Instantly.
Whether you're tracking gold, crude oil, or coffee beans, this API gives you accurate results. The Commodity Fluctuation API shows how prices moved over any time period—so you can tell the story behind the numbers. Just enter a date range and symbol. You'll get back the opening price, closing price, total change, and percent change.
Just pass in the commodity symbol (like XAU for gold) and a start/end date. You'll get back the opening and closing prices, the exact price change, and the percentage movement over that range.
From agricultural goods to energy, metals to rare materials—use the same endpoint across every symbol. One consistent format. All sectors covered.
Pair the commodity fluctuation API with the time series API to show detailed daily movement, then use this endpoint to show summarized change over the full range.
$ pip install requests
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
| symbols | Yes | Array | - | Comma separated list of desired commodities symbols. |
| startDate | Yes | String | - | Start Date for the fluctuation. Format: YYYY-MM-DD |
| endDate | Yes | String | - | End Date for the fluctuation. Format: YYYY-MM-DD |
View the full list of supported symbols by visiting here.
NOTE: The maximum difference between the start and end date is 30 days.For a comprehensive view of the API response structure and detailed field descriptions, explore the interactive Response Table by clicking here.
| HTTP Status | Reasons |
|---|---|
| 400 | (1) Invalid date format specified for start or end date.
(2) Start date cannot be after end date.
(3) Invalid Date: The provided date does not exist. |
| 404 | (1) No data found for the specified date range.
(2) The symbol is not supported, please visit the documentation for a list of supported symbols. |
To fetch fluctuation data:
Choose your commodity symbol (e.g. XAU, WTIOIL, XAG) and set your start and end dates. As a result, you will get Starting price, Ending price, Absolute change and Percentage change.
#Response { "success": true, "startDate": "2024-01-01", "endDate": "2024-01-30", "rates": { "WTIOIL": { "startRate": 72.68, "endRate": 77.66, "change": 4.98, "changePercent": 6.85 }, "XAG": { "startRate": 23.81, "endRate": 23.15, "change": -0.66, "changePercent": -2.77 }, "XAU": { "startRate": 2063.63, "endRate": 2036.27, "change": -27.36, "changePercent": -1.33 } } }$ curl -X 'GET' 'https://api.apifreaks.com/v1.0/commodity/fluctuation?apikey=API-KEY&symbols=WTIOIL%2CXAU%2CXAG&startDate=2024-01-01&endDate=2024-01-30'
This makes the commodity fluctuation API ideal for dashboards, alerts, reports, or portfolio tools. Use it to flag volatility or summarize changes with clarity—no extra logic needed.
To access the Commodity Fluctuation API, API credits are required. Credits are only deducted for successful requests (2xx status code). If a request returns a 4xx or 5xx status code, no credits will be charged, and any previously deducted credits will be refunded.
Each successful Commodity Fluctuation request costs 40 credits, plus 1 credit for each symbol included in the request.
If you provide both valid and invalid symbols, the API will return a successful 2xx response with only the valid symbols included. No credits are deducted for invalid symbols, and any credits charged for them will be refunded.
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.