---
title: "GET /api/commodities/convert"
method: GET
path: "/api/commodities/convert"
tags: ["Commodity"]
---

# GET /api/commodities/convert

`GET /api/commodities/convert`

## Request

- Base URL: `https://api.unirateapi.com`
- URL: `https://api.unirateapi.com/api/commodities/convert`
- Auth: none declared
- TypeScript: <https://skmtc.dev/unirateapi/apis/unirate-api/docs/api/commodities/convert/get.ts> (a function with typed inputs; its response is checked against the schema)

Convert between commodities and currencies (Pro subscription required). 19 commodities: gold, silver, platinum, palladium (troy oz); WTI and Brent crude (barrel), US Henry Hub natural gas (MMBtu); copper, aluminium, zinc, nickel, lead, tin (tonne); wheat, corn (tonne), coffee, sugar, cocoa, cotton (kg). Precious metals are blended live from LBMA and market feeds; energy, base metals and agriculturals are World Bank reference prices (CC BY 4.0, attribution: The World Bank).

## Query parameters

- `api_key` string, required
- `amount` number
- `from` string
- `to` string
- `format` 'json' | 'xml' | 'csv' | 'tsv'
- `callback` string

## Response `200`

Conversion completed successfully.

## Other responses

- `400`: Invalid amount parameter or conversion failed
- `401`: Missing or invalid API key
- `403`: Pro subscription required
- `404`: Symbol not found
- `503`: No commodity rates available

---

[API](https://skmtc.dev/unirateapi/apis/unirate-api.md) - [All operations](https://skmtc.dev/unirateapi/apis/unirate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unirateapi/apis/unirate-api/revisions/e5fd92902326?raw)