Pulse Intelligence
Reference & Discovery

List commodities

Return the whole curated commodity registry in one response: each commodity's canonical quantity and grade units, the species contained metal is presented in (with the factor back to the commodity's canonical mass basis — the element, or TREO for rare earths — that the production and reserves datasets' `*_kg` fields and the dossier's `contained_canonical_kg` are in), which Pulse pipelines cover it, and its latest spot price with change over each window. Use it to interpret the commodity symbols every other endpoint returns. Not paginated — the registry is small and stable.

GET/v1/commodities/

Authorization

apiKeyAuth
AuthorizationBearer <token>

Organization API key, format pulse_<prefix>_<secret>. Created by an organization admin in Settings -> API Keys.

In: header

Response Body

The commodity registry.

The whole curated commodity registry, one row per commodity.

curl -X GET "https://example.com/v1/commodities/" \  -H "Authorization: Bearer $PULSE_API_KEY"
{  "results": [    {      "id": 2,      "name": "Silver",      "symbol": "Ag",      "priority": 96,      "unit_of_measure": "oz",      "unit_grade": "g/t",      "display_unit_of_measure": "oz",      "display_species": null,      "enabled_for_production_extraction": true,      "enabled_for_reserves_extraction": true,      "enabled_for_drill_extraction": true,      "enabled_for_economics_extraction": true,      "enabled_for_assets": true,      "enabled_for_price": true,      "price": 64.7045,      "change_1d": 0,      "change_1w": 0.0177,      "change_1m": 0.1657,      "change_3m": -0.1566,      "change_6m": -0.1555,      "change_1y": 0.7032,      "change_ytd": -0.0966    },    {      "id": 8,      "name": "Lithium",      "symbol": "Li",      "priority": 93,      "unit_of_measure": "t",      "unit_grade": "%",      "display_unit_of_measure": "t LCE",      "display_species": {        "key": "lce",        "display": "LCE",        "formula": "Li₂CO₃",        "to_element_factor": 0.1879      },      "enabled_for_production_extraction": true,      "enabled_for_reserves_extraction": true,      "enabled_for_drill_extraction": true,      "enabled_for_economics_extraction": true,      "enabled_for_assets": true,      "enabled_for_price": true,      "price": 24652.862301,      "change_1d": 0,      "change_1w": 0.0624,      "change_1m": -0.0248,      "change_3m": -0.2291,      "change_6m": 0.0799,      "change_1y": 1.85,      "change_ytd": 0.4249    }  ],  "count": 2}