Endpoint
GET https://requiems.xyz/v1/finance/commodities/{commodity}
Get Commodity Price
Returns the latest annual average price and up to 10 years of historical data for the requested commodity slug.
Parameters
| Name |
Type |
Required |
Location |
Description |
commodity |
string |
yes |
path |
Commodity slug (e.g. gold, silver, oil). See supported slugs below. |
Response Example
{
"data": {
"commodity": "gold",
"name": "Gold",
"price": 2386.3300,
"unit": "oz",
"currency": "USD",
"change_24h": 23.01,
"historical": [
{ "period": "2023", "price": 1940.5400 },
{ "period": "2022", "price": 1800.1200 },
{ "period": "2021", "price": 1798.5200 },
{ "period": "2020", "price": 1769.6400 },
{ "period": "2019", "price": 1392.6000 },
{ "period": "2018", "price": 1268.9300 },
{ "period": "2017", "price": 1257.1500 },
{ "period": "2016", "price": 1251.6500 },
{ "period": "2015", "price": 1160.0600 },
{ "period": "2014", "price": 1266.4000 }
]
},
"metadata": {
"timestamp": "2026-01-01T00:00:00Z"
}
}
Response Fields
| Field |
Type |
Description |
commodity |
string |
The commodity slug as provided in the request path |
name |
string |
Human-readable commodity name |
price |
number |
Latest annual average price in the commodity's display unit |
unit |
string |
Price unit (oz, barrel, mmbtu, lb, or metric_ton) |
currency |
string |
Currency code — always USD |
change_24h |
number |
Year-over-year percentage change from the prior year's annual average (positive = price increased) |
historical |
array |
Up to 10 prior years of annual average prices, ordered newest to oldest |
historical[].period |
string |
Year of the historical data point |
historical[].price |
number |
Annual average price for that year |
Errors
404 not_found — No data found for the given commodity slug. Check the supported slugs list.500 internal_error — Unexpected server error.
1---2name: commodities-get-commodity3description: Returns the latest annual average price and up to 10 years of historical data for the requested commodity slug.4---5
6## Endpoint
7
8**GET https://requiems.xyz/v1/finance/commodities/{commodity}**
9
10## Get Commodity Price
11
12Returns the latest annual average price and up to 10 years of historical data for the requested commodity slug.
13
14## Parameters
15
16| Name | Type | Required | Location | Description |
17| ---- | ---- | -------- | -------- | ----------- |
18| `commodity` | string | yes | path | Commodity slug (e.g. gold, silver, oil). See supported slugs below. |
19
20## Response Example
21
22```json
23{
24 "data": {
25 "commodity": "gold",
26 "name": "Gold",
27 "price": 2386.3300,
28 "unit": "oz",
29 "currency": "USD",
30 "change_24h": 23.01,
31 "historical": [
32 { "period": "2023", "price": 1940.5400 },
33 { "period": "2022", "price": 1800.1200 },
34 { "period": "2021", "price": 1798.5200 },
35 { "period": "2020", "price": 1769.6400 },
36 { "period": "2019", "price": 1392.6000 },
37 { "period": "2018", "price": 1268.9300 },
38 { "period": "2017", "price": 1257.1500 },
39 { "period": "2016", "price": 1251.6500 },
40 { "period": "2015", "price": 1160.0600 },
41 { "period": "2014", "price": 1266.4000 }
42 ]
43 },
44 "metadata": {
45 "timestamp": "2026-01-01T00:00:00Z"
46 }
47}
48```
49
50## Response Fields
51
52| Field | Type | Description |
53| ----- | ---- | ----------- |
54| `commodity` | string | The commodity slug as provided in the request path |
55| `name` | string | Human-readable commodity name |
56| `price` | number | Latest annual average price in the commodity's display unit |
57| `unit` | string | Price unit (oz, barrel, mmbtu, lb, or metric_ton) |
58| `currency` | string | Currency code — always USD |
59| `change_24h` | number | Year-over-year percentage change from the prior year's annual average (positive = price increased) |
60| `historical` | array<object> | Up to 10 prior years of annual average prices, ordered newest to oldest |
61| `historical[].period` | string | Year of the historical data point |
62| `historical[].price` | number | Annual average price for that year |
63
64## Errors
65
66- `404` **not_found** — No data found for the given commodity slug. Check the supported slugs list.
67- `500` **internal_error** — Unexpected server error.
gabrielmoreira