gold-retail-conversionlisted
Install: claude install-skill nusantara-ventures/goldprice-skills
# goldprice.dev — retail gold conversion (keyless)
Two endpoints, **no API key, no signup** — build the whole feature and demo it before anyone subscribes.
## Per-gram price by karat — `/v1/carat`
Every common karat purity (24k down to 10k) per gram, in one call. Default `USD`; 31 currencies supported.
```bash
curl "https://api.goldprice.dev/v1/carat?currency=INR"
```
Response — keys are flat `price_gram_Nk`, and **every value is a string** (parse before doing math):
```json
{"currency":"IDR","timestamp":"2026-07-07T13:10:07Z",
"price_gram_24k":"2397283.68","price_gram_22k":"2197510.04","price_gram_21k":"2097623.22",
"price_gram_20k":"1997736.40","price_gram_18k":"1797962.76","price_gram_16k":"1598189.12",
"price_gram_14k":"1398415.48","price_gram_10k":"998868.20"}
```
Karat keys returned: `price_gram_24k 22k 21k 20k 18k 16k 14k 10k`. Computed from live XAU spot × live FX. 22k is the retail standard across India/UAE, 24k across Indonesia/China.
MCP equivalent: `get_carat(currency)` — free, no tier gate.
## Weight ↔ money — `/v1/convert`
Convert a metal amount to a currency (or between units). No auth. `XAU` and `XAG` only (no copper, no spot row); `date` / historical is not supported.
```bash
curl "https://api.goldprice.dev/v1/convert?from=XAU&to=USD&amount=1&unit=oz"
```
Response — `rate` is full precision; `amount` / `result` are **strings** (cast before formatting):
```json
{"from":"XAU","to":"IDR","amount":"1.0","rate":"2397283.680999…","result":"2397283.6