Gold & Silver Price

POST/api/v1/tools/gold-price1 credit per callgoldsilverpricecommoditykarattolabullion

Returns the current spot price in one of 32 currencies, converted to troy ounce, gram and tola, plus a per-karat breakdown for gold (24K down to 10K) using exact purity constants. Quotes are cached briefly; if the upstream feed is unavailable the last good value is returned with stale set to true rather than failing.

receipt_long

Why 1 credit?

One or two cached outbound lookups - the one-credit floor.

Any HTTP client works. Replace the key with one from your dashboard.

bash

curl -X POST https://toolkitbackend-j69m.onrender.com/api/v1/tools/gold-price \
  -H "Authorization: Bearer tb_live_<your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "metal": "gold",
  "currency": "USD"
}'

Input

Field	Type	Required	Default	Description
`metal`	string	optional	gold	gold or silver.
`currency`	string	optional	USD	USD, GBP, EUR, CAD, AUD, JPY, CNY, PKR, INR, AED, SAR, TRY, BDT, NGN, ZAR, CHF, SGD, HKD, MYR, THB, IDR, EGP, PHP, KRW, MXN, BRL, NZD, SEK, NOK, DKK, PLN or CZK.

Output

Field	Type	Description
`metal`	string	gold or silver.
`currency`	string	Currency the prices are quoted in.
`pricePerOunce`	number	Price per troy ounce.
`pricePerGram`	number	Price per gram.
`pricePerTola`	number	Price per tola (11.6638 g).
`karats`	array	Per-karat price for gold: karat, purity, per gram, per tola, per ounce.
`asOfUtc`	string	When the quote was published.
`stale`	boolean	True when a cached value was served because the feed was unreachable.

Try it

Sends a real POST /api/v1/tools/gold-price from your browser and charges 1 credit to your account.