Physical dealer prices

Country index

Which countries are live, how many sources each has, and the freshest fetch time. Use it to discover coverage before calling the per-country endpoint.

Sample response

{
  "result": "success",
  "countries": [
    {"country": "ID", "sources": 4, "products": ["digital_gram", "bar"],
     "currency": "IDR", "latest_fetched_at": "2026-07-04T02:15:09Z"},
    {"country": "MY", "sources": 1, "products": ["bar"],
     "currency": "MYR", "latest_fetched_at": "2026-07-04T02:15:11Z"}
  ]
}

Dealer quotes for one country

Latest quote per (source, brand, product, denomination). country is an ISO 3166-1 alpha-2 code (ID, MY, VN, CN, PK, AE, JP, NP, EG, IN, SA, HK). Unknown codes return 404 unknown_country with the live country list. Responses are cached for 60 seconds.

Sample response

{
  "result": "success",
  "country": "ID",
  "currency": "IDR",
  "spot_reference": {
    "xau_usd": "4123.50",
    "fx_usd_local": "16250.00",
    "spot_per_gram_local": "2154917.00"
  },
  "quotes": [
    {"source": "treasury_id", "brand": null, "product": "digital_gram",
     "denomination_grams": null, "price_basis": "per_gram",
     "sell": "2497154", "buyback": "2414599",
     "premium_over_spot_bps": 1588,
     "data_updated_at": "2026-07-04T02:14:02Z",
     "fetched_at": "2026-07-04T02:15:09Z"},
    {"source": "indogold", "brand": "Antam", "product": "bar",
     "denomination_grams": "1", "price_basis": "per_bar",
     "sell": "2719000", "buyback": "2520000",
     "premium_over_spot_bps": 2618,
     "data_updated_at": null,
     "fetched_at": "2026-07-04T02:15:10Z"}
  ]
}

Reading the quote rows

price_basis tells you what the price is per: per_gram, per_bar (with denomination_grams carrying the bar weight), per_tola, or per_tael. premium_over_spot_bps compares the per-gram equivalent against purity-adjusted international spot converted at the live FX cross: 18-karat rows compare against 18k-equivalent spot, never against pure spot. Products whose purity is not in the label carry premium: null. Stale spot or FX inputs also yield null, never a fabricated number.