---
title: "List Commodities"
method: GET
path: "/v2/mining/commodities/"
tags: ["Commodities & Trade"]
---

# List Commodities

`GET /v2/mining/commodities/`

Lists all commodities available in the price database with coverage metadata. Use this as a discovery endpoint before querying [Commodity Price History](../commodities-trade/commodity-price) endpoint.

<Note>
Most commodities only have data in the price table. Cross-table data (production, exports, reserves, sites) is limited to: **Coal**, **Gold**, **Nickel**, **Copper** — and partially Silver, Cobalt, Bauxite.
</Note>

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

## Response `200`

List of commodities with data coverage metadata.

- CommodityListItem[]
  - `name` string, required — Commodity name.
  - `data_points` integer, required — Number of price data points.
  - `earliest_date` string, date, required — Earliest available date.
  - `latest_date` string, date, required — Latest available date.

## Other responses

- `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)