Commodity Prices

Historical and current annual average prices for 16 major commodities — precious metals, energy, and agricultural goods. Prices are annual averages sourced from FRED (Federal Reserve Economic Data).

Get API Key

Descripción general

Casos de uso

Financial dashboards and portfolio trackers
Commodity price trend analysis
Inflation-adjusted cost modelling
Economic research and education
Supply chain cost forecasting

Funcionalidades

16 commodities covered (metals, energy, agricultural)

Annual average prices sourced from FRED (Federal Reserve)

Up to 10 years of historical data per commodity

Year-over-year change percentage included

Data going back to the 1960s for major commodities

Puntos finales de la API

Get Commodity Price

Returns the latest annual average price and up to 10 years of historical data for the requested commodity slug.

GET

https://requiems.xyz/v1/finance/commodities/{commodity}

Parámetros

Nombre	Tipo	Obligatorio	Descripción
commodity	`string`	Obligatorio	Commodity slug (e.g. gold, silver, oil). See supported slugs below.

Pruébalo

Demostración en vivo

Solicitud

commodity * (string)

Commodity slug (e.g. gold, silver, oil). See supported slugs below.

Campos de respuesta

Campo	Tipo	Descripción
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<object>`	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

Ejemplos de código

curl "https://requiems.xyz/v1/finance/commodities/gold" \
  -H "requiems-api-key: YOUR_API_KEY"

import requests

url = "https://requiems.xyz/v1/finance/commodities/gold"
headers = {"requiems-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)
data = response.json()["data"]
print(data["price"])      # 2386.33
print(data["change_24h"]) # 23.01
print(data["historical"][0]["period"])  # "2023"

const response = await fetch(
  'https://requiems.xyz/v1/finance/commodities/gold',
  { headers: { 'requiems-api-key': 'YOUR_API_KEY' } }
);

const { data } = await response.json();
console.log(data.price);       // 2386.33
console.log(data.change_24h);  // 23.01
console.log(data.historical.length); // up to 10

require 'net/http'
require 'json'

uri = URI('https://requiems.xyz/v1/finance/commodities/gold')

request = Net::HTTP::Get.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)['data']
puts data['price']      # 2386.33
puts data['change_24h'] # 23.01

Respuestas de error

not_found

No data found for the given commodity slug. Check the supported slugs list.

internal_error

Unexpected server error.

Sin resultados