List Commodities

Lists all commodities available in the price database with coverage metadata. Use this as a discovery endpoint before querying Commodity Price History endpoint.

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.

GET /v2/mining/commodities

List Commodities

cURL

curl --request GET \
  --url https://api.sectors.app/v2/mining/commodities/ \
  --header 'Authorization: <api-key>'

200

[
  {
    "name": "Gold",
    "data_points": 698,
    "earliest_date": "1968-01-01",
    "latest_date": "2025-02-01"
  },
  {
    "name": "Coal",
    "data_points": 113,
    "earliest_date": "2017-01-01",
    "latest_date": "2025-02-01"
  }
]

Authorizations

ApiKeyAuthOAuthBearerAuth

Authorization · string · header · required

API key passed directly in the Authorization header (without Bearer prefix).

Response

200

application/json

List of commodities with data coverage metadata.

{key} · any