v1

latestOpenAPI 3.0.32026-07-2664108290.0 KB

Commodities & Trade

Global Commodity Data

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>

get/v2/mining/global-commodity/

commodity_type'Bauxite' | 'Coal' | 'Copper' | 'Gold' | 'Nickel'

Filter by commodity type. Required if country not provided.

countrystring

Filter by country (exact match, e.g., Australia). Required if commodity_type not provided.

limitinteger

Number of results to return. Maximum: 30.

List of global commodity data records.

countrystring required

Country name.

commodity_typestring required

Commodity type.

resources_reservesnumber double nullable required

Total resources/reserves.

resources_reserves_sharenumber double nullable required

Share of global resources/reserves (%).

resources_reserves_unitstring required

Unit for resources/reserves (e.g. ton).

export_import_usdobject required

Trade data keyed by year: {year: {export, import}}.

production_volumeobject required

Production volume keyed by year.

production_shareobject required

Production share (%) keyed by year.

production_volume_unitstring required

Unit for production volume (e.g. ton).