---
title: "Commodity Price History"
method: GET
path: "/v2/mining/commodities/{commodity_name}/price/"
tags: ["Commodities & Trade"]
---

# Commodity Price History

`GET /v2/mining/commodities/{commodity_name}/price/`

Retrieves historical price data for a commodity by year range. Data is monthly (bi-weekly for recent Coal entries). Maximum range: 3 years.

<Note>Use [List Commodities](../commodities-trade/commodities) to discover all available commodity names.</Note>

<Warning>Requesting more than 3 years will return a 400 error.</Warning>

<Info>Costs 1 API credit.</Info>

## Path parameters

- `commodity_name` string, required

## Query parameters

- `start_year` integer
- `end_year` integer

## Response `200`

List of monthly price records ordered by date ascending.

- CommodityPriceItem[]
  - `name` string, required — Commodity name.
  - `date` string, date, required — Price date (monthly).
  - `price_usd_per_ton` number, double, required — Price in USD per metric ton.

## Other responses

- `400` — Invalid year parameters or date range exceeds 3 years.
- `404` — Commodity not found or no data in specified range.
- `429` — Rate limit exceeded.

---

[API](https://skmtc.dev/sectors/apis/sectors-api.md) · [All operations](https://skmtc.dev/sectors/apis/sectors-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sectors/sectors-api/revisions/49e492f19d77/schema)