---
title: "Global Commodity Data"
method: GET
path: "/v2/mining/global-commodity/"
tags: ["Commodities & Trade"]
---

# Global Commodity Data

`GET /v2/mining/global-commodity/`

Retrieves global commodity data including production, reserves, and trade information. At least one of `commodity_type` or `country` must be provided.

<Note>Available `commodity_type` values: `Coal`, `Gold`, `Nickel`, `Copper`, `Bauxite`.</Note>

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

## Query parameters

- `commodity_type` 'Bauxite' | 'Coal' | 'Copper' | 'Gold' | 'Nickel'
- `country` string
- `limit` integer

## Response `200`

List of global commodity data records.

- GlobalCommodityDataItem[]
  - `country` string, required — Country name.
  - `commodity_type` string, required — Commodity type.
  - `resources_reserves` number, double, nullable, required — Total resources/reserves.
  - `resources_reserves_share` number, double, nullable, required — Share of global resources/reserves (%).
  - `resources_reserves_unit` string, required — Unit for resources/reserves (e.g. ton).
  - `export_import_usd` object, required — Trade data keyed by year: `{year: {export, import}}`.
  - `production_volume` object, required — Production volume keyed by year.
  - `production_share` object, required — Production share (%) keyed by year.
  - `production_volume_unit` string, required — Unit for production volume (e.g. ton).

## Other responses

- `400` — At least one of `commodity_type` or `country` is required.
- `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)